GeyserMC: Play Java Servers from Bedrock - Setup, Floodgate & Fixes (2026)

GeyserMC: Join Java Servers from Bedrock

GeyserMC (usually just "Geyser") is a free, open-source proxy that lets Minecraft Bedrock Edition clients join a Minecraft Java Edition server. Windows and mobile clients can add its address directly. Console clients can use the protocol too, but Xbox, PlayStation, and Switch usually require an unofficial discovery workaround to reach a third-party address. This page covers Geyser, Floodgate, UDP networking, and those access limits.

What is GeyserMC?

Java and Bedrock are different builds of Minecraft that normally cannot talk to each other. Geyser sits in the middle and converts Bedrock packets into Java packets (and back), so Bedrock clients see your Java world as if it were a native Bedrock server. It is maintained by the GeyserMC team and downloaded from geysermc.org. It is almost always paired with Floodgate (below), which removes the Java-account requirement for Bedrock players.

What GeyserMC runs on

Geyser is distributed as a build for each platform - pick the one that matches your server:

• Paper / Spigot - the most common setup; drop the plugin in /plugins/.
• Fabric / NeoForge - mod builds for modded servers.
• Velocity / BungeeCord - run Geyser once on the proxy in front of a server network.
• Geyser-Standalone - a separate process in front of any Java server, including otherwise unsupported setups.

Plain vanilla is not supported as a plugin host - use Paper/Spigot/Fabric, a proxy, or Standalone in front of it.

Geyser vs Floodgate

These two are easy to confuse:

• Geyser is the bridge that makes Bedrock clients able to connect at all.
• Floodgate is the companion plugin that lets those Bedrock players join without owning Java Edition. With auth-type: floodgate, Bedrock accounts are handled directly. Without it (auth-type: online), Bedrock players must link a Java/Microsoft account first.

For a public crossplay server you almost always want both, with auth-type: floodgate.

How to install GeyserMC (Paper/Spigot)

1. Add the plugins

Upload Geyser-Spigot.jar and floodgate-spigot.jar to your server's /plugins/ folder, then restart once to generate the config files.

2. Set the Bedrock (UDP) port

Open plugins/Geyser-Spigot/config.yml and set the bedrock section:

3. Point Geyser at your Java server

In the remote section, match your Java server's IP and port and choose Floodgate auth:

4. Restart

Restart and look for "Started Geyser on UDP port ..." in the console. On a proxy network, install Geyser on the proxy instead and point remote at the proxy.

On a Supercraft Java server: the exact steps

Verified on September 3, 2026 with Geyser 2.11.2 and Floodgate 2.2.5 on a Paper server, including a Bedrock-protocol ping from outside the node. The one thing that differs from a home setup is the port. Your server owns a block of ports, and two of them are already taken: your server port carries Java (TCP) and Minecraft's query listener (UDP), and the next port is RCON. So Geyser goes on your server port plus two.

1. Upload Geyser-Spigot.jar and floodgate-spigot.jar into the Plugins partition in the file manager (or FTP into /plugins). Paper, Purpur and Spigot servers all have it.
2. Restart once so Geyser writes plugins/Geyser-Spigot/config.yml.
3. Edit the config. If your server port is 11640, set:
   bedrock: address: 0.0.0.0 port: 11642 # your server port + 2 remote: address: 127.0.0.1 port: 11640 # your server port auth-type: floodgate
   Leave port at the default 19132 and Geyser will not be reachable, because that port belongs to whichever server on the node claimed it first. Use your server port itself and Geyser will fail to bind, because Minecraft's query listener is already on it.
4. Restart again. The console shows Started Geyser on UDP port 11642 and, a line later, Query running on 0.0.0.0:11640. Both are correct.
5. Connect from Bedrock with your server address and port 11642. Java players keep using 11640.

No firewall change is needed. Ports in your block accept UDP by default, and the verification above was a live RakNet ping answered with the server's MOTD.

How Bedrock players connect

On a phone, tablet, or Windows Bedrock client, add a server with:

• Server Address: your server IP or domain.
• Port: the Geyser UDP port (e.g. 19132) - not the Java 25565 port.

For Xbox, PlayStation, or Switch, use Geyser's current console guide. It documents third-party approaches such as BedrockConnect and explicitly notes that they are not affiliated with GeyserMC. Test the exact console and current game version before promising access.

Common GeyserMC issues

"Unable to connect to world": the UDP port (19132) is blocked or not forwarded. Bedrock uses UDP, so a TCP-only forward or firewall rule will not work - open/forward the UDP port.

Bedrock client cannot see the server / version error: Geyser must support your Bedrock client version. Keep Geyser up to date - it tracks the latest Bedrock and Java releases, and a brand-new Bedrock update can briefly outrun the current build.

"Invalid signature" or secure-chat problems: follow Geyser's current secure-chat guidance for the exact server and authentication setup. Changing profile enforcement has security implications, so do not use it as a generic network fix.

Bedrock players are asked to log in / cannot join: Floodgate is missing or auth-type is not set to floodgate. Add Floodgate and set the auth type, or have players link a Java account.

FAQ

Is GeyserMC safe and official?

Yes - it is an established open-source project from the GeyserMC team. Always download from geysermc.org, not third-party mirrors.

Will every Java feature work for Bedrock players?

Most do, but the two editions differ, so a few Java-only mechanics and some UI elements translate imperfectly. Core gameplay works well.

Can I run Geyser on a network of servers?

Yes - install it once on your Velocity or BungeeCord proxy rather than on each backend.

Related guides

• Minecraft Wiki home
• Minecraft Java, Bedrock, Realms, and console crossplay
• Bedrock UDP port and console-access troubleshooting
• DiscordSRV setup (link Discord to your server)

Looking for Geyser-ready Minecraft Java hosting? Supercraft runs Minecraft dedicated servers with daily backups, instant setup, and 4 region options.