Repolode
Submit
GeyserMC

GeyserMC/Geyser

A proxy that lets Minecraft Bedrock Edition players join Minecraft Java Edition servers by translating network packets between the two editions.

View on GitHubWebsite
Stars
5,950
Forks
954
Open issues
328
Last commit
20 hours ago

What is it?

Geyser is a proxy that sits between Minecraft Bedrock Edition clients and Minecraft Java Edition servers. It translates the network protocol of one edition into the other, so Bedrock players, including those on consoles, mobile devices and Windows 10/11, can join Java servers without installing the Java client.

Because it translates packets between two different games, not every feature behaves identically. The project aims to make the experience as seamless as possible, but known gaps remain around movement handling and some entity flags, and a separate limitations page lists differences that cannot be fully bridged.

Geyser runs as a plugin on Spigot, Velocity, BungeeCord and Fabric servers, or as a standalone application. It supports the Bedrock and Java versions listed in its supported-versions table, and it is built with Java and Gradle.

Key features

  • 01Lets Bedrock Edition clients connect to Java Edition servers without the Java client.
  • 02Runs as a plugin on Spigot, Velocity, BungeeCord and Fabric, or as a standalone app.
  • 03Translates packets between the Bedrock and Java network protocols.
  • 04Publishes a supported-versions table that is updated per release.

Use cases

  • Letting console or mobile friends join a Java Edition server.
  • Running a cross-platform Minecraft server on a Velocity or BungeeCord network.
  • Hosting a Fabric or Spigot server that accepts Bedrock players.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/GeyserMC/Geyser.git
  2. 2

    Initialize the submodules from the Geyser root directory

    git submodule update --init --recursive
  3. 3

    Build Geyser with Gradle

    gradlew build
  4. 4

    Find the built files in the bootstrap/build folder

Things to know

  • The README warns that not everything works perfectly, since packets are translated between two different games.
  • Some known limitations exist, documented on the project's Current Limitations wiki page.
  • Movement and some entity flags are still unfinished according to the README.

Topics

#minecraft#proxy#protocol-translation#bedrock#java#game-server#bedrock-edition#bedrock-to-java#bungee#fabric

FAQ

What is Geyser?
A proxy that lets Minecraft Bedrock Edition players join Minecraft Java Edition servers by translating network packets between the two editions. Geyser is a proxy that sits between Minecraft Bedrock Edition clients and Minecraft Java Edition servers. It translates the network protocol of one edition into the other, so Bedrock players, including those on consoles, mobile devices and Windows 10/11, can join Java servers without installing the Java client.
Is Geyser free to use? What license does it have?
Geyser is open source under the MIT license. Check the license terms before using it in commercial products.
Is Geyser still maintained?
Actively maintained. The last commit to Geyser was on Nov 7, 2026.
What can I use Geyser for?
Letting console or mobile friends join a Java Edition server. Running a cross-platform Minecraft server on a Velocity or BungeeCord network. Hosting a Fabric or Spigot server that accepts Bedrock players.
How do I install Geyser?
Clone the repository: git clone https://github.com/GeyserMC/Geyser.git Initialize the submodules from the Geyser root directory: git submodule update --init --recursive Build Geyser with Gradle: gradlew build Find the built files in the bootstrap/build folder
Where can I get Geyser?
The source code and installation instructions are on GitHub: https://github.com/GeyserMC/Geyser

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects