How it works
Geyser is a plugin that translates between Bedrock and Java, so Bedrock players can join your Java server. Floodgate is its partner plugin. It lets Bedrock players join without owning a Java account.
Both run as plugins on Paper. You need a Minecraft: Java Edition server with SERVER_TYPE set to paper.
Add a port for Bedrock
Java players connect over TCP on your main port. Bedrock players connect over UDP, so Geyser needs a port of its own. Bedrock normally uses 19132, but your server gets its own free port instead.
- Open Network in the panel.
- Press Add a port. The panel picks a free port and lists it under your main port.
- Type Geyser under What uses this port and press Save note.
Install the plugins
- Download the Paper builds of Geyser and Floodgate from the official GeyserMC site.
- Open Files, then plugins, and upload both .jar files.
- Restart the server so both plugins make their config files.
Watch out: Geyser is bigger than the preview's upload limit of 512 KB. You can follow these steps on a real server once SFTP opens at launch.
Point Geyser at the new port
- Stop the server.
- Open plugins, then Geyser-Spigot, then config.yml.
- Under bedrock, set port to the port you added.
- Press Save, then Start.
bedrock: port: 25566
Use your own extra port from Network. 25566 is only an example.
Tip: If your Geyser config has an auth-type setting, set it to floodgate. With both plugins on the same server, Floodgate needs no other setup.
How Bedrock players join
- Open Minecraft on a phone, tablet or Windows PC, press Play and open the Servers tab.
- Press Add Server.
- Enter the address without the port in Server Address.
- Enter the Geyser port in Port, then save and join.
Floodgate puts a dot in front of Bedrock names by default, such as .Steve, so they never clash with Java names. To whitelist a Bedrock player, use fwhitelist add with their gamertag.