Minecraft plugin Geyser-Spigot

🔌 O Geyser-Spigot

Geyser-Spigot je sestavení platformy Spigot/Paper pro Geyser: překladač protokolů, který umožňuje klientům Minecraft: Bedrock Edition připojit se k serveru Java Edition tím, že Geyser běží jako plugin na straně serveru. Běží uvnitř serverových JAR souborů kompatibilních se Spigotem a poskytuje Bedrock listener, který převádí provoz protokolu Bedrock na provoz protokolu Java pro hostitelský server.

🎯 Účel

Poskytnout možnost crossplay, aby vlastníci serverů mohli přijímat hráče Bedrock na serveru Java bez potřeby samostatného proxy procesu. To řeší hlavní problém nekompatibility protokolů mezi edicemi Bedrock a Java.

⚙️ Funkce

• Běží jako plugin Spigot/Paper (umístěte JAR do plugins/ a restartujte).
• Překládá provoz protokolu Bedrock do protokolu Java, takže klienti Bedrock se mohou připojit k serverům Java.
• Vytváří konfiguraci pro každý server (složka pluginu a konfigurační soubor jsou vytvořeny v plugins/Geyser-Spigot).
• Oficiálně se doporučuje spárovat s Floodgate pro ověřování Bedrock, když chcete, aby se hráči Bedrock připojovali bez ověřování pomocí účtu Java.
• Je podporován a udržován jako součást projektu GeyserMC (zdroj je dostupný v repozitáři projektu).

🧩 Pro koho to je

• Vlastníci serverů, kteří chtějí crossplay Java/Bedrock na jednom backendu Spigot nebo Paper.
• Malé až velké Survival, SMP a komunitní servery, které potřebují kompatibilitu s klienty Bedrock.
• Administrátoři, kteří dávají přednost spuštění Geyser jako pluginu místo samostatného standalone proxy.

🏗️ Příklady použití

• Umožnit hráčům na mobilu a konzolích (Bedrock) připojit se na Java server Spigot/Paper bez spuštění samostatného proxy serveru.
• Provozovat veřejný SMP server, který přijímá klienty Java i Bedrock, zatímco veškerá herní logika zůstává na stejném backendu.

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR Geyser-Spigot pro platformu Spigot/Paper.
• Umístěte soubor Geyser-Spigot.jar do adresáře plugins/ vašeho serveru.
• Spusťte nebo restartujte server a zkontrolujte serverové logy, abyste potvrdili, že byl plugin povolen a vytvořil svou složku.

📦 Závislosti

• Floodgate (volitelné): doporučeno, když chcete, aby se hráči Bedrock ověřovali/připojovali bez ověření pomocí účtu Java; Floodgate je uváděn jako běžný doplněk ke Geyser.

🧾 Konfigurace

• Geyser-Spigot vytváří konfigurační adresář v plugins/Geyser-Spigot a hlavní konfigurační soubor, kde se nastavují listenery, vzdálené nastavení Java serveru a další možnosti. Tyto soubory podle potřeby upravte a server restartujte, aby se změny projevily.

🧠 Technické poznámky

• Potvrzené podporované serverové platformy: Spigot a Paper.
• Dokumentováno, že jako plugin Spigot/Paper podporuje moderní verze serverů od 1.16.5 výše.
• Zdrojový kód a sledování problémů jsou spravovány v repozitáři projektu GeyserMC v rámci zdrojového repozitáře projektu.
• Licencováno pod MIT License.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete přijímat hráče Bedrock na stávajícím serveru Java Spigot/Paper bez spuštění samostatného proxy procesu, Geyser-Spigot poskytuje udržovanou server-side vrstvu pro překlad protokolů, která udržuje připojení Bedrock na stejném backendu jako hráče Java.