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 fixes this by translating Bedrock connections into Java. This guide shows you how to install and set up Geyser on your Minecraft server.

Note

Geyser runs on Paper, Fabric and NeoForge. It doesn't run on Vanilla or Forge, so switch with our changing version guide first.

The Fabric and NeoForge builds of Geyser only support the latest Minecraft version. Fabric also needs Fabric API installed alongside Geyser.

Caution

Bedrock players can't install mods. On a modded server, any mod that needs a client install (custom items, blocks, dimensions or UI) can stop them from joining. Stick to server-side mods.

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 creates Geyser's config.yml. The file won't exist until then.

Configuring Crossplay Plugin

Bedrock players need their own port, separate from your Java port. Bedrock uses this port over TCP and UDP, so it can't be shared with anything else, such as Voice Chat or Query.

From Minecraft Bedrock 26.60, Bedrock players only connect over NetherNet, so Geyser must have NetherNet turned on. That needs a recent Geyser: if your config.yml has no transport line, update Geyser from the Installed tab in Mods and restart your server once first.

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 ports are listed as Network Allocations under Advanced in Settings. Don't use your primary port for Geyser. Java players connect on that one.

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
Set transport to nethernet.
7
Under signaling, then builtin, set advertise-addresses to your server IP from the Overview page, in quotes and square brackets. Use only the part before the colon :, without the port.
8
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
  transport: nethernet
  signaling:
    mode: builtin
    builtin:
      advertise-addresses: ["111.123.144.15"]

Note

Without advertise-addresses, Geyser sends Bedrock players your server's internal address, and they can't join. Leave the other settings under signaling as they are.

Connecting Bedrock Players to Your Server

Bedrock players add your server by hand. They use your server IP with the Bedrock port from config.yml, not 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

The first time a player joins, Minecraft asks them to trust your server. That's expected: tell them to accept it.

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 every Bedrock player also needs a paid Java Edition account. Install Floodgate to let them join with just their Bedrock account.

1
Log in to Bropanel and select your Minecraft server.
2
Install Floodgate:
- Fabric or NeoForge: go to Mods, open the Browse tab, select Mods, then search for Floodgate and install it.
- Paper: download the Spigot build of Floodgate from the GeyserMC download page. Go to Files, open the /plugins folder, then click Upload and select the .jar file.
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.