How to Set Up Geyser and Floodgate for Java and Bedrock

To let Bedrock players join your Java server, install Geyser and Floodgate on a Paper server, set Geyser's transport to nethernet, set auth-type to floodgate and open one extra port for TCP and UDP. Bedrock players then join with your server address and the Bedrock port, with no Java account.

What Geyser and Floodgate do

Geyser is a bridge between Minecraft Bedrock Edition and Minecraft Java Edition. It sits on your Java server, receives the connection from a Bedrock player and translates it into something the Java server understands. Floodgate goes with it. It lets Bedrock players join with only their Bedrock account, so they do not need to buy Java Edition.

This is a community project, not an official Mojang feature. It also works in one direction: Bedrock players join Java servers. The reverse does not exist, so Java players cannot join a Bedrock server. The full picture is in can Java and Bedrock play together.

What you need first

• A Java server on Paper or Spigot 1.20.5 or newer, running Java 21 or newer. Geyser also supports Fabric, NeoForge, Velocity, BungeeCord and a standalone mode; this guide covers Paper. If you are not on Paper yet, how to install plugins on a Paper server shows how to add plugins.
• The right versions. As of November 2026, the Geyser wiki says Geyser supports Minecraft Bedrock 26.40 to 26.62 and Minecraft Java 26.3. Geyser connects as a Java 26.3 client, so if your server runs another version, install the ViaVersion plugin too.
• One extra port that is different from your Java port. More on that below.

Install Geyser and Floodgate on Paper

1. Download Geyser-Spigot.jar and Floodgate-Spigot.jar from the GeyserMC download page.
2. Open the Files section of your panel, go into the plugins folder and upload both JAR files. For many files, connect over SFTP instead.
3. Restart the server. Geyser creates its folder, plugins/Geyser-Spigot, with a config.yml inside.

Change two settings in Geyser's config

Stop the server, open plugins/Geyser-Spigot/config.yml and find the bedrock: section. Set the port and turn on NetherNet, the connection type Bedrock clients use since version 26.60:

bedrock:
  port: 19132
  transport: nethernet

Then find auth-type in the same file and change its value to floodgate. That tells Geyser to let Floodgate sign Bedrock players in, so they do not need a Java account. Start the server again.

Open the Bedrock port

Geyser listens on its own port, 19132 by default, and it must not be the same as your Java server's port. With NetherNet, Geyser uses that port for both TCP (the join handshake) and UDP (gameplay), so both need to be open. Older guides that mention UDP only describe the previous connection type.

On your own PC, that means a port-forwarding rule in your router for TCP and UDP, plus a firewall rule. On a hosting panel the host assigns ports, so the Bedrock port may not be 19132. Ask your host for the extra port, put that number in Geyser's port setting and give the same number to your Bedrock players.

Join from Bedrock and add your friends

1. On a phone, tablet or Windows PC, open Minecraft Bedrock, go to Play, then Servers, and choose Add Server. The full walkthrough is in how to add a server in Minecraft Bedrock.
2. Enter your Java server's address and the Bedrock port from Geyser's config, not the Java port.
3. Save the server and join.

Consoles cannot type an address in the Servers tab, so Xbox, PlayStation and Switch players need a helper such as BedrockConnect. How to join a Bedrock server on Xbox, PlayStation and Switch covers it.

If your server uses a whitelist, add Bedrock players with Floodgate's own command, using their Bedrock name:

fwhitelist add MyBedrockName

What does not work for Bedrock players

Geyser translates between two different games, so a few things cannot match exactly. The Geyser wiki keeps a list of current limitations. The main ones:

• Client-side Java mods do not work. Geyser works with server-side mods and plugins only.
• Clickable links in chat, the glowing effect and invisible item frames cannot be reproduced.
• Bedrock cannot tell left clicks from right clicks in inventories, so some plugin menus behave differently.
• Combat, redstone and some blocks and items differ between the editions.

Plugins that open menus and forms work best when they are tested with a Bedrock account first.

Optional: link a Bedrock and a Java account

Players who use both editions can link them so they keep one inventory and one set of stats. With global linking enabled, they join link.geysermc.org with both accounts, type /linkaccount on one and /linkaccount followed by the code on the other. After linking, the Java account's data is used, so move your items to the Java account first. /unlinkaccount undoes it.

Set up Geyser on TheGameHosting

The steps above are the same on our panel. Open Minecraft Java server hosting, choose a plan, and pick Paper from the Version Changer. The plans page lists all nine plans, from 2 GB to 64 GB. Then upload the two JAR files in Files, edit the config in the browser and restart from the panel.

Crossplay is available on every plan, and our support team can help with Geyser through live chat or a ticket. Prefer a server that is Bedrock from the start? How to make a Minecraft Bedrock server covers that route. If Bedrock players cannot connect after setup, go to Geyser not working.

FAQ

Hosting for these games

• Minecraft Bedrock hostingPhones, consoles and Windows
• Minecraft Java hostingPaper, Purpur, Fabric, Forge and more