DzBot Logo
DzBotBots • AI • Automations
FeaturesHow it worksStoreBlogChangelogChatStatus
Sign inCreate account

Buscar

Buscar páginas do site

Navigation

Features
How it works
Store
Blog
Changelog
Chat
Status
Get startedSign in to my account
Browse the documentation
  • How to use DzBot
  • DzBot API
  • DzBot Runner
  • Minecraft network guide
  • Mod compatibility
  • AI provider
  • Server guide (Java, Bedrock and offline)

Guides, API reference and diagnostics — written to be read before you integrate, not after the first error.

  • How to use DzBot
  • DzBot API
  • DzBot Runner
  • Minecraft network guide
  • Mod compatibility
  • AI provider
  • Server guide (Java, Bedrock and offline)

Guides, API reference and diagnostics — written to be read before you integrate, not after the first error.

CONNECTION DIAGNOSTICS

RakNet, NetherNet, offline mode and accounts: the right path

A visual guide to diagnosing Geyser, Floodgate and Paper without changing configuration blindly.

Guide validated on 2026-09-24Geyser · Floodgate · ViaVersion

Authentication and transport are different layers

online-mode controls Java authentication. RakNet and NetherNet control how a Bedrock client reaches the server. Neither one selects the other.

online-mode=false
UUID/offline ou Floodgate
transport: raknet | nethernet | both
Rota de transporte Bedrock
Decision matrix
Bedrock connection flow

Geyser converts Bedrock → Java. Floodgate handles Bedrock identity. ViaVersion converts Java versions when it is in the correct path.

Bedrock connection flow

RakNet

Traditional UDP transport. The script confirms it with an unconnected ping/pong.

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

NetherNet

WebRTC transport with signalling. It does not appear as a normal UDP pong.

signalling → WebRTC → dados Bedrock

Practical rule

If Geyser is configured as raknet, use RakNet. If it is nethernet, validate signalling/WebRTC. In both mode, the two routes need separate ports. Do not change auth-type just because transport changed.

Diagnose in 4 steps
01

Read online-mode and auth-type

Check server.properties and plugins/Geyser-Spigot/config.yml. Never publish management-server-secret, key.pem or passwords.

02

Check the UDP port

The Bedrock endpoint should appear on UDP. Java normally uses TCP 25565; Geyser uses the configured Bedrock port.

03

Run the probe

The probe separates RakNet pong, NetherNet configuration and signalling evidence in the log.

04

Read the result

For offline + floodgate, keep the Floodgate key. For online + online, the Java account must be valid. On failure, copy the literal error.

Diagnostic command

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.

Common cases
Paper offline + Floodgate

Use auth-type floodgate, keep the key and use the configured RakNet endpoint. This is the local server case that was analysed.

Paper online + Java account

Use auth-type online. Transport can be RakNet or NetherNet depending on client and build; online-mode does not define it.

Incompatible configuration

If the log says duplicate_login, it is not a RakNet problem. A second session has the same identity; stop the old session before reconnecting.

What this guide does not invent

A ping does not prove plugin presence, does not sync account data and does not make Forge/Fabric compatible. For mods, use the separate compatibility diagnosis.

Official references
Geyser — setup and portsFloodgate — Bedrock accountsViaVersion — Java versions
Fluxo de diagnósticoRunner docs →
On this page
  1. Authentication and transport are different layers
  2. Bedrock connection flow
  3. When should I use RakNet or NetherNet?
  4. Diagnose in 4 steps
  5. Diagnostic command
  6. Common cases
  7. What this guide does not invent

On this page

  1. Authentication and transport are different layers
  2. Bedrock connection flow
  3. When should I use RakNet or NetherNet?
  4. Diagnose in 4 steps
  5. Diagnostic command
  6. Common cases
  7. What this guide does not invent

Independent project

Help DZ Bot keep growing

Your support keeps our servers and APIs running and helps us build new features.

Support DZ Bot→
DZBotDZBot

A web platform to create, configure, and monitor bots, automations, and integrations in one dashboard.

Product

  • Features
  • Platform
  • How it works
  • Pricing

Resources

  • How to use DzBot
  • DzBot API
  • DzBot Runner
  • Minecraft network guide
  • Mod compatibility
  • AI provider
  • Server guide (Java, Bedrock and offline)

Community

  • Blog
  • What's new
  • About DzBot
  • Reviews
  • FAQ
  • Report an issue

Support

  • [email protected]
  • Contact
  • Discord Community
  • System Status

Legal information

  • Privacy
  • Terms of use
© 2026 DZBot · All rights reserved.
What's newVersion & technologiesBack to top ↑