Geyser - Bridge Between Minecraft Versions

Geyser represents a unique solution that creates a bridge between the two main versions of Minecraft - Bedrock Edition and Java Edition. This project opens up the possibility for full cross-platform interaction between players on different platforms.

Main Concept

Geyser functions as a special proxy server that converts data between Minecraft: Bedrock Edition and Java Edition protocols. The main development goal is to ensure the smoothest possible connection for Bedrock Edition users to Java Edition servers. However, it's important to understand that due to fundamental differences between the two game versions, some features may not work perfectly.

Supported Versions

Currently, Geyser supports Minecraft Bedrock versions 1.21.90 - 1.21.110 and Minecraft Java versions 1.21.7 - 1.21.8.

Current Development Tasks

• Improving movement systems to minimize conflicts with anti-cheat on large servers
• Refining some entity flags

Technical Limitations

There are certain aspects that cannot be implemented due to architectural differences between Bedrock and Java versions of Minecraft.

Building from Source Code

1. Clone the repository to your computer
2. Navigate to the Geyser root directory and execute the command git submodule update --init --recursive to download necessary submodules
3. Run gradlew build and find the compiled files in the bootstrap/build folder

Participation in Development

We welcome any assistance in project development. If you want to contribute to Geyser development, contact us.

Used Libraries

• Adventure Text Library
• CloudburstMC Bedrock Protocol Library
• GeyserMC's Java Protocol Library
• TerminalConsoleAppender
• Simple Logging Facade for Java (slf4j)