GeyserMC
Allow Bedrock Edition players to join your Java Edition server. Translates between Bedrock and Java protocols automatically.
AdminWhat is GeyserMC?
GeyserMC is a protocol translator that lets Bedrock Edition players — phones, consoles, the Windows 10 app — join a Java Edition server as if they were Java clients. It sits between the two editions and converts packets, block and item mappings, inventories and forms in both directions. Skins are converted, Bedrock-style form menus are supported, and most vanilla gameplay works transparently. It is usually paired with Floodgate so Bedrock players can join without owning a Java account. Geyser can run as a server plugin or as a standalone proxy.
Who it's for: Servers that want to open their doors to the large Bedrock playerbase — cross-play communities, mobile-friendly servers, and anyone wanting one server reachable from every platform. It is built and maintained by GeyserMC Team and sits in the admin category.
Key features of GeyserMC
- Bedrock to Java translation
- Skin conversion
- Form-based menus
- Resource pack support
- Custom skulls
- Emote forwarding
- Command suggestions
How to install GeyserMC
GeyserMC runs on Spigot, Paper or Velocity servers. The GeyserMC team updates quickly to keep a supported Bedrock client range able to join supported Java server versions after each release. It runs on Spigot/Paper and Velocity, or standalone.
- 1Stop your server, or have it ready to restart. Always back up your world and plugins folder before adding a new plugin.
- 2Download GeyserMC.jar (a build matching your server version) and place it in your server's /plugins folder.
- 3GeyserMC has no required dependencies, so it runs on its own once the jar is in place.
- 4Start the server fully. GeyserMC generates its configuration files on first launch — stop the server, edit them to taste, then start again.
- 5Confirm it loaded by checking the console for GeyserMC on startup, or by running one of its commands in-game.
Note: Drop Geyser-Spigot.jar (or the proxy build) into /plugins and restart to generate config.yml, where the Bedrock listen port is set (default 19132, UDP). Open that UDP port on your host/firewall. Install Floodgate alongside it so Bedrock players can join without a Java account; otherwise they need a linked Java account.
GeyserMC commands and permissions
Main commands
/geyser offhand- Lets a Bedrock player move an item to their off-hand, which Bedrock controls differently from Java.
/geyser dump- Generates a diagnostic dump used when seeking support for connection issues.
/geyser reload- Reloads Geyser's configuration.
/geyser version- Shows the Geyser version and the Bedrock/Java versions it currently supports.
Permission nodes
geyser.command.offhand- Allows Bedrock players to use the off-hand command.
geyser.command.dump- Allows generating a support dump.
geyser.command.reload- Allows reloading Geyser; staff-only.
GeyserMC FAQ
Does GeyserMC let Bedrock players join a Java server?
Yes — that is its entire purpose. Geyser translates between Bedrock and Java protocols so a player on a phone, console or the Windows 10 edition can connect to your Java server. They connect to the Bedrock port you configure (default 19132 UDP).
Do Bedrock players need a Java account?
Only if you run Geyser without Floodgate. Install Floodgate alongside Geyser and Bedrock players join with their Xbox Live account, no Java purchase required. This Geyser-plus-Floodgate pairing is the standard cross-play setup.
Why can't Bedrock players connect?
Most often the Bedrock UDP port (default 19132) is not open on the host or firewall — Bedrock uses UDP, not TCP. Confirm the port is forwarded, that Geyser is listening, and that players are entering the correct address and port in the Bedrock servers list.
Does everything work the same for Bedrock players?
Most vanilla gameplay translates well, but there are inherent edition differences — some controls, inventory interactions and a few mechanics behave differently, and heavily modded or packet-level plugin features may not map perfectly. Geyser handles the common cases transparently and improves continuously.
Can Geyser run without being a server plugin?
Yes. Geyser has a standalone mode that runs as its own proxy in front of your Java server, useful when you cannot or do not want to add it as a plugin. The plugin form is simpler for most single-server setups; standalone suits proxies and special hosting.
Features
- Bedrock to Java translation
- Skin conversion
- Form-based menus
- Resource pack support
- Custom skulls
- Emote forwarding
- Command suggestions
Commands
/geyser offhand/geyser dump/geyser reload/geyser versionPermissions
geyser.command.offhandgeyser.command.dumpgeyser.command.reload