Geyser
A bridge/proxy allowing you to connect to Minecraft: Java Edition servers with Minecraft: Bedrock Edition.
About this Mod
Geyser is a bridge between Minecraft: Bedrock Edition and Minecraft: Java Edition, closing the gap from those wanting to play true cross-platform.
Geyser is an Open Collaboration project.
What is Geyser?
Geyser is a proxy, bridging the gap between Minecraft: Bedrock Edition and Minecraft: Java Edition servers.
The ultimate goal of this project is to allow Minecraft: Bedrock Edition users to join Minecraft: Java Edition servers as seamlessly as possible. However, due to the nature of Geyser translating packets over the network of two different games, do not expect everything to work perfectly!
Special thanks to the DragonProxy project for being a trailblazer in protocol translation and for all the team members who have joined us here!
Supported Versions
| Edition | Supported Versions |
|---|---|
| Bedrock | 26.0, 26.1, 26.2, 26.3, 26.10, 26.20, 26.21, 26.22, 26.23, 26.30, 26.31, 26.32, 26.33 |
| Java | 26.2 (For older versions, see this guide) |
Setting Up
Take a look here for how to set up Geyser.
Links:
- Website: https://geysermc.org
- Docs: https://geysermc.org/wiki/geyser/
- Download: https://geysermc.org/download
- Discord: https://discord.gg/geysermc
- Donate: https://opencollective.com/geysermc
- Test Server:
test.geysermc.orgport25565for Java and19132for Bedrock
What's Left to be Added/Fixed
- Near-perfect movement (to the point where anticheat on large servers is unlikely to ban you)
- Some Entity Flags
What can't be fixed
There are a few things Geyser is unable to support due to various differences between Minecraft Bedrock and Java. For a list of these limitations, see the Current Limitations page.
Compiling
- Clone the repo to your computer
- Navigate to the Geyser root directory and run
git submodule update --init --recursive. This command downloads all the needed submodules for Geyser and is a crucial step in this process. - Run
gradlew buildand locate tobootstrap/buildfolder.
Contributing
Any contributions are appreciated. Please feel free to reach out to us on Discord if
you're interested in helping out with Geyser.
Libraries Used:
Available Versions
How to Install Geyser on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set bungeecord Loader
In the panel under "Egg", select the bungeecord loader and matching Minecraft version (26.2).
Install Mod
Open the mod browser in the dashboard and search for "Geyser". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.1.2, 26.1.1 (+31 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Geyser server crashes on startup – what to do?
Most common cause: wrong bungeecord version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.
Is Geyser compatible with bungeecord and fabric and neoforge and paper and spigot and velocity?
Geyser officially supports bungeecord, fabric, neoforge, paper, spigot, velocity for Minecraft 26.2, 26.1.2, 26.1.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Geyser – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Geyser consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
![[ETF] Entity Texture Features](https://cdn.modrinth.com/data/BVzZfTc1/af683d206d50b05258d865b0d6e4aa2f2cee12f2_96.webp){kind=small}
Rent Modded Server
Install Geyser with just one click on your server.