search

bundabrg / GeyserReversion

Multiversion Protocol Support for Geyser
MIT License
76 stars 12 forks source link

readme

Logo

MIT license GitHub release GitHub commits Github all releases

Workflow Maintenance GitHub contributors GitHub issues Average time to resolve an issue GitHub pull-requests

Documentation

Source Code

PLEASE NOTE: As of 20/07/2022 this project is no longer being maintained as the extension interface was not accepted upstream and it was too hard to maintain updates. I will be working on a proxy that will sit in front of a bedrock server (be it Geyser or vanilla) and provide the same translation of versions and a plugin interface. I'll update this notification once I have something up.

GeyserReversion is a Geyser Extension that provides protocol level support for MultiVersion in Geyser and will eventually allow any supported version to connect to any supported Geyser.

If you've heard of ViaVersion then this is the equivalent but for the Bedrock side of Geyser. It allows any of the supported client versions listed below to connect to any of the supported server versions.

Features

Client Versions Supported

Minecraft Bedrock

Minecraft Education

Server Versions Supported

Quick Start

  1. Make sure you are running a build of Geyser that supports native extensions. You can find a prebuilt one here.

  2. Down the latest GeyserReversion and place it inside your Geyser extensions folder. Note this is a folder 'extensions' underneath your Geyser folder. If you are running a plugin version of Geyser (Spigot/Bungeecord/Velocity) then make sure to place it inside the plugins/Geyser/extensions folder. Standalone version of Geyser will be a extensions folder where your Geyser.jar file is located.

  3. Start Geyser. It should show some indication that GeyserReversion is running. For example:

[11:08:37 INFO] {GeyserReversion} EducationServer listening on /0.0.0.0:19133
[11:08:37 DEBUG] {GeyserReversion} Registered Translator: Translator_v390ee_to_v408be
  1. If using education you will need to generate a token for each tenancy that you support otherwise you'll get a "School not allowed" error. See education docs for more info

Donations

As this is an open source project it is free to use and free to modify. If you do wish to donate then you may use the following link with all funds going into my "Evening Fund".

The Evening Fund is a fund I (bundabrg) have set up for all my open source projects. Anything sent there will be used to help others. I appreciate your contribution, and I thank you for giving me the ability to bring some happiness to others as well.