gitwtfhub

wtf is geyser?

geysermc/geyser — explained in plain English

Analysis updated 2026-06-26

5,570JavaAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

Geyser is a bridge that lets Bedrock Edition Minecraft players join Java Edition servers by translating network traffic between the two incompatible game versions in real time.

Mindmap

mindmap
  root((repo))
    What it does
      Translates Bedrock to Java
      Real-time packet bridge
      Covers chat and inventory
    Deployment modes
      Standalone proxy
      BungeeCord plugin
      Velocity plugin
      Fabric or Paper mod
    Tech Stack
      Java
      Gradle
    Audience
      Server admins
      Minecraft hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run your Java Edition Minecraft server so Bedrock players on phones and consoles can join it.

REASON 2

Add cross-play support to an existing BungeeCord or Velocity network without migrating servers.

REASON 3

Deploy Geyser as a Fabric or Paper mod on your existing server to enable Bedrock connections.

REASON 4

Test cross-edition compatibility on a public test server before setting up your own.

What's in the stack?

JavaGradleBungeeCordVelocityFabricPaper

How it stacks up

geysermc/geysercaffeinemc/sodiumcinit/qauxiliary
Stars5,5705,5685,574
LanguageJavaJavaJava
Setup difficultymoderatemoderatehard
Complexity3/52/55/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a running Java Edition server and a compatible mod loader (Paper, Fabric, or BungeeCord/Velocity) to attach to.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Geyser is a Java project that acts as a bridge between two different versions of Minecraft: Bedrock Edition and Java Edition. These two versions of the game use completely different network protocols, which normally means players on Bedrock devices (such as phones, consoles, or Windows 10/11 using the Store version) cannot join Java Edition servers. Geyser translates the network traffic between them in real time, making it possible for Bedrock players to connect to Java Edition servers. The project works as a proxy: a Bedrock player connects to Geyser, and Geyser forwards that connection to a Java Edition server while translating all the packets in both directions. This covers movement, chat, inventory, world rendering, and entity behavior. Not everything can be translated perfectly, and the project documents its known limitations openly. Some features differ too much between the two editions to bridge reliably. Setup instructions and full documentation are on the project website rather than in this repository's README. A public test server is available at test.geysermc.org if you want to try it before setting up your own. Geyser can be deployed as a standalone proxy, as a plugin on BungeeCord or Velocity networks, or as a mod on Fabric or Paper servers. Compiling Geyser from source requires cloning the repository, initializing its submodules, and running the Gradle build tool. Pre-built downloads are available on the project website for those who do not want to compile. Geyser is an open-source community project maintained by the GeyserMC team and supported by contributors. It is free to use under the MIT license.

Yoink these prompts

Prompt 1
I want to let Bedrock players join my Java Minecraft server. How do I set up Geyser as a Paper plugin?
Prompt 2
Help me configure Geyser on a BungeeCord network so console and mobile players can connect to my Java Edition lobby.
Prompt 3
What are the known limitations of Geyser? Which Minecraft features do not translate perfectly between Bedrock and Java?
Prompt 4
How do I compile Geyser from source using Gradle and initialize its submodules?
Prompt 5
How do I deploy Geyser as a standalone proxy instead of a plugin?

Frequently asked questions

wtf is geyser?

Geyser is a bridge that lets Bedrock Edition Minecraft players join Java Edition servers by translating network traffic between the two incompatible game versions in real time.

What language is geyser written in?

Mainly Java. The stack also includes Java, Gradle, BungeeCord.

What license does geyser use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is geyser to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is geyser for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.