GeyserMC: Join Java Servers from Bedrock
GeyserMC (usually just "Geyser") is a free, open-source proxy that lets Minecraft Bedrock Edition players - on mobile, console, and Windows 10/11 - join Minecraft Java Edition servers. It translates the two editions' protocols in real time, so a single Java server can welcome both crowds without anyone buying a second copy of the game. This page covers what GeyserMC is, where it runs, how to install it, how Floodgate fits in, and how to fix the connection errors people hit most.
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 ... 19132" in the console. On a proxy network, install Geyser on the proxy instead and point remote at the proxy.
How Bedrock players connect
On a phone, console, or Windows 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.
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 chat problems: set enforce-secure-profile=false in server.properties.
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
Looking for Geyser-ready Minecraft Java hosting? Supercraft runs Minecraft dedicated servers with daily backups, instant setup, and 5 region options. Plans from $5.99/mo.