Before installing a plugin, use the official website to confirm that the plugin supports your server software and Minecraft version.
What is Geyser?
Protocol bridge that allows Minecraft Bedrock clients to connect to Java Edition servers. MSH lists it as a mainstream option in Network & Cross-Version , but the official project documentation remains the source of truth for exact builds, dependencies and current compatibility.
| Developer / maintainer | GeyserMC |
|---|---|
| Category | Network & Cross-Version |
| Pricing | Free |
| Typical platform | Paper-family servers |
| Primary use | Protocol bridge that allows Minecraft Bedrock clients to connect to Java Edition servers. |
What it is good at
- Bedrock-to-Java protocol translation
- Proxy and standalone deployment options
- Works with Floodgate for Bedrock identity/account workflows
What types of servers should consider it?
- Java servers that want Bedrock players to join
- Networks serving console/mobile/Windows Bedrock communities
Pricing and distribution
The plugin is distributed as a free option. Check the official page for the current download source and license.
Do not install duplicate Geyser instances throughout a proxy network. Geyser handles Bedrock protocol translation; Floodgate is an optional companion for Bedrock account authentication, not an alternative to Geyser.
What to check before using it
- Java and Bedrock mechanics/UI are not identical. Test plugins, custom items and anti-cheat behavior with real Bedrock clients.
Also check the plugin's current dependency list, migration notes and supported server versions on the official page before changing a production server.
Common questions
What does Geyser do?
Protocol bridge that allows Minecraft Bedrock clients to connect to Java Edition servers.
Is Geyser a plugin or a mod?
Geyser is listed here because it is used as a server plugin in its supported plugin environment. Some projects also publish builds for other platforms; use the official download page to choose the correct platform build.
Do players need to install it?
Most server plugins run server-side and do not require players to install the same JAR. Features that rely on resource packs, Bedrock bridges or optional client integrations can still change what the player must download or accept.
How do I install it?
Choose a supported deployment: Geyser-Spigot on a compatible standalone Paper/Spigot server, or Geyser-Velocity/Bungee on the proxy for a network. Follow the official setup guide for the correct JAR and config path. Bedrock players connect using a UDP port; check firewall and host allocations, and use the documented geyser connectiontest diagnostic.
How do I know the plugin loaded?
Read the Geyser startup log on the component where it was installed. Confirm the Bedrock UDP port is reachable externally and test a Bedrock client connection; Paper’s /plugins on a backend cannot verify a proxy installation.
What if it does not load?
Read the first relevant error in logs/latest.log. Common causes include the wrong server/Minecraft version, missing dependencies, the wrong platform build, duplicate JARs, unsupported Java or a broken configuration. Use the MSH Plugin Failed to Load fix for a structured diagnosis.
For general plugin installation, read How to Install Plugins on a Minecraft Server. To understand the plugin lifecycle and how plugins differ from mods, read How Minecraft Server Plugins Work. If the plugin refuses to load, use Plugin Failed to Load.
Alternatives
References
Plugin versions, pricing and platform support can change. These project pages were used as the primary references for this overview.
Related MSH pages
Help us improve this article
Tell us what is missing, unclear, outdated, or incorrect. You can also suggest something we should add.