Geyser
A bridge/proxy allowing you to connect to Minecraft: Java Edition servers with Minecraft: Bedrock Edition.
Top Related Projects
The modern, next-generation Minecraft server proxy.
BungeeCord, the 6th in a generation of server portal suites. Efficiently proxies and maintains connections and transport between multiple Minecraft servers.
Custom server software for Minecraft: Bedrock, built from scratch in PHP, C and C++
Quick Overview
Geyser is an open-source project that enables Minecraft: Bedrock Edition players to join Minecraft: Java Edition servers. It acts as a bridge between the two versions, translating game protocols and allowing cross-platform play without requiring players to own both editions of the game.
Pros
- Enables cross-platform play between Bedrock and Java editions
- Supports a wide range of Minecraft versions
- Actively maintained with frequent updates
- Large and supportive community
Cons
- Some features may not translate perfectly between editions
- Performance can be impacted, especially on larger servers
- Occasional compatibility issues with certain plugins or mods
- Requires additional setup and maintenance for server administrators
Getting Started
To set up Geyser on your Java Edition server:
- Download the latest Geyser-Spigot.jar from the releases page.
- Place the jar file in your server's plugins folder.
- Restart your server.
- Configure Geyser by editing the
config.yml
file in theplugins/Geyser-Spigot
folder. - Restart your server again to apply changes.
Bedrock players can now connect to your server using the server's IP address and port (default: 19132).
For more detailed instructions and advanced configurations, refer to the official Geyser documentation.
Competitor Comparisons
The modern, next-generation Minecraft server proxy.
Pros of Velocity
- Designed specifically for proxying Minecraft servers, offering optimized performance
- Supports multiple backend servers, allowing for load balancing and seamless server switching
- Extensive plugin API for customization and additional features
Cons of Velocity
- Limited to Java Edition servers, lacking cross-platform support
- Requires additional setup and configuration compared to standalone servers
- May introduce slight latency due to the proxy layer
Code Comparison
Velocity (Java):
@Subscribe
public void onProxyInitialization(ProxyInitializeEvent event) {
logger.info("Velocity plugin initialized!");
}
Geyser (Java):
@Override
public void onEnable() {
this.getLogger().info("Geyser plugin enabled!");
}
While both projects use Java, their code structures differ due to their distinct purposes. Velocity focuses on proxying and server management, while Geyser emphasizes cross-platform compatibility between Bedrock and Java editions.
Velocity excels in managing multiple Java servers, offering advanced proxying features. Geyser, on the other hand, bridges the gap between Bedrock and Java editions, allowing cross-platform play. The choice between them depends on specific server requirements and whether cross-platform support is needed.
BungeeCord, the 6th in a generation of server portal suites. Efficiently proxies and maintains connections and transport between multiple Minecraft servers.
Pros of BungeeCord
- Mature and widely adopted proxy solution for Minecraft servers
- Supports a wide range of Minecraft versions
- Extensive plugin ecosystem for customization
Cons of BungeeCord
- Limited to Java Edition servers only
- Requires more setup and configuration compared to Geyser
- May have performance overhead for large server networks
Code Comparison
BungeeCord (Java):
@EventHandler
public void onServerConnect(ServerConnectEvent event) {
ProxiedPlayer player = event.getPlayer();
ServerInfo target = event.getTarget();
// Handle server connection logic
}
Geyser (Java):
@Subscribe
public void onBedrockClientConnect(BedrockClientConnectEvent event) {
BedrockClientSession session = event.getSession();
// Handle Bedrock client connection logic
}
Both projects use event-driven architectures, but Geyser focuses on Bedrock client connections while BungeeCord handles Java Edition server connections. Geyser's codebase is more specialized for cross-platform compatibility, while BungeeCord provides a broader proxy solution for Java Edition servers.
Custom server software for Minecraft: Bedrock, built from scratch in PHP, C and C++
Pros of PocketMine-MP
- Designed specifically for Minecraft: Bedrock Edition, offering better performance and compatibility
- Extensive plugin ecosystem tailored for Bedrock servers
- More customizable and flexible for Bedrock-specific features
Cons of PocketMine-MP
- Limited cross-platform compatibility, primarily focused on Bedrock Edition
- May require more setup and configuration compared to Geyser's proxy approach
Code Comparison
PocketMine-MP (PHP):
$this->getServer()->getPluginManager()->registerEvents($this, $this);
$this->getScheduler()->scheduleRepeatingTask(new ClosureTask(
function (): void {
$this->getServer()->broadcastMessage("Hello, world!");
}
), 20 * 60);
Geyser (Java):
@Subscribe
public void onServerStart(GeyserStartEvent event) {
GeyserImpl.getInstance().getBootstrap().getGeyserLogger().info("Server started!");
GeyserImpl.getInstance().getBootstrap().getGeyserConfig().saveConfig();
}
The code snippets demonstrate different approaches to server management and event handling in their respective languages and frameworks.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME

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 by CubeCraft Games.
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
Geyser is currently supporting Minecraft Bedrock 1.21.70 - 1.21.93 and Minecraft Java 1.21.7. For more information, please see here.
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.org
port25565
for Java and19132
for 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 build
and locate tobootstrap/build
folder.
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:
Top Related Projects
The modern, next-generation Minecraft server proxy.
BungeeCord, the 6th in a generation of server portal suites. Efficiently proxies and maintains connections and transport between multiple Minecraft servers.
Custom server software for Minecraft: Bedrock, built from scratch in PHP, C and C++
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot