hub / github.com/GeyserMC/Geyser
github.com/GeyserMC/Geyser @main
Chat with this repo
7,944 symbols
27,684 edges
1,302 files
1,828 documented · 23%
● updated 4d ago★ 5,752259 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Geyser is a bridge between Minecraft: Bedrock Edition and Minecraft: Java Edition, closing the gap from those wanting to play true cross-platform.
Geyser is an Open Collaboration project.
What is Geyser?
Geyser is a proxy, bridging the gap between Minecraft: Bedrock Edition and Minecraft: Java Edition servers. The ultimate goal of this project is to allow Minecraft: Bedrock Edition users to join Minecraft: Java Edition servers as seamlessly as possible. However, due to the nature of Geyser translating packets over the network of two different games, do not expect everything to work perfectly!
Special thanks to the DragonProxy project for being a trailblazer in protocol translation and for all the team members who have joined us here!
Supported Versions
| Edition | Supported Versions |
|---|---|
| Bedrock | 26.0, 26.1, 26.2, 26.3, 26.10, 26.20, 26.21, 26.22, 26.23, 26.30, 26.31, 26.32 |
| Java | 26.1 - 26.1.2 (For older versions, see this guide) |
Setting Up
Take a look here for how to set up Geyser.
Links:
- Website: https://geysermc.org
- Docs: https://geysermc.org/wiki/geyser/
- Download: https://geysermc.org/download
- Discord: https://discord.gg/geysermc
- Donate: https://opencollective.com/geysermc
- Test Server:
test.geysermc.orgport25565for Java and19132for Bedrock
What's Left to be Added/Fixed
- Near-perfect movement (to the point where anticheat on large servers is unlikely to ban you)
- Some Entity Flags
What can't be fixed
There are a few things Geyser is unable to support due to various differences between Minecraft Bedrock and Java. For a list of these limitations, see the Current Limitations page.
Compiling
- Clone the repo to your computer
- Navigate to the Geyser root directory and run
git submodule update --init --recursive. This command downloads all the needed submodules for Geyser and is a crucial step in this process. - Run
gradlew buildand locate tobootstrap/buildfolder.
Contributing
Any contributions are appreciated. Please feel free to reach out to us on Discord if you're interested in helping out with Geyser.
Libraries Used:
Extension points exported contracts — how you extend this code
RegistryLoader (Interface)
Represents a registry loader. I is the input value, which can be anything, but is commonly a file path or someth [24 implementers]
core/src/main/java/org/geysermc/geyser/registry/loader/RegistryLoader.java
JavaItemDataComponents (Interface)
Represents various Java item data components to the extent that these can be translated to custom items for Bedrock edit [27 …
api/src/main/java/org/geysermc/geyser/api/item/custom/v2/component/java/JavaItemDataComponents.java
GeyserModPlatform (Interface)
An interface which holds common methods that have different APIs on their respective mod platforms. [6 implementers]
bootstrap/mod/src/main/java/org/geysermc/geyser/platform/mod/platform/GeyserModPlatform.java
ItemData (Interface)
(no doc) [4 implementers]
common/src/main/java/org/geysermc/floodgate/news/data/ItemData.java
GeyserCommandSource (Interface)
Implemented on top of any class that can send a command. For example, it wraps around Spigot's CommandSender class. [7 …
core/src/main/java/org/geysermc/geyser/command/GeyserCommandSource.java
CommandExecutor (Interface)
Handles executing a command. @param the command source [20 implementers]
api/src/main/java/org/geysermc/geyser/api/command/CommandExecutor.java
browse all types & interfaces →
Core symbols most depended-on inside this repo
↓ 260 filesGeyserSession
core/src/main/java/org/geysermc/geyser/session/GeyserSession.java
↓ 204 filesGeyserDirtyMetadataA wrapper for temporarily storing entity metadata that will be sent to Bedrock.
core/src/main/java/org/geysermc/geyser/entity/GeyserDirtyMetadata.java
↓ 185 filesIRegistryRepresents a registry. @param the value being held by the registry
core/src/main/java/org/geysermc/geyser/registry/IRegistry.java
↓ 179 filesLevelEventTranslatorRepresents an event capable of translating itself into bedrock
core/src/main/java/org/geysermc/geyser/translator/level/event/LevelEventTranslator.java
↓ 176 filesSoundInteractionTranslatorHandler for playing sounds when right-clicking various objects. Due to Minecraft: Bedrock Edition expecting interaction sounds to …
core/src/main/java/org/geysermc/geyser/translator/sound/SoundInteractionTranslator.java
↓ 199 filesGeyserLoggercore/src/main/java/org/geysermc/geyser/GeyserLogger.java
Shape
Languages
Java100%
Modules by API surface
core/src/main/java/org/geysermc/geyser/session/GeyserSession.java129 symbols
core/src/main/java/org/geysermc/geyser/configuration/GeyserConfig.java77 symbols
core/src/main/java/org/geysermc/geyser/entity/type/Entity.java62 symbols
core/src/main/java/org/geysermc/geyser/entity/vehicle/VehicleComponent.java55 symbols
core/src/main/java/org/geysermc/geyser/entity/type/LivingEntity.java55 symbols
api/src/main/java/org/geysermc/geyser/api/item/custom/NonVanillaCustomItemData.java51 symbols
core/src/main/java/org/geysermc/geyser/item/GeyserNonVanillaCustomItemData.java50 symbols
core/src/main/java/org/geysermc/geyser/entity/type/player/SessionPlayerEntity.java46 symbols
core/src/main/java/org/geysermc/geyser/GeyserImpl.java40 symbols
core/src/main/java/org/geysermc/geyser/skin/SkinProvider.java39 symbols
core/src/main/java/org/geysermc/geyser/network/netty/ChannelWrapper.java36 symbols
core/src/main/java/org/geysermc/geyser/level/block/GeyserCustomBlockComponents.java35 symbols
For agents
$ claude mcp add Geyser \
-- python -m otcore.mcp_server <graph>