How to Set Up GeyserMC for Java and Bedrock Crossplay on Your Minecraft Server

GeyserMC is a plugin that translates Bedrock Edition connections into Java Edition, allowing players on mobile, console, and Windows 10/11 to join your Java server. Floodgate is a companion plugin that lets Bedrock players join without needing a Java Edition account.

Installing GeyserMC and Floodgate

1. Download Geyser-Spigot and Floodgate-Spigot from the GeyserMC downloads page.
2. Navigate to the Wabbanode Control Panel and Stop your server.
3. Click Files to access the file manager.
4. Navigate to the plugins folder.
5. Click Upload Files and upload both Geyser-Spigot.jar and Floodgate-Spigot.jar.
6. Start your server. GeyserMC and Floodgate will generate their configuration files on first run.
7. Stop your server again to edit the configuration.

Configuring GeyserMC

1. In the file manager, navigate to plugins/Geyser-Spigot/ and open config.yml.
2. Locate the auth-type setting and set it to floodgate:

auth-type: floodgate

3. Verify the Bedrock port is set correctly:

bedrock:
  port: 19132

4. Click Save and close the file.

Allocating the Bedrock Port

Bedrock Edition uses a separate port from your Java server port. You need to allocate this port in the Wabbanode Panel.

1. Create an additional port allocation for your Geyser port. See our guide on How to Create Additional Ports for Your Server for step-by-step instructions.
2. Start your server. GeyserMC should now be listening for Bedrock connections.

How Bedrock Players Connect

Once GeyserMC is running, Bedrock players can connect using your server's IP address and port 19132:

1. Open Minecraft Bedrock Edition.
2. Tap Play, then select the Servers tab.
3. Scroll down and tap Add Server.
4. Enter your server's IP address in the Server Address field.
5. Enter 19132 (or your custom Bedrock port) in the Port field.
6. Tap Save and then tap the server to join.

Understanding the Floodgate Username Prefix

Floodgate adds a . (period) prefix to Bedrock player usernames to distinguish them from Java players. For example, a Bedrock player named "Steve" will appear as .Steve on the server.

This prefix can be changed in plugins/Floodgate/config.yml by editing the username-prefix setting. Setting it to an empty string ("") removes the prefix entirely.

Troubleshooting

• Bedrock players can't connect. Verify that port 19132 has been allocated and supports UDP traffic. Check the console for GeyserMC startup messages confirming it's listening on the correct port.
• "Unable to Connect to World" error. The Bedrock port is not reachable. Confirm the port allocation, check that GeyserMC loaded without errors in the console, and ensure the player is using the correct IP and port.
• Bedrock player skins not showing. Update GeyserMC and Floodgate to the latest versions. Bedrock skins require both plugins to be current.
• Version mismatch errors. Bedrock Edition auto-updates and GeyserMC may take a few days to support new Bedrock versions after a release. Wait for a GeyserMC update if this occurs.
• Auth-type errors. Ensure auth-type is set to floodgate in the GeyserMC config and that Floodgate is installed in the plugins folder. If you don't have Floodgate, use online instead (Bedrock players will need a Java account).