How to set up GeyserMC and Floodgate (Java and Bedrock crossplay)

GeyserMC is a plugin that lets Bedrock Edition players join a Java Edition server. Floodgate is its companion plugin that lets them join without owning a Java account.

What you need

• A Paper, Spigot or Purpur Java server
• The Geyser and Floodgate plugins for your server type, from the official GeyserMC site
• A UDP port for Bedrock players, normally 19132. Ask us on Discord to add one if your plan does not have it yet.

Install

1. Stop your server.
2. Upload Geyser and Floodgate .jar files to the plugins folder.
3. Start the server once so the config files are created, then stop it.
4. Open plugins/Geyser-Spigot/config.yml. Under bedrock, make sure the port matches your UDP allocation. Keep auth-type set to floodgate.
5. Start the server again.
6. In Bedrock, add a server with your IP and the Bedrock port.

Good to know

• Bedrock player names get a prefix (a dot by default) so they don't clash with Java names.
• Consoles can't type a server address normally. Players can use a Bedrock server list app or a DNS trick, which we can help explain.
• If you use a proxy like Velocity, Floodgate needs to be installed on the proxy and the servers share the same key.pem.

Common errors

• "Unable to connect to world" on Bedrock: the UDP port is not open or is wrong. Check the Bedrock port.
• Bedrock players can't join after a Minecraft update: update Geyser, Floodgate and ViaVersion.
• "Failed to verify username": make sure Floodgate is installed on the server and online-mode is true.
• Bedrock players can't break blocks in protected areas: check your protection plugin's settings for Floodgate players.