How to Install Geyser on a Fabric Server (Bedrock + Java Cross-Play)

Updated for Geyser Fabric Compatibility (Minecraft 1.21.x)

Geyser allows Minecraft Bedrock Edition players to join Java Edition servers. With official Fabric support, you can now run Geyser directly on a Fabric server — no Paper, Spigot, or proxy required. This guide shows exactly how to install Geyser on a Fabric server using Serverwave, including required ports, configuration, and common pitfalls.

This tutorial works for:

• Minecraft Java Edition 1.21.x
• Fabric Loader (latest stable)
• Fabric API
• GeyserMC (Fabric version)
• Floodgate (optional, Fabric version)

Why Install Geyser on a Fabric Server?

Players search for this setup because it allows:

• Bedrock & Java cross-play on one server
• Friends on console or mobile to join Java servers
• No proxy required (Fabric native support)
• Works with performance/QoL Fabric mods
• Lower latency compared to proxy setups

If you want Bedrock players to join your Fabric server, Geyser is the solution.

How Geyser Works on Fabric (Important to Know)

• Fabric remains the main server
• Geyser translates Bedrock traffic → Java
• Bedrock players connect via a separate UDP port
• Gameplay-changing Fabric mods may not work correctly for Bedrock players

What You Need

Before starting, make sure you have:

• A running Fabric server on Serverwave
• Fabric API installed
• Extra UDP port enabled (for Bedrock players)
• Latest Geyser Fabric jar
• (Optional) Floodgate Fabric jar for Bedrock players without Java accounts

Step-by-Step: Install Geyser on a Fabric Server (Serverwave)

1. Stop Your Server

Completely stop your server and wait until it is fully powered down.

2. Upload Geyser (and Floodgate)

Using SFTP:

1. Connect to your server via SFTP
2. Navigate to the mods/ folder
3. Upload:

• • Geyser-Fabric.jar
  • Floodgate-Fabric.jar (optional but recommended)

3. Start Your Server

Start the server once to let Geyser generate its config files.

After startup, you should see logs mentioning:

[Geyser-Fabric] Loading Geyser...

Then stop the server again before configuring.

Configuring Geyser (Required)

5. Add a second port to your server

• Navigate to the Ports Allocation page in the sidebar.
• Click + Create port allocation
• Note the port that has been assigned

4. Edit the Geyser Config

Navigate to:

/config/Geyser-Fabric/config.yml

Key settings to verify:

bedrock:
  port: 19132
  address: 0.0.0.0

• Make sure the Bedrock port matches the UDP port that you just got assigned in Serverwave
• address: 0.0.0.0 is recommended

5. Floodgate Configuration (Optional)

If using Floodgate:

• Bedrock players can join without owning Java Edition
• Their usernames will be prefixed (default: .)

No extra setup needed in most cases.

Required Ports (Very Important)

For Geyser to work, you need two ports:

If Bedrock players cannot connect, this is usually the reason.

Start Your Server

Start the server again after configuration.

If successful, you’ll see:

Geyser started successfully

How Bedrock Players Connect

Bedrock players must:

1. Open Minecraft Bedrock Edition
2. Go to Servers → Add Server
3. Enter:

• • Server IP: your server IP
  • Port: Geyser UDP port (e.g. 19132)

Join the server 🎉

How to Confirm Geyser Is Working

On the server console:

/geyser version

If Bedrock players can join and move around, Geyser is installed correctly.

Common Problems & Fixes

❌ Bedrock players can’t connect

Most common causes:

• UDP port not opened
• Wrong port in config.yml
• Server restarted without stopping first

❌ Players can join but see invisible blocks

• Cause: Incompatible Fabric mods
• Fix: Remove gameplay-changing mods OR Stick to performance or server-side mods only

❌ “Outdated client” error

• Cause: Geyser not updated for latest Minecraft version
• Fix: Download the latest Geyser Fabric jar

❌ Floodgate players can’t use commands

• Fix: Adjust permissions, remember Floodgate players are not real Java UUIDs

Serverwave Tips for Fabric + Geyser

• Always back up before installing new mods
• Keep Fabric API updated
• Avoid client-side or content-heavy mods
• Test with one Bedrock account before opening publicly
• Performance mods like Lithium & Starlight work well

When NOT to Use Fabric + Geyser

Consider Paper + Geyser instead if you:

• Need plugins
• Use custom items or GUIs
• Want maximum Bedrock compatibility
• Run large public servers

Final Notes

Running Geyser on a Fabric server is a great solution for cross-play SMPs and small communities — as long as you keep the setup simple and compatible.

If you’re unsure whether your Fabric mods will work with Bedrock players, test first or ask before deploying publicly.

Updated on: 09/01/2026