Quando Java conecta e Bedrock não, o problema pode estar antes mesmo de Geyser receber a tentativa. Bedrock usa UDP; um encaminhamento configurado apenas para TCP não libera o listener. Também pode haver porta incorreta, alocação ausente no painel, firewall local, proxy ou cliente informando host diferente.
Este roteiro segue a conexão desde o cliente até o Geyser. Não troque várias portas ao acaso: registre configuração atual, teste uma camada por vez e valide na rede externa que os jogadores usarão.
Confirme onde Geyser está instalado
Identifique se Geyser roda como plugin no Paper, mod, ou componente no proxy. O arquivo e endereço de listener variam conforme plataforma. Confira console de inicialização para saber se Geyser carregou e qual IP/porta anuncia. O número usado pelo Java não garante que Bedrock usa a mesma porta.
Leia a seção `bedrock` da configuração ativa, não um exemplo baixado. Endereço de bind precisa corresponder às interfaces que a hospedagem disponibiliza. Um listener vinculado apenas a localhost aceita teste local mas não conexões externas, enquanto endereço de interface errada pode falhar em iniciar.
Verifique protocolo e porta UDP
Registre a porta de Geyser e confirme que provedor, firewall do sistema, roteador e proxy permitem tráfego UDP nessa mesma porta. A porta padrão não é garantida pelo plano: painel pode atribuir outra ou exigir que você reserve uma alocação adicional.
Não conclua que UDP funciona porque Java entra na porta TCP correspondente. São protocolos de transporte distintos. Alguns túneis suportam apenas TCP e não encaminham Geyser; use uma solução cujo suporte UDP seja explicitamente documentado e configure porta correspondente nos dois lados.
Teste local e externo separadamente
Primeiro teste num cliente Bedrock na mesma rede do servidor para validar listener e configuração. Depois teste de outra conexão à Internet com IP/host e porta públicos. Um sucesso local com falha externa aponta para roteador, firewall ou painel; nenhum pacote local recebido aponta listener ou configuração antes da borda.
Use o comando `geyser connectiontest` indicado pela documentação para verificar reachability externa e compare com tentativa real de um jogador. Uma página de verificação HTTP não demonstra conexão de jogo completa; protocolos não HTTP podem falhar em navegador sem indicar o resultado de handshake Bedrock.
Inspecione logs no momento da tentativa
Peça ao jogador para tentar uma vez em horário combinado e observe console. Se nenhuma linha aparece, o pacote talvez não chegou ao processo. Se Geyser registra tentativa mas rejeita, examine mensagem, protocolo suportado e autenticação. Correlacione timestamp, IP público de origem quando disponível e rota.
Proteja logs antes de pedir suporte. Eles podem conter IPs e identificadores de jogador. Não publique saída inteira em canal aberto; extraia o trecho relevante e remova informação privada sem alterar mensagem de erro ou sequência.
Confira alocação do painel e conflito de portas
Hospedagem compartilhada pode exigir alocação UDP própria e porta diferente da padrão. Verifique painel e documentação do provedor para adicionar a alocação no endereço correto. Se há Geyser no proxy, a porta deve chegar ao proxy; liberar a alocação no backend não encaminha tráfego ao componente que escuta.
Outros serviços UDP, como voice chat ou query, podem não compartilhar a mesma porta. Use alocações distintas quando necessário e documente qual listener ocupa cada uma. Após trocar porta, atualize informação de conexão de Bedrock e teste que jogadores não usam um valor antigo em favoritos.
Revise firewall e roteador
Em servidor caseiro, crie regra UDP para a porta do Geyser no firewall do sistema e encaminhamento para o endereço privado correto no roteador. Se endereço local mudou via DHCP, a regra pode apontar para máquina diferente. Confirme destino e não abra portas que não fazem parte do serviço.
Em nuvem, verifique firewall de host e regra de segurança de rede. Um listener pode aparecer ativo no processo enquanto tráfego é bloqueado em outra camada. Faça mudança apenas na porta/UDP necessária e reteste de fora; não use regra que expõe console administrativo ou portas internas ao público.
Analise proxy e túnel
Quando houver proxy, trace cada salto: jogador Bedrock para listener Geyser, depois Geyser para backend Java. Teste separadamente se Geyser aceita e se alcança Paper. Um túnel TCP-only não transporta datagrama UDP. Se fornecedor oferece túnel, confirme protocolo, encaminhamento de IP e compatibilidade com Geyser.
Não configure `clone-remote-port` sem entender como o painel aloca Java e Bedrock. Alguns provedores reservam uma porta específica; a opção pode alterar o listener depois do próximo início. Confira configuração efetiva e instrução do host antes de depender dela.
Se o erro ocorre depois de conectar
Se login inicia mas a sessão cai, a conectividade UDP já alcançou parte do processo. Investigue autenticação, Geyser/Floodgate, versão do cliente e backend. Se jogador entra sem skins ou UUID correto, isso aponta mais à configuração de forwarding e autenticação que ao firewall inicial.
Teste conta Java e conta Bedrock de forma separada e confira mensagem do proxy e Paper. Não desligue autenticação pública como correção rápida. Siga configuração oficial de forwarding, proteja backend e confirme identidade após conexão.
Registre configuração que funcionou
Guarde listener, porta pública, transporte, localização do Geyser, regra de firewall e teste de conexão. Remova valores antigos da documentação e informe a comunidade se a porta mudar. Após atualização do plugin, repita o teste de uma rede externa.
Consulte o guia do Geyser para setup e listener Bedrock, o tutorial de encaminhamento UDP e a lista oficial de problemas comuns. Siga as instruções do provedor para alocações e verifique sempre protocolo UDP.
Não use teste de navegador como prova de UDP
Ferramentas HTTP e navegadores tentam TCP, enquanto Bedrock precisa de UDP. O resultado negativo de abrir endereço no navegador é esperado e não demonstra que Geyser está offline. Use teste de conexão do Geyser e cliente Bedrock em rede externa para confirmar o protocolo correto.
Revise mudança dinâmica de porta
Se painel remapeia a porta após restart, compare allocation com o valor do listener após inicializar. Atualize cliente e firewall somente quando necessário e mantenha endereço público alinhado. Um serviço funcionando antes de reiniciar pode falhar depois se dependia de uma alocação transitória.
Fontes e referências
Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.