What is GeyserMC?
GeyserMC is a proxy that translates Bedrock Edition packets to Java Edition packets, allowing Bedrock players (Windows 10/11, Xbox, PlayStation, Switch, Mobile) to join your Java Edition server. It works alongside Floodgate to handle Bedrock authentication, so Bedrock players don't need a Java account. Combined, they create seamless crossplay between all Minecraft platforms.
Downloading GeyserMC and Floodgate
Download the latest Geyser-Spigot.jar from the official GeyserMC website or their Jenkins CI. Download Floodgate alongside it — Floodgate handles Bedrock player authentication so they don't need Java accounts. Drop both .jar files into your server's /plugins folder via the file manager or SFTP. Restart your server and both plugins will generate their default config files.
Configuring GeyserMC
Open plugins/Geyser-Spigot/config.yml in the file manager. Key settings: set 'bedrock.address' to your server IP, set 'bedrock.port' to 19132 (default Bedrock port), set 'remote.auth-type' to 'floodgate' so Bedrock players can join without Java accounts. If you use a custom domain, update 'bedrock.address' to your domain. Save the config and restart the server.
Setting Up Floodgate
Floodgate generates a key file on first run — this is used to authenticate Bedrock players. In plugins/Floodgate/config.yml, set 'username-prefix' to '.' or '*' so Bedrock player names are distinguishable (e.g., '.Steve' vs 'Steve'). This prevents name conflicts between Java and Bedrock accounts. Make sure your permissions plugin (LuckPerms) doesn't block prefixed usernames.
Testing Crossplay
Open Minecraft Bedrock Edition, go to Servers > Add Server, enter your Java server IP and port 19132. If everything is configured correctly, you'll connect to the same world as Java players. Test that both Java and Bedrock players can see each other, chat works, and inventories sync. Check the Geyser console for any conversion errors if items or blocks appear incorrectly.
Common Issues and Fixes
Players getting 'Unable to connect to world': Check that port 19132 is open on your firewall and that Geyser is bound to the correct IP. Bedrock players can't break blocks: Update Geyser to the latest build — block breaking bugs are fixed in newer versions. Floodgate prefix not showing: Verify Floodgate is installed and the key.pem file exists in the Floodgate folder. Large worlds not loading: Increase view-distance and simulation-distance in Geyser config.
FAQ
Related Tutorials
From the Blog
Was this guide helpful?
Join our Discord for more guides and direct help from our engineering team.