Minecraft plugin Geyser-Spigot

🔌 About Geyser-Spigot

Geyser-Spigot is the Spigot/Paper platform build of Geyser: a protocol translator that allows Minecraft: Bedrock Edition clients to connect to a Java Edition server by running Geyser as a server-side plugin. It runs inside Spigot-compatible server jars and presents a Bedrock listener that translates Bedrock protocol traffic into Java protocol traffic for the host server.

🎯 Purpose

Provide crossplay capability so server owners can accept Bedrock players on a Java server without requiring a separate proxy process. This addresses the core problem of protocol incompatibility between Bedrock and Java editions.

⚙️ Features

• Runs as a Spigot/Paper plugin (place the JAR in plugins/ and restart).
• Translates Bedrock protocol traffic to Java protocol so Bedrock clients can join Java servers.
• Produces per-server configuration (plugin folder and config file are created under plugins/Geyser-Spigot).
• Officially recommended to pair with Floodgate for Bedrock authentication when you want Bedrock players to join without Java account authentication.
• Supported and maintained as part of the GeyserMC project (source available in the project repository).

🧩 Who It Is For

• Server owners who want Java/Bedrock crossplay on a single Spigot or Paper backend.
• Small to large Survival, SMP, and community servers that need Bedrock client compatibility.
• Administrators who prefer running Geyser as a plugin instead of a separate standalone proxy.

🏗️ Example Use Cases

• Allow mobile and console players (Bedrock) to join a Spigot/Paper Java server without running a separate proxy server.
• Run a public SMP server that accepts both Java and Bedrock clients while keeping all game logic on the same backend.

⚙️ Installation

📥 Setup

• Download the official Geyser-Spigot JAR for the Spigot/Paper platform.
• Place the Geyser-Spigot.jar file into your server's plugins/ directory.
• Start or restart the server and check server logs to confirm the plugin enabled and created its folder.

📦 Dependencies

• Floodgate (optional): recommended when you want Bedrock players to authenticate/join without Java account authentication; Floodgate is listed as the common companion for Geyser.

🧾 Configuration

• Geyser-Spigot creates a configuration directory under plugins/Geyser-Spigot and a main config file where listeners, remote Java server settings, and other options are set. Edit those files as needed and restart the server to apply changes.

🧠 Technical Notes

• Confirmed supported server platforms: Spigot and Paper.
• Documented to support modern server versions from 1.16.5 and above when used as the Spigot/Paper plugin.
• Source code and issue tracking are maintained in the GeyserMC project repository under the project's source repository.
• Licensed under the MIT License.

🤝 When This Plugin Is Useful

If you need to accept Bedrock players on an existing Spigot/Paper Java server without running a separate proxy process, Geyser-Spigot provides a maintained, server-side protocol translation layer that keeps Bedrock connectivity on the same backend as Java players.