RakNet, NetherNet, offline e contas: o caminho certo
Um guia visual para diagnosticar Geyser, Floodgate e servidores Paper sem trocar configuração no escuro.
Autenticação e transporte são camadas diferentes
online-mode controla a autenticação Java. RakNet e NetherNet controlam como o cliente Bedrock chega ao servidor. Um não escolhe o outro.
O Geyser converte Bedrock → Java. O Floodgate cuida da identidade Bedrock. O ViaVersion converte versões Java quando está no caminho correto.
RakNet
Transporte UDP tradicional. O script confirma com um unconnected ping/pong.
NetherNet
Transporte WebRTC com signalling. Não aparece como um pong UDP comum.
Regra prática
Se o Geyser está configurado como raknet, use RakNet. Se está nethernet, valide signalling/WebRTC. Em both, as duas rotas precisam de portas separadas. Não troque auth-type apenas porque o transporte mudou.
Leia online-mode e auth-type
Confira server.properties e plugins/Geyser-Spigot/config.yml. Nunca publique management-server-secret, key.pem ou senhas.
Verifique a porta UDP
O endpoint Bedrock deve aparecer no UDP. Java normalmente usa TCP 25565; Geyser usa a porta Bedrock configurada.
Rode o probe
O probe separa pong RakNet, configuração NetherNet e evidência de signalling no log.
Leia o resultado
Se offline + floodgate, mantenha a key do Floodgate. Se online + online, a conta Java precisa ser válida. Em caso de falha, copie o erro literal.
diagnose-geyser-network.py
python3 scripts/diagnose-geyser-network.py --server-properties server.properties --geyser-config plugins/Geyser-Spigot/config.yml --log logs/latest.log --format markdownO comando fica no repositório em scripts/diagnose-geyser-network.py e não imprime segredos.
Use auth-type floodgate, mantenha a key e use o endpoint RakNet configurado. É o caso do servidor local analisado.
Use auth-type online. O transporte pode ser RakNet ou NetherNet conforme o cliente e a build; isso não é definido pelo online-mode.
Se o log disser duplicate_login, não é um problema de RakNet. É uma segunda sessão com a mesma identidade; pare a sessão antiga antes de reconectar.
O que este guia não inventa
Um ping não prova a presença de plugins, não sincroniza dados de contas e não torna um servidor Forge/Fabric compatível. Para mods, use o diagnóstico de compatibilidade separado.
