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.

Installing Crossplay Plugin

1. Download Geyser from the official download page. Choose the Paper (Spigot) build if you're on Paper, or the Fabric / NeoForge build if you're on one of those.
   • On Fabric, download Fabric API as well.
2. Log in to the GhostCap Panel and Stop your Minecraft server.
3. Navigate to the File Manager.
4. Open the plugins folder if you're on Paper, or the mods folder if you're on Fabric or NeoForge.
5. Upload the Geyser .jar file (and Fabric API on Fabric) to that folder. For larger files, you can also use SFTP.
6. Start your server from the Console page.

The first start 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.

1. Log in to the GhostCap Panel and Stop your server.
2. Navigate to the File Manager.
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 an available non-primary port from Management > 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 the GhostCap Panel and copy your server IP from the Console 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

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. Download Floodgate from the official download page, choosing the same build type (Paper, Fabric or NeoForge) as your Geyser download.
2. Log in to the GhostCap Panel and Stop your server.
3. Navigate to the File Manager and upload the Floodgate .jar file to the same folder you put Geyser in.
4. Start your server so Floodgate generates its files.
5. Stop your server, go back to the File Manager, and open your Geyser config.yml again.
6. Set auth-type to floodgate, then save.
7. Start your server.

If you get stuck at any time, reach out to us on Discord.