How to allow crossplay with Bedrock players
GeyserMC is a plugin that translates the Bedrock Edition protocol so that mobile, console, and Windows 10/11 players can join your Java server without any modifications on their end. Floodgate is a companion plugin that handles authentication for Bedrock players, allowing them to join without a Java Edition account.
GeyserMC requires a plugin-compatible server such as Paper, Spigot, or Purpur. It is not compatible with Vanilla, Forge, Fabric, or NeoForge servers.
Step 1
Bedrock players connect through a separate port from Java players. Before installing GeyserMC, go to the Network section in the left sidebar and create a new port allocation by clicking Create Allocation. Take note of the port number assigned — you will need it in the next steps.
For more details, see the guide on how to open a port.
Step 2
Go to the Templates section in the left sidebar. Under Plugin Setups, click on GeyserMC (Plugin) to open its configuration panel on the right.
Step 3
Configure the template options before installing:
- Bedrock Port — select the port you allocated in Step 1 from the dropdown.
- GeyserMC Type — select the type that matches your server (e.g., Spigot for Paper/Spigot/Purpur servers).
- Include Floodgate — keep this toggle enabled. Floodgate is required for Bedrock players to authenticate and join the server.
Once configured, click the Install Template button.
Step 4
A confirmation modal will appear warning that this may overwrite existing files. Click Yes, Install to proceed.
Step 5
A green notification will confirm the template was installed successfully. Restart your server from the Console tab. Once online, you should see a line in the console similar to:
[Geyser-Spigot] Started Geyser on UDP port XXXXThis confirms GeyserMC is running and ready to accept Bedrock connections.
Additional Notes:
- Bedrock players connect using your server's IP address and the Bedrock port (not the default Java port). Make sure to share the correct port with them.
- Java players continue connecting normally through the default port — nothing changes for them.
- If Bedrock players cannot connect, make sure the Bedrock port was correctly allocated and that GeyserMC loaded without errors in the console.
✅ That's it! Your server now supports crossplay between Java and Bedrock Edition players. If you have any problems, contact us via Discord (opens in a new tab) so we can help you.