Geyser translates between Bedrock and Java, so players on phones, consoles and Windows Bedrock can join a Java server. Floodgate lets them join without owning a Java account. Together they make one server for everyone.
Before you start
- The server runs Paper (or Spigot or Purpur) on a recent Minecraft version.
- You need a UDP port for Bedrock. Bedrock uses UDP, Java uses TCP, so Geyser can share the same port number as Java (see below) or use its own extra port.
Install
- Download Geyser-Spigot and Floodgate-Spigot from geysermc.org/download.
- Stop the server, upload both jars into the
pluginsfolder, and start it once. This createsplugins/Geyser-Spigot/config.yml. - Stop the server and open that config.
Configure the port and login
Pick one of these two:
- Same port as Java (simplest): under
bedrock:setclone-remote-port: true. Bedrock players then use the same address and port number as Java players. - Separate port: set
bedrock: port:to an extra port added to your server (ask us on Discord if you need one), for example19132.
Then under java: set auth-type: floodgate so Bedrock players do not need a Java account. Save and start the server.
How Bedrock players join
- Play → Servers → Add Server.
- Server address: your server's address. Port: the Java port if you used
clone-remote-port, otherwise the Bedrock port you set. - Join. Floodgate gives Bedrock players a
.in front of their name (for example.Steve) so names never clash with Java players. Use that full name in commands likeop .Steveand whitelists.
Common problems
- "Unable to connect to world": the Bedrock port is wrong or not UDP. Check the port in the Geyser config and in the panel.
- "Outdated client" or "Outdated Geyser": update Geyser. New Bedrock versions usually need a Geyser update the same week.
- Whitelist blocks Bedrock players: add them with
fwhitelist add .Name(Floodgate's command) or use their full name with the dot. - Mods: Geyser works with Paper plugins, not with Forge or Fabric mods. Modded servers cannot offer crossplay.
Not set up yet? Start with how to make a Minecraft server, or get a Minecraft server where we can set crossplay up for you.