DzBot Logo
DzBotBots • IA • Automações
FuncionalidadesComo funcionaLojaBlogNovidadesChatStatus
EntrarCriar conta

Buscar

Buscar páginas do site

Navegação

Funcionalidades
Como funciona
Loja
Blog
Novidades
Chat
Status
Começar agoraEntrar na minha conta
Navegar na documentação
  • Como usar o DzBot
  • API do DzBot
  • DzBot Runner
  • Guia de rede Minecraft
  • Compatibilidade com mods
  • Provider de IA
  • Guia do servidor (Java, Bedrock e offline)

Guias, referência da API e diagnóstico — escritos para serem lidos antes de integrar, não depois do primeiro erro.

  • Como usar o DzBot
  • API do DzBot
  • DzBot Runner
  • Guia de rede Minecraft
  • Compatibilidade com mods
  • Provider de IA
  • Guia do servidor (Java, Bedrock e offline)

Guias, referência da API e diagnóstico — escritos para serem lidos antes de integrar, não depois do primeiro erro.

DIAGNÓSTICO DE CONEXÃO

RakNet, NetherNet, offline e contas: o caminho certo

Um guia visual para diagnosticar Geyser, Floodgate e servidores Paper sem trocar configuração no escuro.

Guias validado em 24/09/2026Geyser · Floodgate · ViaVersion

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.

online-mode=false
UUID/offline ou Floodgate
transport: raknet | nethernet | both
Rota de transporte Bedrock
Matriz de decisão
Fluxo de uma conexão Bedrock

O Geyser converte Bedrock → Java. O Floodgate cuida da identidade Bedrock. O ViaVersion converte versões Java quando está no caminho correto.

Fluxo de uma conexão Bedrock

RakNet

Transporte UDP tradicional. O script confirma com um unconnected ping/pong.

UDP 19132/19134 → unconnected ping 0x01 → pong 0x1C

NetherNet

Transporte WebRTC com signalling. Não aparece como um pong UDP comum.

signalling → WebRTC → dados Bedrock

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.

Diagnóstico em 4 passos
01

Leia online-mode e auth-type

Confira server.properties e plugins/Geyser-Spigot/config.yml. Nunca publique management-server-secret, key.pem ou senhas.

02

Verifique a porta UDP

O endpoint Bedrock deve aparecer no UDP. Java normalmente usa TCP 25565; Geyser usa a porta Bedrock configurada.

03

Rode o probe

O probe separa pong RakNet, configuração NetherNet e evidência de signalling no log.

04

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.

Comando de diagnóstico

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 markdown

O comando fica no repositório em scripts/diagnose-geyser-network.py e não imprime segredos.

Casos comuns
Paper offline + Floodgate

Use auth-type floodgate, mantenha a key e use o endpoint RakNet configurado. É o caso do servidor local analisado.

Paper online + conta Java

Use auth-type online. O transporte pode ser RakNet ou NetherNet conforme o cliente e a build; isso não é definido pelo online-mode.

Configuração incompatível

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.

Referências oficiais
Geyser — setup e portasFloodgate — contas BedrockViaVersion — versões Java
Fluxo de diagnósticoRunner docs →
Nesta página
  1. Autenticação e transporte são camadas diferentes
  2. Fluxo de uma conexão Bedrock
  3. Quando usar RakNet ou NetherNet?
  4. Diagnóstico em 4 passos
  5. Comando de diagnóstico
  6. Casos comuns
  7. O que este guia não inventa

Nesta página

  1. Autenticação e transporte são camadas diferentes
  2. Fluxo de uma conexão Bedrock
  3. Quando usar RakNet ou NetherNet?
  4. Diagnóstico em 4 passos
  5. Comando de diagnóstico
  6. Casos comuns
  7. O que este guia não inventa

Projeto independente

Ajude o DZ Bot a continuar evoluindo

Seu apoio mantém servidores e APIs ativos e ajuda a criar novas funções.

Apoiar o DZ Bot→
DZBotDZBot

Plataforma para criar, configurar e acompanhar bots, automações e integrações em um painel web.

Produto

  • Funcionalidades
  • Plataforma
  • Como funciona
  • Planos

Recursos

  • Como usar o DzBot
  • API do DzBot
  • DzBot Runner
  • Guia de rede Minecraft
  • Compatibilidade com mods
  • Provider de IA
  • Guia do servidor (Java, Bedrock e offline)

Comunidade

  • Blog
  • Novidades
  • Sobre a DzBot
  • Avaliações
  • Dúvidas
  • Reportar problema

Suporte

  • [email protected]
  • Contato
  • Comunidade no Discord
  • Status do sistema

Informações legais

  • Privacidade
  • Termos de uso
© 2026 DZBot · Todos os direitos reservados.
NovidadesVersão e tecnologiasVoltar ao topo ↑