Note: This is an urgent update from GeyserMC. RakNet, the old Bedrock Edition connection protocol, is being deprecated and will stop working soon. Update your Geyser plugin and configuration as soon as possible to prevent Bedrock players from no longer being able to connect.

Minecraft Bedrock Edition is moving to a new connection protocol: NetherNet. The old protocol, RakNet, is officially deprecated and will stop working on Bedrock clients shortly. Running Geyser (for cross-play between Java and Bedrock)? Then you need to update both the plugin and the configuration.

What does this mean for you?

• Without updating, Bedrock players will eventually no longer be able to connect to your server, because their client switches to NetherNet while your Geyser still runs the old RakNet.
• Were you using the clone-remote-port configuration option? Then you'll get a new port number after the update, and your players will need to update their connection settings.
• Support for Bedrock Edition 26.30 has been dropped. Geyser now supports versions 26.40 through 26.60.

Step 1. Update Geyser to the latest build

Update Geyser via the Plugin Manager, just like other plugins:

1. Log in to the Game Panel and select your server.
2. Click More at the bottom of the menu, then choose Plugins.
3. Search for Geyser.
4. Click the download icon to install the latest build. This automatically replaces your current version.
5. Do not restart the server yet, read step 2 first.

Can't find it in the Plugin Manager? Download the latest build manually via the official GeyserMC download page and upload the file via Files → plugins (or mods, depending on your loader).

Step 2. Updating your Geyser configuration for NetherNet

1. Open your Geyser configuration file (usually config.yml in the Geyser-Spigot, Geyser-Fabric, or similar folder, depending on your loader) via the File Manager in the Game Panel.
2. Find the section that starts with bedrock:.
3. Follow GeyserMC's official instructions to update this section for NetherNet (or NetherNet and RakNet, if you want to temporarily support both protocols side by side): GeyserMC Setup Wiki.
4. Save the file.
5. Restart the server.

Note: We deliberately don't give exact configuration lines here, since these can differ per Geyser version and loader. Always follow GeyserMC's most recent official instructions, so you're sure you're using the correct settings.

Step 3. Checking the new port (if using clone-remote-port)

Were you using the clone-remote-port configuration option? Then the port number Bedrock players connect on will change after this update.

1. Check the new port number under Address in the Game Panel.
2. Inform your Bedrock players that they need to update their connection settings to this new port.

Note: As with any Bedrock connection, this also applies here: you share the IP address with other customers and are assigned your own, nonstandard port. See our article Setting Up Cross-Play Between Java and Bedrock (Geyser/Floodgate) for the full explanation.

Troubleshooting

• Bedrock players can no longer connect after the update: check whether the configuration was actually saved before restarting, and whether players are using the correct (possibly changed) port.
• Geyser doesn't start after the update: check whether your configuration file contains any syntax errors (for example incorrect YAML indentation), and compare it with a fresh, unmodified configuration if in doubt.
• Specific NetherNet error messages: report these to the GeyserMC community itself, via their support-forum/support channels on their Discord, or their issue tracker, they know the technical details behind this update best.

Still stuck with installing or updating via the Game Panel on our end? Feel free to reach out via Discord or create a support ticket.