3LifeHosting.com

How to Set Up Geyser for Java and Bedrock Crossplay

Allow Bedrock Edition players to join your Java Minecraft server using Geyser and Floodgate.

How to Set Up Geyser for Java and Bedrock Crossplay

Geyser is a plugin that translates Bedrock Edition connections into Java Edition connections, letting both platforms play on the same server. No mods are needed on the client side.

Requirements

  • A Paper, Spigot, or Purpur server (Java Edition)
  • An available extra port for Bedrock connections (UDP port 19132 by default)

Step 1: Install Geyser

  1. Download Geyser-Spigot from Modrinth
  2. Upload the .jar to your server's plugins/ folder via the control panel file manager
  3. Restart the server

Geyser generates its config at plugins/Geyser-Spigot/config.yml.

Step 2: Configure the Bedrock Port

Open plugins/Geyser-Spigot/config.yml and find the bedrock section:

bedrock:
  address: 0.0.0.0
  port: 19132

Set port to an available port assigned to your server. Check the Network tab in the control panel for your allocated ports.

The remote section should point to your Java server:

remote:
  address: localhost
  port: 25565

Set port to your server's actual Java port (visible at the top of the panel).

Save the config and restart the server.

Step 3: Connect from Bedrock

Bedrock players connect by adding a server in the Servers tab:

  • Server Address: Your server's IP
  • Port: The Bedrock port you configured (e.g. 19132)

Optional: Install Floodgate

By default, Geyser requires Bedrock players to have a Java Edition account to authenticate. Floodgate removes this requirement, letting Bedrock players join with just their Xbox/Microsoft account.

  1. Download Floodgate from Modrinth
  2. Upload to plugins/ and restart
  3. Open plugins/Geyser-Spigot/config.yml and set:
auth-type: floodgate
  1. Restart the server

Bedrock players will appear in-game with a . prefix (e.g. .BedrockPlayer). This prefix is configurable in plugins/floodgate/config.yml.

Troubleshooting

Bedrock players can't connect

  • Confirm the Bedrock port is allocated in the Network tab of the panel
  • Verify bedrock.port in the Geyser config matches the allocated port
  • Check that the port is UDP, not just TCP

"Unable to connect to world" on Bedrock

  • The Geyser plugin may have failed to start. Check plugins/Geyser-Spigot/logs/ for errors
  • Ensure remote.port matches your actual Java server port

Bedrock players can connect but see missing blocks/items This is normal for newly added Java content that Geyser hasn't mapped yet. Update Geyser to the latest version for the best compatibility.

Skin issues Bedrock and Java use different skin systems. Geyser translates skins as best it can, but some custom Java skins may not display correctly on Bedrock clients.