Java + Bedrock crossplay

What Geyser does#

Geyser translates between a Bedrock client and a Java server. Java players connect normally. Bedrock players use Bedrock Edition on supported devices and connect to Geyser’s listener.

Bedrock player → Geyser → Java server

Floodgate is an optional companion that lets supported Bedrock accounts join without owning a paid Java account and adds Bedrock identity/linking features.

Before installing#

Geyser’s supported game versions change frequently because Bedrock updates automatically. Check the official supported versions page ↗ on installation day. The page also explains when ViaVersion or ViaProxy is needed for an older Java backend.

Geyser translates the protocol; it cannot make Bedrock clients understand Java client-side mods. Modded content that requires a matching Java client is generally not a good crossplay foundation.

Paper setup#

1. 1
   Back up and stop the server.
2. 2
   Download Geyser-Spigot from the official Geyser download page ↗.
3. 3
   Put the jar in plugins and restart once.
4. 4
   Open plugins/Geyser-Spigot/config.yml.
5. 5
   Confirm the Bedrock listen address and choose the UDP port.
6. 6
   Restart and run Geyser’s connection test command from the console.
7. 7
   Make the Bedrock UDP port reachable with a compatible tunnel or a careful UDP port forward.
8. 8
   Test Java and Bedrock separately.

Geyser’s default examples use UDP 19132. Another UDP service cannot share the same address/port. Your tunnel or host may assign a different value.

Add Floodgate#

1. 1
   Download the platform-specific Floodgate jar from the official Geyser page.
2. 2
   Place it in plugins and restart.
3. 3
   Set Geyser’s authentication type to floodgate as the official setup guide describes.
4. 4
   Restart and test with a Bedrock account.
5. 5
   Use Floodgate-aware whitelist commands where documented.

What players should expect#

• Java players keep using Java Edition and the normal Java address.
• Bedrock players use the Bedrock address and UDP port.
• Menus, combat, redstone, skins and movement can differ because two editions are being translated.
• Consoles can make adding arbitrary external servers less direct than mobile or Windows Bedrock.
• Account linking is optional and should follow Geyser’s current linking documentation.

Fabric and proxy setups#

Geyser publishes Fabric, NeoForge, Velocity, standalone and other platform builds, but their supported versions are not identical. Official documentation currently recommends installing Geyser only on the proxy in a proxy network. Use Fabric/NeoForge builds only when their exact server release is supported.

Troubleshooting#

Official guides: Geyser setup ↗ · Floodgate setup ↗