whatisgithub

What is geyser?

geysermc/geyser — explained in plain English

Analysis updated 2026-06-26

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

In one sentence

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

JavaGradleBungeeCordVelocityFabricPaper

How does it compare?

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 get it running?

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.

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.