GeyserMC Setup Guide: Bridge Java & Bedrock in 2026
Cross-play is the future of Minecraft. Learn how to set up GeyserMC and Floodgate on your 1.21/26.1 server for seamless connectivity.
Reading time: 2 min read
GeyserMC Setup Guide: Bridge Java & Bedrock in 2026
If you're running a Minecraft server in 2026, limiting your player base to only Java Edition can slow your growth. GeyserMC is the industry-standard bridge that allows Bedrock Edition players (Xbox, PlayStation, Mobile, Switch) to join your Java Edition server with zero lag.
In this guide, we'll walk you through the setup for version 1.21 and the newest 26.1 releases.
1. Prerequisites
- A Java Server: Paper, LeafMC, or Spigot is recommended.
- Dedicated Port: Bedrock typically uses UDP port
19132. Ensure this is open in your server's firewall. - Java 25: If you are running version 26.1, ensure your server is using the newest Java 25 runtime.
2. Installing GeyserMC and Floodgate
- Download the latest Geyser-Spigot.jar and Floodgate-Spigot.jar from the official GeyserMC website.
- Place both files into your server's
pluginsfolder. - Restart your server to generate the configuration files.
3. Configuring Floodgate (The Authentication Bridge)
Floodgate allows Bedrock players to join without needing to own a Java Edition account.
- Open
/plugins/floodgate/config.yml. - Key Configuration: Ensure
auth-type: floodgateis set. This handles the account linking automatically.
4. Configuring Geyser (The Gateway)
Open /plugins/Geyser-Spigot/config.yml:
- remote: This should point to your Java server IP (usually
127.0.0.1and port25565). - bedrock:
address:0.0.0.0(to listen on all interfaces).port:19132(the standard Bedrock port).clone-remote-port: Set tofalseunless your server uses a specific non-standard port for both.
5. Testing the Connection
- From Bedrock: Go to Servers > Add Server. Enter your server's IP and port
19132. - Troubleshooting: If Bedrock players can't connect, check if your server firewall allows UDP traffic on port
19132. Standard Minecraft (Java) only uses TCP.
26.1 Update Note: With the 26.1 "Tiny Takeover" update, ensure you have the absolute latest version of Geyser. Mojang's new world storage and entity data (baby mob models) require a Geyser update to render correctly for Bedrock players.
Related Server Guides:
- How to Join Custom Bedrock Servers
- Ultimate Minecraft Configuration Guide
- Java 25 Server Requirements
- Promoting Your Server with ShyamPractice Setup
Related posts
How to Allocate More RAM to Minecraft
If your Minecraft is stuttering or crashing, it might be running out of memory. Learn how to allocate more RAM in the Java Edition launcher.
Best Minecraft Server Monitoring Tools for 2026
Keep your server online and your community happy. Discover the top monitoring tools to track TPS, lag, and uptime in the 1.21/26.1 era.
How to Change Your Skin in Minecraft
Express yourself with a custom skin. Learn how to update your character's look in Java Edition and Bedrock Edition.
