How to Enable Bedrock Crossplay on Your Minecraft Server

By default, Bedrock Edition players on mobile, console, and Windows can't join a Java Edition server. Geyser is a bridge that translates Bedrock connections into Java, enabling Bedrock players to join the server. This guide shows you how to install Geyser and set up the config on your Minecraft server.

Note

Geyser runs on Paper, Fabric and NeoForge. It does not run on Vanilla or Forge. If you're on one of those, use our changing version guide first.

The Fabric and NeoForge builds of Geyser only run on a 26.2 server. Fabric also needs Fabric API installed alongside Geyser.

Caution

If you're running a modded server, only server-side mods are supported. Bedrock players can't install mods, so any mod that requires a matching client install (custom items, blocks, dimensions or UI) won't work for them and can stop them from joining altogether.

Installing Crossplay Plugin

1
Log in to Bropanel and select your Minecraft server.
2
In the sidebar, go to Mods, then open the Browse tab.
3
Select Plugins if you're on Paper, or Mods if you're on Fabric or NeoForge.
4
Search for Geyser and install it.
- On Fabric, install Fabric API from the same browser as well.
5
Restart your server.

The first restart is what generates Geyser's config.yml. The file won't exist until your server has started with Geyser installed at least once.

Configuring Crossplay Plugin

Geyser needs its own port for Bedrock players to connect to, separate from the port your Java players use. Bedrock connects over UDP, and that port can't be shared with anything else that uses UDP, such as Voice Chat or Query. Each of those needs its own allocation.

Tip

A port is the number at the end of your IP address after the colon :.

For example, if your IP is 111.123.144.15:27033, 27033 is a port.

Your available ports can be seen under Advanced in Settings, listed as Network Allocations. Don't use your primary port for Geyser, as that's the one your Java players connect on.

1
Log in to Bropanel and Stop your server.
2
In the sidebar, go to Files.
3
Open your Geyser config folder and open config.yml:
- Paper: /plugins/Geyser-Spigot/config.yml
- Fabric: /config/Geyser-Fabric/config.yml
- NeoForge: /config/Geyser-NeoForge/config.yml
4
Under bedrock, set port to a spare port from your Network Allocations, and leave address as 0.0.0.0.
5
Set clone-remote-port to false so your chosen Bedrock port isn't overwritten on each start.
6
Save the file, then start your server.

Your bedrock section should look something like this:

bedrock:
  address: 0.0.0.0
  port: 27034
  clone-remote-port: false

Connecting Bedrock Players to Your Server

Bedrock players join by adding your server manually, using your server IP with the Bedrock port you set in config.yml rather than your Java port.

1
Log in to Bropanel and copy your server IP from the Overview page.
2
Open Minecraft Bedrock Edition and click Play.
3
Go to the Servers tab and select Add Server.
4
Enter any name you like, your server's IP address, and the Bedrock port you set in config.yml.
5
Save, then join your server.

Example: If your server IP is 111.123.144.15 and you set the Bedrock port to 27034, the menu should look like this:

Server Address: 111.123.144.15
Port: 27034

Console players can't add custom servers directly. See our guides for Xbox, PlayStation and Nintendo Switch players.

Letting Bedrock Players Join Without a Java Account

By default Geyser uses auth-type: online, which means every Bedrock player also needs to own a paid Java Edition account and link it. To let Bedrock players join with just their Bedrock account, install Floodgate alongside Geyser.

1
Log in to Bropanel and select your Minecraft server.
2
In the sidebar, go to Mods, open the Browse tab, and install Floodgate from the same tab you installed Geyser from.
3
Restart your server so Floodgate generates its files.
4
Stop your server, go to Files, and open your Geyser config.yml again.
5
Set auth-type to floodgate, then save.
6
Start your server.

Caution

Floodgate generates a key.pem file in its config folder. Don't share this file with anyone. It's what allows Bedrock accounts to authenticate on your server.

If you get stuck at any time, you can reach out to a bro on Discord.