Resolvendo os erros mais comuns do GeyserMC

Depois de instalar o Geyser, alguns problemas aparecem com frequência. Veja como resolver os mais comuns.

1. Bedrock não conecta, mas Java sim

Geralmente é a porta configurada no Geyser conflitando com outra alocação.

1. No painel, acesse a aba Redes e copie uma porta disponível
2. Abra plugins/Geyser-Spigot/config.yml
3. Localize a linha port: e informe a porta copiada — por exemplo, port: 25660
4. Salve e reinicie

A partir daí, jogadores de Bedrock conectam usando o endereço do servidor com essa porta específica.

2. Chat travado (chave de perfil ausente)

Jogadores de Bedrock podem ver esta mensagem ao tentar digitar no chat:

"Os jogadores de Bedrock provavelmente não vão ser capazes de bater papo, pois o servidor tem enforce-secure-profile ativado... O chat foi desativado porque a chave pública de perfil está ausente."

Isso acontece porque o servidor Java exige um perfil seguro que o Bedrock não fornece nativamente. A correção passa pela configuração de chat seguro do próprio Geyser — consulte a documentação oficial do projeto para a versão que você está usando, já que o parâmetro exato muda entre versões.

3. Itens ou blocos não aparecem corretamente

O Geyser traduz blocos e itens do Java para equivalentes no Bedrock. Alguns itens muito recentes do Java podem não ter mapeamento ainda — nesse caso, aguarde uma atualização do Geyser ou verifique se existe um arquivo de mapeamento customizado disponível para a versão em uso.

4. Desempenho abaixo do esperado

O Geyser adiciona uma camada de tradução entre o jogador Bedrock e o servidor. Em servidores já no limite de recursos, isso pode ser perceptível. Se notar lag apenas em jogadores Bedrock, considere revisar o plano do servidor.