GeyserMC Cross-Play Tutorial

GeyserMC is a proxy that translates Bedrock Edition network protocol into Java Edition protocol, allowing Bedrock players on mobile, console, and Windows 10/11 to join your Java server. Here's how to set it up properly.

What GeyserMC Actually Does

GeyserMC sits between your Java server and Bedrock clients. When a Bedrock player connects, Geyser translates their inputs and the server's responses in real time. Bedrock players see a Bedrock-style UI while interacting with the Java world.

It's not emulation - it's protocol translation. This means most gameplay works correctly, though some Java-specific features (custom model data, certain particle effects, complex book formatting) may not render identically on Bedrock clients.

Installation Methods

Method 1: Plugin (Recommended)

If you're running Paper, Spigot, or Purpur:

1. Download the latest GeyserMC plugin from geysermc.org
2. Place the .jar file in your server's plugins/ folder
3. Restart your server
4. Edit plugins/Geyser-Spigot/config.yml

Method 2: Standalone Proxy

If you're running Fabric, Forge, or want to keep Geyser separate:

1. Download the standalone version
2. Run it on the same machine or a separate one
3. Point it to your Java server's address and port

The plugin method is simpler and performs better since it runs in-process. Use standalone only if your server software doesn't support plugins.

Essential Configuration

Open config.yml and focus on these settings:

bedrock:
  address: 0.0.0.0
  port: 19132

remote:
  address: 127.0.0.1
  port: 25565

auth-type: online

• bedrock port: 19132 is Bedrock's default. Bedrock players will connect to your server IP on this port.
• remote address: Points to your Java server. Use 127.0.0.1 if running on the same machine.
• auth-type: online requires a Java account. floodgate lets Bedrock players join with just their Xbox/Microsoft account (recommended - requires Floodgate plugin).

Setting Up Floodgate

Floodgate is GeyserMC's companion plugin. Without it, Bedrock players need a Java account to join. With it, Bedrock players authenticate through their Microsoft/Xbox account.

1. Download Floodgate from geysermc.org
2. Place in your plugins/ folder
3. Restart the server
4. In GeyserMC's config.yml, set auth-type: floodgate

Bedrock players will appear in-game with a prefix (default *) before their username. You can change this in Floodgate's config.

Common Issues and Fixes

Bedrock players can't connect:

• Make sure port 19132 UDP is open in your firewall
• Check that your hosting provider allows custom UDP ports
• Verify the bedrock port in config.yml matches what players are connecting to

Players appear invisible to each other:

• Update GeyserMC and Floodgate to the latest builds
• This is usually a version mismatch issue

Textures look wrong for Bedrock players:

• Some Java resource packs can be converted. Use GeyserMC's resource pack converter
• Not all resource packs convert cleanly - custom models especially

Redstone and mechanics differ:

• Bedrock and Java have slightly different redstone behavior
• Quasi-connectivity doesn't exist in Bedrock - some contraptions won't translate
• This is a Minecraft limitation, not a Geyser bug

Performance Impact

GeyserMC adds modest overhead. For each connected Bedrock player, expect roughly:

• 50-100MB additional RAM
• Small CPU increase for protocol translation
• Negligible network overhead

On Space-Node's hosting plans, even the MC Gold plan (4GB RAM) can handle a mixed Java + Bedrock server with 15-20 concurrent players. For larger communities, MC Emerald (8GB) gives comfortable headroom.

Recommended Plugins for Mixed Servers

• Floodgate (essential): Xbox/Microsoft authentication for Bedrock players
• ViaVersion: Allows different Java versions to connect
• PlaceholderAPI: Bedrock player data in scoreboards and plugins
• BedrockFormAPI: Create native Bedrock UI forms from your plugins

Cross-play expands your server's reach to mobile and console players without sacrificing the Java plugin ecosystem. The setup takes 10-15 minutes and the ongoing maintenance is minimal - GeyserMC updates regularly to stay compatible with new Minecraft versions.