MinecraftMinecraft•Plugins

How to Set Up GeyserMC and Floodgate on Your Minecraft Server

Let Bedrock players on phones, consoles and Windows join your Java Minecraft server with Geyser and Floodgate, without a Java account.

Bedrock players on phones, consoles and Windows can’t join a Java server on their own. Geyser translates between the two editions so they can, and Floodgate lets those players in without buying a Java account. Once both are set up, Java and Bedrock players share the same world.

Geyser and Floodgate are plugins, and the default Vanilla server can’t load plugins, so the first step is switching your server to Paper. Before you start, download Floodgate-Spigot.jar from the GeyserMC download page. If your world matters to you, make a backup under Backups first.

Switch to Paper

  1. Open the Physgun Gamepanel and select Server Options in the menu on the left.
  2. Select the Version tab at the top of the page.
  3. Type Paper in the Search editions… box.
  4. Select Paper.
  5. Select the version at the top of the list, marked Latest. The Geyser docs say Paper servers should run 26.3, and other versions need the ViaVersion plugin as well.
  6. Leave Delete all server files first turned off so you keep your world, then select Install.
  7. Select Yes, install it. Your server stops while Paper installs.
  8. Wait for the console to show Successfully installed version. In our test this took under a minute.

Start the server once

Paper has to run once before you add plugins.

  1. Select Start at the top of the page.
  2. If the Minecraft EULA appears, read it and select Accept.
  3. Wait until the console shows For help, type "help".

Install Geyser

  1. Select Plugin Manager under Tools in the menu on the left.
  2. Select Modrinth as the source.
  3. Type Geyser in the Search for plugins… box.
  4. Select Install next to Geyser by GeyserMC.
  5. Wait for the message that says Geyser was installed. Geyser now shows the Installed label.

This places Geyser-Spigot.jar in your server’s plugins folder.

Add Floodgate

Floodgate isn’t listed in the Plugin Manager, so you upload the jar you downloaded earlier.

  1. Select Files in the menu on the left.
  2. Open the plugins folder. Geyser-Spigot.jar is already there.
  3. Select New.
  4. Select Upload and choose Floodgate-Spigot.jar on your computer.
  5. Select Restart at the top of the page, and confirm if you’re asked. Both plugins load and create their settings files.
  6. Open Console. Geyser and Floodgate both print an Enabling line, and Geyser finishes with Done (...)! Run /geyser help for help!. This takes about a minute.

Floodgate also creates plugins/floodgate/key.pem. Never share this file. Anyone who has it can pretend to be any Bedrock player on your server.

Edit Geyser’s config

Geyser needs two changes. Bedrock players have to use your server’s game port, and Geyser has to let Floodgate handle their logins.

  1. Select Files in the menu on the left.
  2. Open the plugins folder.
  3. Open the Geyser-Spigot folder. Geyser created it on the last start. If it’s missing, restart once more.
  4. Select config.yml to open it in the editor.
  5. Near the top, find clone-remote-port: false and change false to true.
  6. Scroll down to the java section, a little below the middle of the file (around line 91 in our test).
  7. Find auth-type: online and change online to floodgate.
  8. Select Save, the disk icon at the top right of the editor.

Only change the values. Keep the spaces in front of each line exactly as they are, because extra or missing spaces break the file. When you’re done, the two lines look like this:

  clone-remote-port: true
  auth-type: floodgate

Leave the port: 19132 line under bedrock as it is. With clone-remote-port: true, Geyser ignores that value and uses your server’s game port, so Bedrock players connect on the same port as Java players and you don’t need a second port.

Restart and check

  1. Select Console in the menu on the left.
  2. Select Restart at the top of the page.
  3. Select Yes, Restart if the panel asks you to confirm.
  4. Wait about a minute for Geyser to start. The lines to look for:
[Geyser-Spigot] Built-in signaling cannot use port 25000 because the Java server already uses it. Bedrock players can still find this server through the external signaling service at https://agent.warden.cloud instead.
[Geyser-Spigot] Done (1.813s)! Run /geyser help for help!
[Geyser-Spigot] Registered with the external signaling service. Players can join at https://navypasture.wdn.gg (instance ...).

Your port number, timings and join link will be different. The first line shows up in yellow because Geyser shares your game port, which is expected. What you need to see is the Registered with the external signaling service line.

The console after a restart, showing Geyser registered with the external signaling service and a join linkCheck Geyser startedWait for Geyser to say it registered with the external signaling service.
  1. Type geyser version in the command box and press Enter. The console shows the Geyser version and which Bedrock versions can join, for example:
This server is running Geyser version 2.12.1-b1305 (git-master-1760ffb) (Java: 26.3, Bedrock: 26.40 - 26.65)
  1. Type floodgate version and press Enter. The console shows the Floodgate version and whether there’s an update, for example You're running the latest version of Floodgate!.

In game, an operator can run the same commands as /geyser version and /floodgate version.

Joining from Bedrock

Java players keep joining with your usual address. Bedrock players open Play, go to the Servers tab and select Add Server. They enter your server’s IP as the address and your game port as the port. Both are shown under Connect at the top of the Console page.

If your server has a whitelist, add Bedrock players with Floodgate’s own command. Use their Bedrock name, without any prefix:

/fwhitelist add BedrockName

The normal /whitelist command is only for Java players.

Without the panel

The manual way works on any Paper or Spigot server where you can upload files and use the console. We tested its upload, config and console parts on our servers.

  1. Make sure the server runs Paper or Spigot. To switch by hand, download Paper from papermc.io and replace your server jar with it, using the file name your startup settings expect (for example server.jar).
  2. Download Geyser-Spigot.jar and Floodgate-Spigot.jar from the GeyserMC download page.
  3. Stop the server, upload both jars to the plugins folder, then start it once so the config files appear.
  4. In plugins/Geyser-Spigot/config.yml, set auth-type: floodgate.
  5. Set the Bedrock port. If your server only has one port, set clone-remote-port: true as shown above. If it has a spare port, you can instead set port under bedrock to that port (19132 by default). It must be different from the Java port, and the Geyser docs say it must be open for both TCP and UDP.
  6. Restart, then run geyser version and floodgate version in the console.

Fabric and NeoForge servers use the Fabric or NeoForge builds of both, placed in the mods folder, and Fabric also needs Fabric API. On a Velocity or BungeeCord network, Geyser goes on the proxy only. Geyser handles server-side plugins and mods only, so anything that needs a mod on the player’s own game won’t work for Bedrock players.

If it does not work

  • No Geyser or Floodgate lines in the console: the server is probably still on Vanilla. Check that Server Options -> Version shows Paper, and that both jars are in plugins, not in a subfolder.
  • Geyser fails to load its config: a line in config.yml lost or gained spaces. Compare clone-remote-port and auth-type with the lines around them.
  • Bedrock players are asked to sign in to a Java account or get kicked: auth-type is still online, or Floodgate didn’t load. Check the line, then restart and run floodgate version.
  • Bedrock players get “Outdated client” or can’t connect: compare their game version with the Bedrock range that geyser version shows. If it’s out of range, update Geyser in the Plugin Manager and upload the newest Floodgate.
  • Still no Bedrock connection: check that the console shows the Registered with the external signaling service line after a restart. If it does and players still can’t connect, contact our support with the Geyser lines from your console.
geysermcfloodgateminecraft crossplaybedrock players on java serverpaper plugins

Was this article helpful?

3 Day Refund Guarantee

Ready to launch your Minecraft server?

Deploy a high-performance Minecraft server on overclocked hardware in seconds, with full file access, custom settings, and no player slot limits.

Launch My Minecraft Server