geysermc/geyser

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

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

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

Things people build with this

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.

Tech stack

JavaGradleBungeeCordVelocityFabricPaper

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

In plain English

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?

Open on GitHub → Explain another repo

← geysermc on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.