What crossplay does
Your server is a Java server. Crossplay lets Bedrock players on phone, console and Windows 10/11 join that same server and play with you, with nothing extra to set up.
We install Geyser and Floodgate for you and keep them updated on every start. All you do is turn on one switch.
Turn it on
In the Settings tab, turn on Let Bedrock players in and save. The server restarts right away, and the first start takes a moment while the files download.
On Fabric we also install Fabric API with them, because Geyser and Floodgate refuse to load without it. You'll see it in the Mods tab. Leave it there, and keep it even if you turn crossplay off, because other mods use it too.
If a download fails, your server still starts without crossplay and prints a warning line in the console. We never block a start on a download.
The address Bedrock players use
Java players join with the address you already know:
your server address appears here
Bedrock players use the same IP but the Bedrock port. The Bedrock address appears on your server page next to the Java one once crossplay is on. While it's off, or on a Vanilla or Forge server, nothing is listening on that port, so we don't show it. Then, inside the game:
- Open Play, then Servers
- Scroll down and tap Add Server
- Give it any name, then put the IP in Server Address
- Put the Bedrock port in Port
- Join and play
Bedrock player names
A Bedrock player's name on your server starts with a dot, and spaces become _. So a player called Gamer Tag joins as .Gamer_Tag.
The dot is deliberate: it stops a Bedrock player from taking over a Java player's name.
On Paper and Purpur we turn their name check (perform-username-validation) off so the dot gets through. Otherwise, Bedrock players are kicked with "Failed to verify username".
op .Gamer_Tag kick .Gamer_Tag
Whitelist your friends
In the Players tab, type your friend's name and press Add player. For a Java player, type the name as it is. For a Bedrock player, type the gamertag with a dot in front and its spaces kept, and we convert them.
RAM
Crossplay runs an extra bridge inside the same server, and each Bedrock player costs more RAM. For a comfortable game, keep it at 2GB or more. On a 1GB server, expect lag.
Check whether joining works
Turning crossplay on doesn't guarantee that Bedrock responds. Watch the console for Geyser's startup line, and if a Bedrock player can't join, check the settings and the console. The versions Geyser supports are listed in its documentation at https://geysermc.org/wiki/geyser/supported-versions/.
Crossplay brings your friends into a Java world. For a native Bedrock world and its add-ons, choose a native Bedrock server.
Did this guide help you?
Improve this guide
Guides are open source. Found a fix or an addition? Open a pull request on github.com/serverkgg/minecraft-java