Geyser tłumaczy połączenie klienta Bedrock na protokół serwera Java, a Floodgate pozwala graczowi Bedrock wejść bez posiadania płatnego konta Java. Do działania potrzebujesz poprawnej wersji pluginów, osobnego portu UDP i testu wykonanego spoza sieci serwera.
Najważniejsze konkrety
- Geyser
- Warstwa zgodności przyjmująca Bedrock i tłumacząca ruch do serwera Java.
- Floodgate
- Dodatek do Geyser, który uwierzytelnia konta Bedrock bez wymagania zakupionej Java Edition.
- Port
- Bedrock korzysta z UDP; standardowy punkt startowy to 0.0.0.0:19132, o ile hosting przydzielił ten port.
- Test
- W konsoli uruchom geyser connectiontest <publiczny-adres> <port> i wykonaj próbę z zewnętrznej sieci.
Co robią Geyser i Floodgate?
Serwer Paper mówi protokołem Java Edition, a telefon lub konsola używa Bedrock Edition. Geyser działa między nimi: przyjmuje ruch Bedrock, tłumaczy pakiety i przedstawia gracza serwerowi jak klienta Java. Nie łączy jednak automatycznie dwóch osobnych kont ani nie przenosi danych między istniejącymi profilami.
Floodgate rozszerza Geyser o uwierzytelnienie kont Bedrock bez wymagania zakupionej Java Edition. Gracz nadal potrzebuje konta Xbox/Microsoft. Floodgate nadaje mu własną tożsamość i może używać prefiksu w nazwie, dlatego whitelistę oraz integracje sklepu trzeba testować właśnie na koncie Bedrock.
| Architektura | Gdzie instalować Geyser | Gdzie instalować Floodgate |
|---|---|---|
| Jeden serwer Paper | W plugins na Paper | W plugins na tym samym Paper |
| Sieć Velocity/BungeeCord | Tylko na proxy | Na proxy; backendy tylko gdy potrzebują API lub pełnej obsługi danych/skór |
| Fabric/NeoForge | Wersja moda dla danego loadera | Wersja Floodgate zgodna z platformą; Fabric wymaga też Fabric API |
Instalacja Geyser i Floodgate na Paper
- Zatrzymaj serwer i wykonaj backup konfiguracji oraz danych graczy.
- Pobierz Geyser-Spigot i Floodgate-Spigot z oficjalnej strony GeyserMC.
- Umieść oba pliki JAR w katalogu
plugins. - Uruchom serwer pełnym restartem. Nie używaj
/reload. - Sprawdź
logs/latest.log. Oba pluginy mają zakończyć start bez błędu wersji lub zajętego portu.
Po pierwszym starcie Geyser utworzy katalog konfiguracji. Nazwa ścieżki zależy od platformy, ale na Paper znajdziesz ją w plugins/Geyser-Spigot/ albo analogicznym katalogu wskazanym w logu.
Port Bedrock i auth-type
Minimalny fragment konfiguracji dla jednego serwera wygląda następująco. Zachowaj wcięcia YAML i użyj portu faktycznie przydzielonego przez hosting:
bedrock:
address: 0.0.0.0
port: 19132
clone-remote-port: false
remote:
auth-type: floodgateaddress: 0.0.0.0 pozwala nasłuchiwać na dostępnych interfejsach. port jest portem podawanym graczom Bedrock. Ten ruch korzysta z UDP, nawet jeśli Java działa na TCP 25565. Jeżeli hosting przydzielił port 32041, wpisujesz 32041 - nie zmieniasz go na 19132 tylko dlatego, że jest domyślny.
clone-remote-port: true nadpisuje port Bedrock portem zdalnego serwera Java przy każdym starcie. Używaj tej opcji wyłącznie wtedy, gdy wymaga jej hosting. Geyser nie może współdzielić tego samego portu UDP z voice chatem lub Query.
Firewall, publiczny adres i test z zewnątrz
W panelu hostingu przydziel port UDP, a w zaporze VPS otwórz dokładnie ten numer dla UDP. Reguła TCP nie wystarczy. Następnie uruchom w konsoli:
geyser connectiontest twoj-adres.pl 19132Zastąp adres i port publicznymi danymi gracza. Test wskaże typowe problemy z osiągalnością. Ostateczna próba powinna odbyć się z telefonu w sieci komórkowej albo z innej sieci Wi‑Fi, ponieważ połączenie lokalne nie weryfikuje przekierowania portu i zewnętrznej zapory.
Java: adres i ewentualny port TCP serwera. Bedrock: publiczny adres oraz osobny port UDP Geyser. Umieść oba zestawy w profilu serwera i nie każ graczom zgadywać, który port jest właściwy.
Velocity lub BungeeCord
W sieci z proxy Geyser instaluj na proxy, a nie na każdym backendzie. Floodgate również może działać tylko na proxy. Instalacja Floodgate na backendach jest potrzebna wtedy, gdy pluginy backendu korzystają z Floodgate API lub chcesz pełniejszej obsługi danych i skór.
Przekazywanie danych gracza skonfiguruj według dokumentacji używanego proxy. Jeżeli kopiujesz key.pem między proxy i backendami, traktuj go jak hasło: nie umieszczaj w publicznym repozytorium, zgłoszeniu ani archiwum udostępnianym osobom trzecim. Dokumentacja Floodgate ostrzega, że przejęcie klucza pozwala podszyć się pod uwierzytelnienie graczy Bedrock.
Pluginy, whitelist i ograniczenia Bedrock
Geyser emuluje klienta Java, ale interfejs i sterowanie Bedrock są inne. Przetestuj menu ekwipunku, książki, niestandardowe przedmioty, resource pack, antycheat, komendy z nazwami graczy i sklep. Mody wymagające instalacji po stronie klienta Java nie zadziałają automatycznie na Bedrock.
Do whitelisty graczy Floodgate użyj przeznaczonej komendy zamiast ręcznego zgadywania prefiksu:
/fwhitelist add NazwaGraczaW zależności od konfiguracji Floodgate nazwy mogą mieć prefiks, a spacje są zastępowane podkreśleniami. Sprawdź też, czy sklep i plugin kar rejestrują właściwy UUID. Jeżeli włączasz łączenie kont Java i Bedrock, najpierw opisz graczom, które konto zachowuje ekwipunek i postęp.
Najczęstsze błędy Geyser - kolejność diagnozy
Sprawdź po kolei
- Plugin nie wystartował: sprawdź latest.log, zgodność wersji i konflikt portu.
- Zły transport: port Bedrock musi być otwarty dla UDP, nie tylko TCP.
- Zły port: porównaj config, panel hostingu, firewall i adres wpisany w telefonie.
- Port jest nadpisywany: sprawdź clone-remote-port po restarcie.
- Błąd logowania: potwierdź auth-type=floodgate, działający Floodgate i aktualny key.pem.
- Niekompatybilna wersja: zaktualizuj Geyser i sprawdź, czy backend akceptuje wersję Java emulowaną przez bieżące wydanie.
- Whitelist: dodaj konto przez fwhitelist i użyj rzeczywistej nazwy Floodgate.
Aktualne kroki instalacji znajdziesz w dokumentacji Geyser, a ustawienie uwierzytelniania w instrukcji Floodgate. Po udanym teście oznacz profil jako Java + Bedrock i wpisz osobno oba adresy połączenia.
Plan działania krok po kroku
- 1
Pobierz wersje Geyser i Floodgate przeznaczone dla Paper/Spigot, włóż JAR-y do plugins i wykonaj pełny restart.
- 2
Ustaw port Bedrock UDP, pozostaw address=0.0.0.0 i zmień remote.auth-type na floodgate.
- 3
Otwórz dokładnie ten port w panelu i zaporze dla UDP, a następnie sprawdź go komendą geyser connectiontest.
- 4
Połącz się z Bedrock przez publiczny adres, sprawdź whitelistę, ekwipunek, skiny, komendy i pluginy przed publikacją adresu.