How to Set Up Geyser on Your Minecraft Server

What is Geyser

Geyser is a Minecraft plugin that allows Minecraft: Bedrock Edition clients to join Minecraft: Java Edition servers, allowing for true crossplay between both editions of the game.

How to Enable Crossplay

The panel installs Geyser for you. First, open your Minecraft server's web panel.

1. 1Click Versions in the sidebar.
2. 2In the Bedrock Crossplay box, click Enable. The panel installs Geyser and Floodgate, plus ViaVersion if your server runs an older Minecraft version than Geyser supports.

1. 3Restart your server.

Bedrock players join with the address and port shown in the Bedrock Crossplay box. The Console page shows the same Bedrock address.

Manual Setup

If enabling crossplay in the panel fails, you can set Geyser up yourself. Bedrock players connect over NetherNet, which uses the Bedrock port over both TCP and UDP, so Geyser needs its own port instead of sharing the Java one.

1. 1Click Network in the sidebar, then click Add. The port of the new allocation is your Bedrock port.
2. 2Install Geyser and Floodgate from the Plugins page on Paper or Purpur, or from the Mods page on Fabric or NeoForge. On Paper or Purpur, also install ViaVersion if your server runs an older Minecraft version than Geyser supports.
3. 3Restart your server so Geyser creates its config, then stop the server.
4. 4In Files, open Geyser's config: plugins/Geyser-Spigot/config.yml on Paper or Purpur, config/Geyser-Fabric/config.yml on Fabric, or config/Geyser-NeoForge/config.yml on NeoForge.
5. 5In the bedrock section, set these values:

bedrock:
  port: 25601
  transport: nethernet
  signaling:
    builtin:
      advertise-addresses:
        - 203.0.113.10

Replace 25601 with your Bedrock port and 203.0.113.10 with your server's public IP address.

1. 6Start your server. Bedrock players join with your server address and the Bedrock port.