mirror of
https://github.com/GeyserMC/Geyser.git
synced 2024-08-14 23:57:35 +00:00
52 lines
3 KiB
Markdown
52 lines
3 KiB
Markdown
<img src="https://geysermc.org/img/geyser-1760-860.png" alt="Geyser" width="600"/>
|
|
|
|
[](LICENSE)
|
|
[](https://discord.gg/geysermc)
|
|
[](https://translate.geysermc.org/)
|
|
|
|
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](https://cubecraft.net).
|
|
|
|
## 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.20.80 - 1.21.3 and Minecraft Java Server 1.21. For more info please see [here](https://geysermc.org/wiki/geyser/supported-versions/).
|
|
|
|
## Setting Up
|
|
Take a look [here](https://geysermc.org/wiki/geyser/setup/) 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` port `25565` for Java and `19132` 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](https://geysermc.org/wiki/geyser/current-limitations/) page.
|
|
|
|
## Compiling
|
|
1. Clone the repo to your computer
|
|
2. 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.
|
|
3. Run `gradlew build` and locate to `bootstrap/build` folder.
|
|
|
|
## Contributing
|
|
Any contributions are appreciated. Please feel free to reach out to us on [Discord](https://discord.gg/geysermc) if
|
|
you're interested in helping out with Geyser.
|
|
|
|
## Libraries Used:
|
|
- [Adventure Text Library](https://github.com/KyoriPowered/adventure)
|
|
- [CloudburstMC Bedrock Protocol Library](https://github.com/CloudburstMC/Protocol)
|
|
- [GeyserMC's Java Protocol Library](https://github.com/GeyserMC/MCProtocolLib)
|
|
- [TerminalConsoleAppender](https://github.com/Minecrell/TerminalConsoleAppender)
|
|
- [Simple Logging Facade for Java (slf4j)](https://github.com/qos-ch/slf4j)
|