Screenshot 1 of 3. Geyser plugin official banner showing the cross-play bridge between Minecraft Java and Bedrock editions
What Geyser works with.
| Platform | Java Edition |
|---|---|
| Loaders | Paper, Spigot, BungeeCord, Velocity |
| Minecraft versions | 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.5, 1.21.11 |
Geyser is a bridge that lets Minecraft Bedrock Edition players join Java Edition servers. It runs as a plugin on Paper and Spigot, or on a Velocity or BungeeCord proxy, so Java players keep playing as before. Paper and Spigot builds cover 1.16.5 to 26.2, and Velocity and BungeeCord builds cover 1.21 to 26.2. The newest build is 2.11.3-b1249, released as a beta on 2026-10-06.
Builds and supported versions
- Paper and Spigot, 1.16.5 to 26.2, no dependencies
- Velocity and BungeeCord, 1.21 to 26.2, no dependencies
- Fabric mod build, 1.19 to 26.2, requires Fabric API
- NeoForge mod build, 1.20.4 to 26.2, no dependencies
The creator lists Java 26.2 as the current target and Bedrock releases 26.30 to 26.52. Older Java releases are covered by a separate guide on the GeyserMC wiki. Geyser is required on the server side only.
Installation on Paper or Spigot
- 1.Get the Paper or Spigot build from the Geyser download page.
- 2.Put the .jar in the plugins folder of your server.
- 3.Restart the server.
- 4.Read the setup guide on the GeyserMC wiki for how to set Geyser up.
On a network, put the Velocity or BungeeCord build in the proxy's plugins folder instead and restart the proxy. Players install nothing: Bedrock players join with their normal Bedrock Edition install. For the general routine, see how to install plugins on a server.
Limits to expect
Geyser translates packets between two different games, and the creator says plainly not to expect everything to work perfectly. Movement is not yet near-perfect, which matters on large servers with strict anticheat, and some entity flags are still missing. A further set of differences between Bedrock and Java cannot be fixed at all and is listed on the Current Limitations page of the wiki.
Bedrock and Java cross-play server setup with Geyser
Questions about Geyser.
4 questions
How do I install Geyser on a Paper server?
Put the Paper or Spigot Geyser .jar in the plugins folder of your server and restart it. Bedrock players then join with a normal Bedrock Edition install, so they add nothing on their side. The GeyserMC wiki has a setup guide. On Paper or Spigot, Geyser needs no other plugin.
Does Geyser work on Velocity or BungeeCord?
Yes. Separate Velocity and BungeeCord builds exist, both covering 1.21 to 26.2 and needing no other dependency. Put the build in the proxy's plugins folder and restart the proxy. Fabric and NeoForge builds are separate mod builds. Follow the GeyserMC wiki for the remaining setup.
Which Minecraft versions does Geyser support?
Paper and Spigot builds run from 1.16.5 to 26.2. Velocity and BungeeCord builds run from 1.21 to 26.2. The creator lists Java 26.2 as the current target and Bedrock releases 26.30 to 26.52. For older Java releases, the GeyserMC wiki has a dedicated guide.
Does everything work for Bedrock players?
Not everything. Geyser translates packets between two different games, so some features cannot match. Movement is not yet near-perfect, which matters where anticheat is strict, and some entity flags are missing. The Current Limitations page on the GeyserMC wiki lists what cannot be fixed.
