Minecraft-Plugin Geyser-Spigot

🔌 Über Geyser-Spigot

Geyser-Spigot ist die Spigot/Paper-Plattformversion von Geyser: ein Protokoll-Übersetzer, der es Clients von Minecraft: Bedrock Edition ermöglicht, sich mit einem Java Edition-Server zu verbinden, indem Geyser als serverseitiges Plugin ausgeführt wird. Es läuft innerhalb von mit Spigot kompatiblen Server-JARs und stellt einen Bedrock-Listener bereit, der den Bedrock-Protokollverkehr in Java-Protokollverkehr für den Hostserver übersetzt.

🎯 Zweck

Bereitstellung von Crossplay, damit Serverbesitzer Bedrock-Spieler auf einem Java-Server akzeptieren können, ohne einen separaten Proxy-Prozess zu benötigen. Dadurch wird das Kernproblem der Protokollinkompatibilität zwischen Bedrock- und Java-Editionen gelöst.

⚙️ Funktionen

• Läuft als Spigot/Paper-Plugin (JAR in plugins/ ablegen und neu starten).
• Übersetzt Bedrock-Protokollverkehr in Java-Protokoll, damit Bedrock-Clients Java-Server betreten können.
• Erstellt serverbezogene Konfigurationen (Plugin-Ordner und Konfigurationsdatei werden unter plugins/Geyser-Spigot angelegt).
• Offiziell empfohlen in Kombination mit Floodgate für die Bedrock-Authentifizierung, wenn Bedrock-Spieler ohne Java-Konto-Authentifizierung beitreten sollen.
• Wird als Teil des GeyserMC-Projekts unterstützt und gepflegt (der Quellcode ist im Projekt-Repository verfügbar).

🧩 Für wen es gedacht ist

• Serverbesitzer, die Java/Bedrock-Crossplay auf einem einzelnen Spigot- oder Paper-Backend möchten.
• Kleine bis große Survival-, SMP- und Community-Server, die Bedrock-Client-Kompatibilität benötigen.
• Administratoren, die Geyser lieber als Plugin statt als separaten Standalone-Proxy betreiben.

🏗️ Beispielanwendungsfälle

• Mobil- und Konsolenspielern (Bedrock) erlauben, einem Spigot/Paper-Java-Server beizutreten, ohne einen separaten Proxy-Server zu betreiben.
• Einen öffentlichen SMP-Server betreiben, der sowohl Java- als auch Bedrock-Clients akzeptiert, während die gesamte Spiellogik auf demselben Backend bleibt.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Geyser-Spigot-JAR für die Spigot/Paper-Plattform herunter.
• Lege die Datei Geyser-Spigot.jar in das Verzeichnis plugins/ deines Servers.
• Starte den Server oder starte ihn neu und prüfe die Server-Logs, um zu bestätigen, dass das Plugin aktiviert wurde und seinen Ordner erstellt hat.

📦 Abhängigkeiten

• Floodgate (optional): empfohlen, wenn Bedrock-Spieler sich ohne Java-Konto-Authentifizierung anmelden/beitreten sollen; Floodgate gilt als der übliche Begleiter von Geyser.

🧾 Konfiguration

• Geyser-Spigot erstellt ein Konfigurationsverzeichnis unter plugins/Geyser-Spigot und eine Haupt-Konfigurationsdatei, in der Listener, Einstellungen für den entfernten Java-Server und weitere Optionen festgelegt werden. Bearbeite diese Dateien bei Bedarf und starte den Server neu, um die Änderungen anzuwenden.

🧠 Technische Hinweise

• Bestätigt unterstützte Serverplattformen: Spigot und Paper.
• Dokumentiert für die Unterstützung moderner Serverversionen ab 1.16.5 aufwärts, wenn es als Spigot/Paper-Plugin verwendet wird.
• Quellcode und Issue-Tracking werden im Repository des GeyserMC-Projekts gepflegt.
• Veröffentlicht unter der MIT License.

🤝 Wann dieses Plugin nützlich ist

Wenn du Bedrock-Spieler auf einem vorhandenen Spigot/Paper-Java-Server akzeptieren musst, ohne einen separaten Proxy-Prozess zu betreiben, bietet Geyser-Spigot eine gepflegte serverseitige Protokoll-Übersetzungsschicht, die die Bedrock-Verbindung auf demselben Backend wie die Java-Spieler hält.