Geyser/README.md

61 lines
3.5 KiB
Markdown
Raw Normal View History

2020-06-20 19:40:12 +00:00
<img src="https://geysermc.org/img/geyser-1760-860.png" alt="Geyser" width="600"/>
2019-07-24 20:08:28 +00:00
2021-07-17 00:55:19 +00:00
[![forthebadge made-with-java](https://forthebadge.com/images/badges/made-with-java.svg)](https://java.com/)
2019-08-12 12:56:48 +00:00
2019-07-24 20:08:28 +00:00
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Build Status](https://ci.opencollab.dev/job/Geyser/job/master/badge/icon)](https://ci.opencollab.dev/job/GeyserMC/job/Geyser/job/master/)
2021-07-21 03:19:51 +00:00
[![Discord](https://img.shields.io/discord/613163671870242838.svg?color=%237289da&label=discord)](https://discord.gg/geysermc)
[![HitCount](http://hits.dwyl.com/Geyser/GeyserMC.svg)](http://hits.dwyl.com/Geyser/GeyserMC)
[![Crowdin](https://badges.crowdin.net/geyser/localized.svg)](https://translate.geysermc.org/)
2019-07-24 20:08:28 +00:00
Geyser is a bridge between Minecraft: Bedrock Edition and Minecraft: Java Edition, closing the gap from those wanting to play true cross-platform.
2019-07-08 18:04:39 +00:00
2020-05-13 22:53:13 +00:00
Geyser is an open collaboration project by [CubeCraft Games](https://cubecraft.net).
2019-07-08 18:04:39 +00:00
## What is Geyser?
2019-08-10 17:22:12 +00:00
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!*
2019-07-08 18:04:39 +00:00
Special thanks to the DragonProxy project for being a trailblazer in protocol translation and for all the team members who have joined us here!
2020-05-13 22:53:13 +00:00
2021-09-21 16:25:41 +00:00
### Currently supporting Minecraft Bedrock 1.17.10 - 1.17.30 and Minecraft Java 1.17.1.
2019-07-08 18:04:39 +00:00
2019-09-26 03:11:31 +00:00
## Setting Up
Take a look [here](https://github.com/GeyserMC/Geyser/wiki/Setup) for how to set up Geyser.
2019-12-22 16:09:23 +00:00
[![YouTube Video](https://img.youtube.com/vi/U7dZZ8w7Gi4/0.jpg)](https://www.youtube.com/watch?v=U7dZZ8w7Gi4)
2019-09-26 03:11:31 +00:00
2019-12-22 16:09:23 +00:00
## Links:
2019-07-31 22:48:16 +00:00
- Website: https://geysermc.org
2019-09-29 17:00:00 +00:00
- Docs: https://github.com/GeyserMC/Geyser/wiki
- Download: https://ci.geysermc.org
- Discord: https://discord.gg/geysermc
- Donate: https://opencollective.com/geysermc
- Test Server: `test.geysermc.org` port `25565` for Java and `19132` for Bedrock
2019-07-08 18:04:39 +00:00
2019-12-22 16:09:23 +00:00
## What's Left to be Added/Fixed
2020-12-12 06:46:29 +00:00
- Near-perfect movement (to the point where anticheat on large servers is unlikely to ban you)
- Resource pack conversion/CustomModelData
2019-12-22 16:09:23 +00:00
- Some Entity Flags
2021-02-26 19:06:00 +00:00
- Structure block UI
2019-07-17 18:16:30 +00:00
## 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://github.com/GeyserMC/Geyser/wiki/Current-Limitations) page.
2019-07-08 18:04:39 +00:00
## Compiling
1. Clone the repo to your computer
2. [Install Maven](https://maven.apache.org/install.html)
3. 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.
2019-12-29 19:57:02 +00:00
4. Run `mvn clean install` and locate to the `target` folder.
2019-07-08 18:04:39 +00:00
## Contributing
2019-09-22 23:06:53 +00:00
Any contributions are appreciated. Please feel free to reach out to us on [Discord](http://discord.geysermc.org/) if
you're interested in helping out with Geyser.
2019-07-17 18:16:30 +00:00
## Libraries Used:
2021-06-01 19:51:01 +00:00
- [Adventure Text Library](https://github.com/KyoriPowered/adventure)
2019-07-17 18:16:30 +00:00
- [NukkitX Bedrock Protocol Library](https://github.com/NukkitX/Protocol)
- [Steveice10's Java Protocol Library](https://github.com/Steveice10/MCProtocolLib)
- [TerminalConsoleAppender](https://github.com/Minecrell/TerminalConsoleAppender)
- [Simple Logging Facade for Java (slf4j)](https://github.com/qos-ch/slf4j)