Plugin Minecraft Geyser-Spigot

🔌 Informacje o Geyser-Spigot

Geyser-Spigot to wersja Geyser na platformę Spigot/Paper: translator protokołów, który umożliwia klientom Minecraft: Bedrock Edition łączenie się z serwerem Java Edition poprzez uruchomienie Geyser jako wtyczki po stronie serwera. Działa wewnątrz plików JAR zgodnych ze Spigot i udostępnia listener Bedrock, który tłumaczy ruch protokołu Bedrock na ruch protokołu Java dla serwera hosta.

🎯 Cel

Zapewnić obsługę crossplay, aby właściciele serwerów mogli przyjmować graczy Bedrock na serwerze Java bez potrzeby uruchamiania osobnego procesu proxy. Rozwiązuje to podstawowy problem niezgodności protokołów między edycjami Bedrock i Java.

⚙️ Funkcje

• Działa jako wtyczka Spigot/Paper (umieść plik JAR w plugins/ i uruchom ponownie).
• Tłumaczy ruch protokołu Bedrock na protokół Java, dzięki czemu klienci Bedrock mogą dołączać do serwerów Java.
• Tworzy konfigurację per serwer (folder wtyczki i plik konfiguracyjny są tworzone w plugins/Geyser-Spigot).
• Oficjalnie zalecany do używania razem z Floodgate do uwierzytelniania Bedrock, gdy chcesz, aby gracze Bedrock dołączali bez uwierzytelniania kontem Java.
• Wspierany i utrzymywany jako część projektu GeyserMC (źródła są dostępne w repozytorium projektu).

🧩 Dla kogo

• Dla właścicieli serwerów, którzy chcą crossplay Java/Bedrock na jednym backendzie Spigot lub Paper.
• Dla małych i dużych serwerów Survival, SMP oraz społecznościowych, które potrzebują zgodności z klientami Bedrock.
• Dla administratorów, którzy wolą uruchamiać Geyser jako wtyczkę zamiast osobnego proxy standalone.

🏗️ Przykładowe zastosowania

• Umożliwienie graczom z telefonu i konsoli (Bedrock) dołączania do serwera Java Spigot/Paper bez uruchamiania osobnego serwera proxy.
• Prowadzenie publicznego serwera SMP, który obsługuje zarówno klientów Java, jak i Bedrock, przy zachowaniu całej logiki gry na tym samym backendzie.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR Geyser-Spigot dla platformy Spigot/Paper.
• Umieść plik Geyser-Spigot.jar w katalogu plugins/ swojego serwera.
• Uruchom lub zrestartuj serwer i sprawdź logi serwera, aby potwierdzić, że wtyczka została włączona i utworzyła swój folder.

📦 Zależności

• Floodgate (opcjonalnie): zalecany, gdy chcesz, aby gracze Bedrock uwierzytelniali się/dołączali bez uwierzytelniania kontem Java; Floodgate jest wskazywany jako typowy dodatek do Geyser.

🧾 Konfiguracja

• Geyser-Spigot tworzy katalog konfiguracji w plugins/Geyser-Spigot oraz główny plik konfiguracyjny, w którym ustawiane są listenery, zdalne ustawienia serwera Java i inne opcje. W razie potrzeby edytuj te pliki i zrestartuj serwer, aby zastosować zmiany.

🧠 Uwagi techniczne

• Potwierdzone obsługiwane platformy serwerowe: Spigot i Paper.
• Udokumentowano obsługę nowoczesnych wersji serwera od 1.16.5 wzwyż podczas używania jako wtyczki Spigot/Paper.
• Kod źródłowy i śledzenie zgłoszeń są utrzymywane w repozytorium projektu GeyserMC.
• Licencja: MIT License.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli musisz przyjmować graczy Bedrock na istniejącym serwerze Java Spigot/Paper bez uruchamiania osobnego procesu proxy, Geyser-Spigot zapewnia utrzymywaną, serwerową warstwę tłumaczenia protokołu, która utrzymuje łączność Bedrock na tym samym backendzie co gracze Java.