GeyserMC/Geyser
Geyser
Geyser is a cross-platform bridge that translates network packets between Minecraft Bedrock Edition and Java Edition, enabling Bedrock clients to join Java Edition servers. It operates as either a server plugin or a standalone proxy, handling real-time protocol translation, authentication, and resource pack conversion to make Bedrock players appear as standard Java clients to the server.
The project distinguishes itself through its comprehensive authentication system, which allows Xbox Live-authenticated Bedrock players to join Java servers without requiring a paid Java Edition account, including support for online mode servers via a hybrid plugin. It maintains a global player identity cache that links Bedrock XUIDs to Java accounts, provides a REST API for player lookup and server status queries, and includes a resource pack conversion engine that transforms Java Edition resource packs and mod item mappings into Bedrock-compatible format. The proxy architecture supports multi-server routing, version emulation to bridge protocol differences, and a plugin system for extending functionality without per-platform modifications.
Additional capabilities include skin texture translation for correct cross-platform display, Bedrock-specific form sending for server plugins, movement compatibility workarounds, and cosmetic extensions through resource packs. The project also offers connectivity testing, port configuration, and deployment options ranging from local network access to mobile deployment on Android via Termux.
Features
- Cross-Platform Server Bridges - Connects Bedrock Edition clients to Java Edition servers by translating network protocols and handling authentication differences.
- Protocol Translation Bridges - Translates network packets between Bedrock and Java Edition protocols in real-time to enable cross-platform connections.
- Game - Installs as a server plugin or standalone proxy to add Bedrock client support to existing Java Edition servers.
- Plugin or Standalone Modes - Operates as a server plugin or a standalone proxy, giving server owners flexible deployment options.
- Remote Server Connections - Points the proxy to a Java Edition server by configuring its address and port in the remote section.
- Direct Bedrock Connections - Allows Bedrock players to connect directly to a server without needing a separate proxy setup.
- Resource Pack Distribution - Translates Java Edition resource packs into a format usable by Bedrock Edition clients.
- Cross-Platform Resource Pack Converters - Converts Java Edition resource packs and mod item mappings into Bedrock-compatible format for client-side use.
- Java-to-Bedrock Resource Pack Conversion - Transforms Java Edition resource packs into Bedrock Edition format for client-side use.
- Cross-Platform Skin Display - Shows Bedrock player skins on Java Edition clients so they appear correctly in the game world.
- Game - Converts game packets between Bedrock and Java Edition protocols to enable cross-platform multiplayer.
- Game - Emulates specific Java Edition client versions to bridge version differences between Bedrock and Java servers.
- Game Proxy Architectures - Operates as an independent proxy process that forwards Bedrock connections to configured Java servers with optional GUI support.
- Game Protocol Bridges - Translates network packets between Bedrock and Java editions so clients on either platform play together.
- Game Proxies - Launches a separate proxy process that forwards players to a configured Java server with GUI and console startup.
- Protocol Translation - Translates network packets between Minecraft Bedrock and Java editions for cross-platform play.
- Game Server Proxies - Routes Bedrock clients through a standalone proxy to connect to multiple Java Edition servers with consistent authentication.
- Floodgate Authentication Forwarding - Forwards Floodgate authentication data through a proxy to maintain consistent player identity across backend servers.
- Cross-Platform Player Authentications - Authenticates Xbox Live-verified Bedrock players on Java Edition servers without requiring a paid Java account.
- Cross-Server Secret Key Sharing - Shares a generated key file between proxy and backend servers to enable cross-server Floodgate authentication.
- Game - Authenticates Xbox Live-authenticated Bedrock players on Java Edition servers without requiring a Java Edition account.
- Hybrid Mode - Authenticates Bedrock players on Java servers through a hybrid plugin that handles Xbox Live authentication without Java accounts.
- Bedrock Client Authenticators - Authenticates Minecraft Bedrock Edition clients so they can join Java Edition servers without needing a paid Java Edition account.
- Floodgate Authenticators - Switches authentication from Java Edition to Floodgate so Bedrock clients can join without a Java account.
- Account Linking - Links a Bedrock player's identity to a Java Edition account through global or local linking mechanisms.
- Java-Free Bedrock Authenticators - Authenticates Bedrock Edition players on a Java Edition server without requiring a Java Edition account by handling authentication through a hybrid mode plugin.
- Hybrid Online Mode Authentication - Uses a hybrid plugin to authenticate Bedrock connections on Java servers that require online mode verification.
- Cross-Server Identity Caches - Maintains a centralized cache linking Bedrock XUIDs to Java accounts for cross-server player identification.
- Xbox Live Authenticators for Java Servers - Authenticates Xbox Live-authenticated Bedrock players on a Java server without requiring a separate Java Edition account.
- Game Version Emulations - Emulates a specific Java Edition client version to bridge version differences between Bedrock and Java servers.
- Server Command Extensions - Provides built-in commands with permission nodes for controlling server runtime behavior.
- Bedrock Client Connections - Provides a companion mod that enables Bedrock clients to connect to modded Java servers.
- Bedrock-to-Modded Server Connections - Connects Bedrock players to modded Java Edition servers using a companion mod for compatibility.
- Platform Extension Plugins - Loads platform-agnostic plugins that add custom features without requiring per-platform modifications.
- Bedrock Compatibility Workarounds - Applies server-side workarounds to resolve compatibility issues for Bedrock players on Java servers.
- Cross-Platform Compatibility Patches - Applies server-side fixes and resource pack patches to resolve gameplay incompatibilities for Bedrock players on Java servers.
- Java Edition Feature Emulation - Applies a Bedrock resource pack that adds Java Edition features like armor stand poses and offhand animations.
- Bedrock Resource Pack Patches - Uses an included Bedrock resource pack to add features like custom armor poses and offhand animations.
- Mod-Based Resource Pack Generation - Creates item mappings and Bedrock resource packs from Java Edition mods for custom item support.
- Resource Pack Conflict Resolution - Merges overlapping entity definitions when server resource packs conflict with integrated pack changes.
- Cross-Platform Skin Texture Converters - Transforms Bedrock player skins into Java Edition texture format for correct display across both game versions.
- Game Server Routing - Routes Bedrock players to different Java Edition servers through a single proxy.
- Command Permission Nodes - Manages server runtime behavior through built-in commands with configurable permission nodes for access control.
- Player Identity Services - Links Bedrock gamertags to Java Edition accounts and looks up player data across servers via a global API.
- Bedrock - Ships a system for server plugins to send Bedrock-specific UI forms to players for custom interactions.
