GeyserMC Tutorial: How to Connect Mobile Players to Your Java Server in 2026

Your friend on an iPhone wants to join your Java survival server. Without GeyserMC, that is impossible — two completely different protocols. With GeyserMC properly configured, they connect seamlessly to the same world your PC players live in. This guide walks you through the full setup.

What You Need Before Starting

• A Paper or Spigot server running Minecraft 1.20.4+ (latest recommended)
• Server admin access (FTP or panel)
• Ports 19132 (UDP) open on your hosting firewall
• Basic familiarity with the plugins folder

Step 1: Download the Right Files

Download two plugins:

1. GeyserMC — the protocol translation engine: geysermc.org
2. Floodgate — allows Bedrock players to join without a Java account: same site

Download the Paper/Spigot versions of both. Place both .jar files in your server's /plugins folder.

Step 2: Start and Stop the Server Once

Start your server, let it fully boot, then stop it. This generates the default configuration files for both GeyserMC and Floodgate in /plugins/Geyser-Spigot/ and /plugins/floodgate/.

Step 3: Configure Geyser

Open /plugins/Geyser-Spigot/config.yml. The key settings:

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

remote:
  address: auto
  port: 25565
  auth-type: floodgate

auth-type: floodgate
allow-third-party-capes: true
show-cooldown: title

The auth-type: floodgate setting is critical — it tells Geyser to use Floodgate for Bedrock player authentication so they do not need a Java account.

Step 4: Configure Floodgate

Open /plugins/floodgate/config.yml:

key-file-name: key.pem
disconnect:
  invalid-key: true
player-link:
  enabled: true
  use-global-linking: true

Global linking allows Bedrock players to link their Xbox/PSN account to a Java account optionally, preserving their inventory and stats across sessions.

Step 5: Open Port 19132 UDP

In your Space-Node panel (or firewall settings), ensure that port 19132 UDP is open. This is the port Bedrock clients use. Java players continue using 25565. The two protocols run on different ports simultaneously.

Step 6: Test the Connection

1. Start your server
2. On a Bedrock device, go to Servers → Add Server
3. Enter your server IP, port 19132
4. Connect

Bedrock players will have a prefix on their name (default: .) to distinguish them from Java players. This can be changed in Floodgate's config.

Common Issues and Fixes

Bedrock players spawn at the wrong location: Add a spawn plugin like EssentialsX that handles the spawn point universally.

Inventory desync on Bedrock: Some UI elements in Java plugins (advanced GUIs) do not display on Bedrock clients. Chest-based menu systems work — action bar GUIs often don't.

Players can't connect on mobile: Check that your ISP/host has UDP 19132 open, not just TCP. Many firewall rules only open TCP by default.

Limitations to Know

GeyserMC translates the protocol but cannot bridge every feature gap. Java-only features like certain equipment models, custom fonts, and complex resource pack overlays won't display on Bedrock clients. For survival, creative, and most minigame experiences, however, the gap is virtually unnoticeable in 2026.

Space-Node makes GeyserMC setup trivially easy with one-click plugin installers through the game panel. If you run into configuration issues, our 12/7 support team has set up hundreds of cross-play servers.

Launch your cross-play Minecraft server on Space-Node