How to Allow Bedrock Players on a Java Server
Allow Bedrock players on your Java Minecraft server with Geyser & Floodgate: quick install, clone or UDP port setup, and troubleshooting tips.
Minecraft is best enjoyed with everyone, regardless of what device they play on. By default, Java Edition and Bedrock Edition players cannot play together. However, by installing the Geyser plugin, your server can translate network packets between the two versions, allowing Bedrock players on consoles, mobile, or Windows 10 to join your Java world seamlessly.
Additionally, we highly recommend installing Floodgate alongside Geyser. Floodgate bypasses the strict Microsoft Java account verification specifically for your Bedrock users, allowing them to connect directly using their Bedrock accounts.
Important Version Note: For maximum stability and compatibility, we recommend running your server on version 1.21.11. While newer versions might exist, they often experience connection issues for Bedrock clients. Geyser is available for Paper, Spigot, NeoForge, and Fabric.
Step 1: Install Geyser and Floodgate
First, you need to get the files onto your server.
Download the correct version of Geyser and Floodgate for your specific server software (Paper, Fabric, or NeoForge) from the official GeyserMC website. You can also install them directly through the Mods tab on your server panel if available. For Paper, you can go to this link to download the plugins.
Shut down your server by going to Actions > Shutdown. Make sure the server is not running to avoid files from being corrupted.
Log in to your server panel and navigate to your File Manager.
Upload both downloaded files to the appropriate directory:
For Paper / Spigot: Upload to the
Server/plugins/folder.For Fabric / NeoForge: Upload to the
Server/mods/folder.
Restart your server by going to Actions > Restart. This initial boot allows the server to load the files and generate the necessary configuration folders.
Step 2: Configure the Network Ports
Java and Bedrock editions use different default ports to connect. To make Geyser work, you must configure how the server handles these incoming Bedrock connections. You have two methods:
Method A: Clone the Java Port (Recommended & Easiest)
This method tells Geyser to use the exact same port as your main Java server, making it incredibly easy for players to join.
Open your File Manager and locate the newly generated Geyser config file:
Paper:
Server/plugins/Geyser-Spigot/config.ymlFabric:
Server/config/Geyser-Fabric/config.ymlNeoForge:
Server/config/Geyser-NeoForge/config.yml
Open
config.ymland find the line that saysclone-remote-port: false. Changefalsetotrue.
In this clip, I have already set the clone-remote-port to true. Save the file and restart the server by going to Actions > Restart. Bedrock players can now join using your standard server IP and port!
Method B: Add a Custom UDP Port (For Mod Conflicts)
If you run mods that already require the main Java port (such as Simple Voice Chat or certain proxy setups), cloning the port might cause conflicts. Instead, you must allocate a dedicated UDP port for Bedrock players.
Need Help? If you are unable to generate a custom port through the panel, please contact our support staff and request them to open an additional UDP port for your server.
Troubleshooting & Tips
Players Cannot Connect: Double-check that your server is running 1.21.11 and that your Geyser and Floodgate versions match your server type perfectly.
Account Errors: If Bedrock players are being asked to log into a Java account, your Floodgate installation failed to load. Check your server console for any Floodgate error messages during startup.
Conclusion
With Geyser and Floodgate successfully configured, the barrier between Java and Bedrock is officially gone. Your community can now grow faster than ever, allowing friends on mobile devices and consoles to build right alongside your PC veterans.
If you encounter any issues or require assistance opening a custom UDP port, feel free to contact our support team!