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

|| ✅ Best results: vanilla or lightly-modded Fabric servers || ❌ Avoid heavy custom blocks, items, or GUIs ---

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

| We recommend downloading all jars from: | 👉 https://jarvault.serverwave.com/

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) * || Need help connecting? || See our guide: How to Use SFTP on Serverwave

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: | Purpose | Protocol | | ---- | | Java server | TCP | | Bedrock (Geyser) | UDP | 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. ---