GeyserMC: Jak wpuścić graczy z telefonów (Bedrock) na serwer Java?

Gracz korzystający z telefonu uruchamia Minecraft Bedrock, a serwer oparty na Paperze, Spigocie lub czystej Javie oczekuje połączenia z Minecraft Java Edition. To dwa różne protokoły, więc samo podanie adresu serwera Java w aplikacji mobilnej nie wystarczy. Potrzebny jest tłumacz ruchu sieciowego, którym najczęściej jest GeyserMC. ^[3]

Geyser pozwala przekazać połączenie Bedrock do serwera Java i przełożyć je na format rozumiany przez Minecraft Java Edition. W przypadku graczy z telefonów dochodzi jeszcze kwestia logowania. Można wymagać od nich posiadania konta Java, ale zwykle wygodniejszym rozwiązaniem jest Floodgate, który umożliwia wejście graczom Bedrock bez kupowania i konfigurowania osobnej kopii Minecraft Java. ^[1]

Najważniejsza decyzja nie dotyczy jednak wyłącznie pobrania pliku JAR. Trzeba ustalić, gdzie ma działać Geyser: bezpośrednio jako wtyczka na serwerze, na osobnym proxy, czy jako niezależny program. Każdy wariant ma inne zastosowanie, ograniczenia i wymagania dotyczące portów, autoryzacji oraz konfiguracji.

Jak działa połączenie Bedrock z serwerem Java

Dwa wydania Minecrafta i dwa różne protokoły

Minecraft Java Edition i Minecraft Bedrock Edition mogą łączyć się z tym samym światem, ale nie komunikują się ze sobą bezpośrednio. Wydanie Java korzysta z własnego protokołu sieciowego i typowo łączy się przez TCP. Bedrock używa innego protokołu, opartego przede wszystkim na UDP. Różnice obejmują nie tylko sposób przesyłania danych, lecz także logowanie, identyfikatory graczy, format niektórych pakietów oraz obsługę elementów interfejsu.

Geyser pełni rolę warstwy pośredniej. Gracz na telefonie łączy się z adresem i portem Geysera jako klient Bedrock. Geyser odbiera jego pakiety, tłumaczy je na komunikację Java, a następnie przekazuje do właściwego serwera Minecraft. Odpowiedzi serwera są tłumaczone w odwrotnym kierunku.

W praktyce można to przedstawić następująco:

• telefon z Minecraft Bedrock łączy się z portem UDP Geysera,
• Geyser rozpoznaje ruch Bedrock i tłumaczy go na protokół Java,
• serwer Java widzi połączenie tak, jakby pochodziło od klienta Java,
• odpowiedzi serwera trafiają przez Geysera z powrotem do aplikacji Bedrock.

To oznacza, że Geyser nie jest „wersją serwera dla telefonu”. Jest mostem między dwoma rodzajami klientów. Serwer nadal działa jako Java Edition, używa swoich pluginów i przechowuje świat w standardowy sposób. Nie trzeba tworzyć osobnego świata Bedrock tylko dlatego, że dołączają użytkownicy mobilni.

Co robi Floodgate

Sam Geyser może przekazywać graczy Bedrock do serwera Java, ale domyślny model uwierzytelniania może wymagać konta Microsoft powiązanego z zakupioną wersją Java Edition. Dla wielu osób korzystających z telefonu jest to niepraktyczne, ponieważ kupiły one Minecraft Bedrock, a nie Java Edition.

Floodgate rozszerza Geysera o alternatywny sposób uwierzytelniania graczy Bedrock. Dzięki niemu użytkownik może wejść na serwer za pomocą konta Microsoft używanego w Bedrock, bez posiadania osobnego konta Java. Floodgate generuje i wykorzystuje własne dane uwierzytelniające, dlatego musi być poprawnie zainstalowany i skonfigurowany po stronie serwera albo proxy.

Floodgate nie jest wymagany w każdym scenariuszu. Jeżeli wszyscy gracze Bedrock mają również Java Edition i serwer ma działać w klasycznym modelu autoryzacji, można używać samego Geysera. Jeśli jednak celem jest wpuszczenie zwykłych użytkowników Minecrafta z telefonu, połączenie Geyser + Floodgate jest zwykle najbardziej przyjazne.

Czego Geyser nie zmienia

Geyser nie usuwa wszystkich różnic między wydaniami gry. Niektóre mechaniki, elementy interfejsu, zachowania mobów, formaty pakietów, efekty wizualne i funkcje dostępne wyłącznie w jednej edycji mogą działać inaczej. Tłumaczenie protokołu jest bardzo rozbudowane, ale nie oznacza pełnej identyczności Java i Bedrock.

Gracz Bedrock nadal może napotkać ograniczenia związane z:

• niestandardowymi pluginami ingerującymi w pakiety lub interfejs Java,
• modami wymagającymi konkretnego klienta Java,
• elementami GUI zaprojektowanymi wyłącznie pod Java Edition,
• nietypowymi mechanikami redstone lub różnicami w zachowaniu mobów,
• systemami zabezpieczeń rozpoznającymi tylko klasycznych klientów Java,
• pluginami, które błędnie interpretują nazwę, UUID albo skórkę gracza Bedrock.

Dlatego przed uruchomieniem crossplayu trzeba sprawdzić nie tylko to, czy telefon może się połączyć. Równie istotne jest to, czy najważniejsze funkcje serwera działają dla obu grup graczy.

Warianty instalacji GeyserMC

Geyser jako plugin na Paperze lub Spigocie

Najprostszy wariant polega na zainstalowaniu Geysera bezpośrednio w katalogu plugins serwera Paper, Spigot albo innego zgodnego silnika pluginowego. W tym samym miejscu można umieścić Floodgate jako dodatkową wtyczkę. Po ponownym uruchomieniu serwera Geyser otwiera własny port Bedrock i przekazuje ruch do lokalnego serwera Java.

Ten model dobrze sprawdza się, gdy istnieje jeden serwer Minecraft i nie ma potrzeby stosowania dodatkowej warstwy proxy. Administracja jest wtedy stosunkowo prosta: pluginy, konfiguracja Geysera, konfiguracja Floodgate i ustawienia zapory znajdują się w jednym środowisku.

Typowy schemat wygląda tak:

Gracz Bedrock
    │ UDP
    ▼
Geyser jako plugin
    │ lokalne połączenie Java
    ▼
Paper / Spigot

Po instalacji Geyser zwykle utworzy własny katalog konfiguracyjny, najczęściej w obrębie plugins/Geyser-Spigot. Nazwa katalogu może zależeć od używanej wersji i typu instalacji. Konfigurację należy zmieniać przy wyłączonym serwerze, ponieważ edycja pliku podczas pracy może zostać nadpisana albo nie zostać odczytana do czasu ponownego uruchomienia. ^[2]

Zalety instalacji pluginowej

• niewielka liczba osobnych procesów do utrzymania,
• łatwe wdrożenie na pojedynczym serwerze,
• bezpośredni dostęp Geysera do serwera Java,
• prostsza diagnostyka dla początkującego administratora,
• możliwość instalacji Floodgate jako zwykłej wtyczki.

Ograniczenia tego wariantu

Geyser jako plugin jest związany z konkretnym serwerem. Jeżeli później pojawi się sieć kilku serwerów, lobby, tryby gry i przełączanie między instancjami, konfiguracja może stać się mniej wygodna. Trzeba też pamiętać, że plugin korzysta z zasobów tego samego procesu, co serwer gry. Przy dużym ruchu obciążenie sieciowe i obliczeniowe spada więc na tę samą instancję.

Wariant pluginowy nie jest najlepszym wyborem, jeśli serwer jest już częścią rozbudowanej sieci opartej na Velocity lub BungeeCord. W takim przypadku lepiej rozważyć uruchomienie Geysera na proxy, aby punkt wejścia Bedrock był wspólny dla całej sieci.

Geyser na proxy Velocity lub BungeeCord

W sieci składającej się z lobby i kilku serwerów Geyser może działać na warstwie proxy. Gracz Bedrock łączy się wtedy z adresem proxy, a nie z każdym serwerem osobno. Proxy wybiera docelową instancję i może przekierować użytkownika do lobby albo innego trybu gry.

Gracz Bedrock
    │ UDP
    ▼
Geyser na proxy
    │
    ▼
Velocity / BungeeCord
    ├── lobby
    ├── survival
    └── minigry

To rozwiązanie rozdziela rolę punktu wejścia od poszczególnych serwerów. Bedrockowy port jest otwierany na maszynie, na której działa proxy. Serwery backendowe nie muszą mieć osobnych publicznych portów Bedrock, a użytkownik mobilny może korzystać z jednego adresu sieci.

W przypadku proxy trzeba jednak dokładnie ustawić przekazywanie informacji o graczu. Dotyczy to między innymi adresu IP, UUID, nazw użytkowników oraz sposobu przekazywania danych logowania. Niewłaściwa konfiguracja może powodować problemy z uprawnieniami, banami, skinami albo rozpoznawaniem gracza po przejściu między serwerami.

Kiedy proxy ma przewagę

• gdy istnieje więcej niż jeden serwer Java,
• gdy gracze korzystają z lobby i przełączania między trybami,
• gdy administrator chce mieć jeden publiczny adres dla Java i Bedrock,
• gdy Geyser ma być niezależny od konkretnego backendu,
• gdy planowany jest dalszy rozwój sieci.

Ryzyka konfiguracji proxy

Proxy wprowadza dodatkową warstwę, więc każdy element musi rozumieć, że za połączeniem może stać klient Bedrock obsługiwany przez Geysera. Dotyczy to ustawień trybu online, przekazywania proxy, pluginów autoryzacyjnych i ochrony backendów.

Jeżeli serwery backendowe są dostępne bezpośrednio z Internetu, gracz może próbować ominąć proxy. Nie jest to problem wyłącznie związany z Geyserem, ale przy sieciach crossplayowych często ujawnia się właśnie podczas konfiguracji. Backend powinien przyjmować ruch tylko od zaufanego proxy albo być chroniony regułami zapory.

Geyser Standalone jako osobny program

Geyser Standalone działa niezależnie od Papera, Spigota i proxy. Można uruchomić go jako osobny proces, który nasłuchuje na porcie Bedrock i łączy się z serwerem Java wskazanym w konfiguracji. To wariant przydatny tam, gdzie administrator nie chce instalować pluginów albo korzysta z silnika, na którym instalacja wtyczek jest niemożliwa lub niewskazana.

Gracz Bedrock
    │ UDP
    ▼
Geyser Standalone
    │ TCP
    ▼
Serwer Java

W tym modelu Geyser ma własny katalog, własny plik konfiguracji i zwykle własny proces uruchamiany z poziomu systemu operacyjnego. Trzeba zadbać o automatyczny start, logowanie, aktualizacje i poprawne przekierowanie portów. Floodgate również może działać w wariancie standalone, ale jego instalacja i wskazanie klucza wymagają szczególnej uwagi.

Plusy niezależnego procesu

• brak konieczności modyfikowania serwera pluginami,
• odseparowanie warstwy tłumaczenia od procesu gry,
• możliwość uruchomienia na innej maszynie,
• większa elastyczność w nietypowych środowiskach,
• łatwiejsze niezależne restartowanie Geysera.

Minusy rozwiązania standalone

Osobny proces nie oznacza automatycznie mniejszej liczby problemów. Trzeba ręcznie ustawić adres backendu Java, port Bedrock, zaporę, usługę systemową oraz ewentualne uwierzytelnianie Floodgate. Pojawia się też dodatkowe połączenie sieciowe, które musi być stabilne.

Ten wariant ma sens przede wszystkim wtedy, gdy administrator świadomie chce rozdzielić Geysera od serwera Java. Dla pojedynczego Paperu instalacja pluginu jest zwykle prostsza. Dla rozbudowanej sieci proxy często lepsze będzie uruchomienie Geysera bezpośrednio na proxy, a nie całkowicie niezależny most.

Porównanie wariantów instalacji

Dla początkującego administratora pojedynczego serwera najrozsądniejszy jest zwykle Geyser jako plugin Paper/Spigot wraz z Floodgate. Proxy staje się właściwym wyborem, gdy serwer ma już architekturę sieciową. Standalone powinien wynikać z konkretnej potrzeby technicznej, a nie z przekonania, że osobny program zawsze jest lepszy.

Wybór autoryzacji: sam Geyser czy Geyser z Floodgate

Połączenie bez Floodgate

W konfiguracji bez Floodgate Geyser działa jako translator protokołu, ale autoryzacja odbywa się w modelu wymagającym zgodności z zasadami logowania Java. W praktyce użytkownik Bedrock może potrzebować konta Microsoft posiadającego uprawnienia do Java Edition. To rozwiązanie jest przewidywalne dla zamkniętej grupy graczy, którzy i tak mają obie wersje gry.

Zaletą takiego modelu jest mniejsza liczba dodatkowych elementów. Nie trzeba instalować Floodgate ani zarządzać jego kluczem. Jednocześnie odpada główna korzyść crossplayu: możliwość wejścia osobom, które kupiły lub używają wyłącznie Bedrock Edition.

Ten wariant może być odpowiedni na prywatnym serwerze rodzinnym, testowym albo w grupie, w której każdy gracz korzysta z Java Edition. Jeżeli celem jest otwarcie serwera na użytkowników telefonów, zwykle okaże się zbyt restrykcyjny.

Połączenie z Floodgate

Floodgate pozwala użytkownikom Bedrock uwierzytelniać się przez konto Microsoft używane w Bedrock. Gracz nie musi posiadać Java Edition, choć nadal musi korzystać z prawidłowego konta Microsoft i oficjalnego klienta Bedrock. Floodgate nie służy do obchodzenia zakupu gry ani do tworzenia anonimowego dostępu bez autoryzacji.

Po instalacji Floodgate Geyser musi korzystać z odpowiedniego trybu uwierzytelniania. W konfiguracji Geysera spotyka się ustawienie w rodzaju:

auth-type: floodgate

Dokładna nazwa sekcji może zależeć od wersji Geysera i wariantu instalacji, dlatego nie należy bezrefleksyjnie kopiować całego pliku konfiguracyjnego z poradnika przygotowanego dla innej wersji. Bezpieczniej jest zmienić tylko wymagane pole w aktualnie wygenerowanym pliku i zachować pozostałe wartości.

Floodgate zmienia sposób identyfikowania graczy. Nazwa Bedrock może otrzymać specjalny prefiks, często spotykany jako kropka przed nickiem. Nie jest to błąd ani dodatkowy znak wpisany przez użytkownika. Taki prefiks pomaga odróżnić gracza Bedrock od użytkownika Java o podobnej nazwie.

Porównanie modeli logowania

Najczęstszy błąd polega na zainstalowaniu Floodgate, ale pozostawieniu innego trybu autoryzacji w konfiguracji Geysera. Drugi częsty problem to użycie Floodgate z innego wariantu niż Geyser. Plugin Floodgate przeznaczony do konkretnego środowiska powinien odpowiadać instalacji Geysera, a aktualne pliki należy pobierać z oficjalnych źródeł projektu.

Klucz Floodgate i bezpieczeństwo

Floodgate korzysta z pliku klucza, który pozwala Geyserowi potwierdzić, że komunikacja z użytkownikiem Bedrock jest autoryzowana przez właściwą instalację. Klucz jest wrażliwym elementem konfiguracji. Nie należy publikować go na forum, w repozytorium kodu, w zrzucie ekranu ani przesyłać osobom, które nie administrują serwerem.

Jeżeli Floodgate działa na proxy, a backendowy serwer Java również musi rozpoznawać graczy Floodgate, sposób przekazania klucza zależy od architektury i używanego proxy. Nie powinno się kopiować plików losowo między katalogami. Trzeba zastosować instrukcję odpowiednią dla używanego typu proxy i wersji Geysera.

Po wymianie klucza lub zmianie środowiska należy ponownie sprawdzić logowanie, identyfikację graczy i działanie uprawnień. Stary klucz może powodować odrzucanie połączeń albo niespójność między proxy a backendem.

Instalacja Geysera na pojedynczym serwerze Paper

Przygotowanie środowiska

Najpierw trzeba ustalić, jaki silnik działa na serwerze. Dla Paper i Spigot przeznaczony jest wariant pluginowy Geysera. Nie należy instalować pliku przeznaczonego dla proxy albo standalone tylko dlatego, że jego nazwa zawiera „Geyser”. Właściwy plik musi odpowiadać środowisku uruchomieniowemu.

Przed instalacją dobrze jest wykonać kopię zapasową serwera, obejmującą przynajmniej:

• światy,
• katalog plugins,
• pliki konfiguracyjne,
• listę obecnych pluginów i ich wersji,
• bazę danych, jeżeli któryś plugin jej używa.

Kopia nie jest potrzebna dlatego, że Geyser typowo niszczy świat. Chodzi o zachowanie możliwości powrotu do poprzedniego stanu w razie pomyłki przy konfiguracji lub aktualizacji. Szczególnie ważne jest to na działającym serwerze z dodatkowymi pluginami.

Pobranie właściwych plików

Dla serwera Paper potrzebne są pluginy przeznaczone do środowiska Bukkit/Paper. Pobieraj je wyłącznie z oficjalnych stron projektu GeyserMC albo zaufanych kanałów wskazanych przez autorów. Potrzebne będą:

• plik pluginu Geyser dla Paper lub Spigota,
• plik pluginu Floodgate dla tego samego środowiska, jeżeli gracze Bedrock mają wchodzić bez Java Edition.

Nie pobieraj wersji opisanej jako Standalone ani pluginu przeznaczonego dla Velocity lub BungeeCord. Samo podobieństwo nazw nie oznacza zgodności plików. Warto również sprawdzić wymagania dotyczące wersji Minecrafta, Paperu oraz Javy używanej przez serwer.

Umieszczenie pluginów w katalogu serwera

Zatrzymaj serwer Paper przed wgraniem nowych plików. Następnie skopiuj pliki Geysera i Floodgate do katalogu:

plugins/

Po tej operacji struktura może wyglądać podobnie do poniższej:

serwer/
├── paper.jar
├── server.properties
└── plugins/
    ├── Geyser-Spigot.jar
    └── floodgate-spigot.jar

Nazwy plików mogą być inne, zależnie od aktualnego wydania. Nie rozpakowuj plików JAR, chyba że dokumentacja konkretnego pluginu wyraźnie tego wymaga. W większości przypadków Paper odczyta je bezpośrednio z katalogu plugins.

Uruchom serwer i obserwuj konsolę. Przy pierwszym starcie pluginy powinny utworzyć własne katalogi oraz pliki konfiguracyjne. Jeżeli serwer zgłasza błąd ładowania, nie przechodź od razu do dalszej konfiguracji. Najpierw sprawdź nazwę pliku, wersję Javy, wersję Paperu i pełny komunikat w logach.

Sprawdzenie wygenerowanych plików

Po pierwszym uruchomieniu powinny pojawić się katalogi podobne do:

plugins/Geyser-Spigot/
plugins/floodgate/

W katalogu Geysera znajduje się główny plik konfiguracyjny, zwykle nazywany config.yml. Dokładna zawartość może zmieniać się między wydaniami, dlatego przed edycją otwórz plik wygenerowany przez własną instalację. Nie zastępuj go w całości konfiguracją skopiowaną z przypadkowego poradnika.

Najbezpieczniej zatrzymać serwer przed ręczną zmianą konfiguracji. Jeżeli edytujesz plik podczas działania Paperu, plugin może nadpisać zmiany przy zamykaniu albo pozostawić konfigurację w niespójnym stanie.

Konfiguracja połączenia Java

W konfiguracji Geysera trzeba wskazać adres i port serwera Java, do którego ma trafiać ruch Bedrock. Przy instalacji jako plugin na tym samym Paperze adres backendu może być ustawiony lokalnie albo automatycznie, zależnie od wersji Geysera. Jeżeli plik zawiera sekcję remote, sprawdź przede wszystkim:

remote:
  address: auto
  port: 25565
  auth-type: floodgate

To jedynie przykład układu konfiguracji. Port 25565 jest często używany przez serwery Java, ale na konkretnym serwerze może obowiązywać inna wartość. Musi ona odpowiadać portowi ustawionemu w server.properties albo w panelu hostingowym.

Jeżeli używasz Floodgate, ustaw tryb autoryzacji zgodny z aktualną konfiguracją pluginu. W pliku może być widoczna wartość floodgate. Gdy korzystasz wyłącznie ze standardowego logowania Java, nie ustawiaj tego trybu bez zainstalowanego i poprawnie działającego Floodgate.

Ustawienie adresu i portu Bedrock

W sekcji dotyczącej połączenia Bedrock znajdziesz zwykle adres nasłuchiwania oraz port:

bedrock:
  address: 0.0.0.0
  port: 19132

Adres 0.0.0.0 oznacza nasłuchiwanie na wszystkich interfejsach sieciowych serwera. Jest to typowe ustawienie dla serwera dostępnego z Internetu. Jeżeli Geyser ma przyjmować połączenia tylko z konkretnego interfejsu, można wskazać bardziej szczegółowy adres, ale wymaga to znajomości konfiguracji sieciowej hosta.

Port Bedrock musi być dostępny przez UDP. To najczęstsza różnica względem portu Java, który zazwyczaj udostępnia się przez TCP. Nie wystarczy otworzyć tego samego numeru w zaporze z niewłaściwym protokołem.

Port 19132 jest często wartością domyślną, ale przed użyciem sprawdź faktyczną wartość w pliku Geysera. Jeżeli hosting przydziela określone porty, użyj portu wskazanego w panelu. Niektóre oferty wymagają również utworzenia osobnej reguły lub dodatkowej alokacji portu UDP.

Zapora sieciowa i przekierowanie portu

Na serwerze domowym lub własnym VPS trzeba zezwolić na ruch UDP do portu skonfigurowanego w Geyserze. Przykładowa reguła dla systemu korzystającego z UFW może wyglądać tak:

sudo ufw allow 19132/udp

Jeżeli używasz innego portu, zastąp 19132 właściwą wartością. W systemie Windows podobną regułę należy utworzyć w Zaporze Windows Defender dla ruchu przychodzącego UDP.

Serwer uruchomiony w domu może wymagać przekierowania portu na routerze. Reguła powinna kierować wybrany port UDP na lokalny adres IP komputera z Paperem. Warto przypisać temu komputerowi stały adres lokalny albo rezerwację DHCP, aby przekierowanie nie przestało działać po restarcie routera.

Na hostingu współdzielonym nie zawsze masz dostęp do systemowej zapory. W takim przypadku sprawdź w panelu, czy port UDP jest aktywny i przypisany do właściwej usługi. Jeżeli panel udostępnia osobne pola dla TCP i UDP, zaznacz UDP dla portu używanego przez Geysera.

Restart po zmianach

Po zapisaniu konfiguracji wykonaj pełne zatrzymanie i ponowne uruchomienie serwera. Nie używaj przypadkowego przeładowania pluginów, ponieważ Geyser, Floodgate i połączenia sieciowe mogą nie zostać poprawnie zainicjalizowane po komendzie typu reload.

Po restarcie sprawdź logi pod kątem informacji o:

• pomyślnym załadowaniu Geysera,
• uruchomieniu listenera Bedrock,
• wybranym porcie UDP,
• wykryciu Floodgate,
• połączeniu z serwerem Java.

Jeżeli Geyser informuje o zajętym porcie, oznacza to, że inny proces już go używa albo druga instancja pluginu została uruchomiona. Zmień port w konfiguracji albo wyłącz usługę, która go zajmuje. Nie uruchamiaj kilku instancji Geysera na tym samym porcie UDP.

Pierwsze połączenie z telefonu

Dodanie serwera w Bedrock Edition

Uruchom Minecraft Bedrock na telefonie i przejdź do listy serwerów. Dodaj nowy serwer, wpisując:

• adres: publiczny adres IP lub domenę serwera,
• port: port UDP ustawiony w Geyserze i udostępniony w zaporze.

Jeżeli telefon znajduje się w tej samej sieci lokalnej co serwer, podczas testu możesz użyć lokalnego adresu IP komputera. Test z sieci komórkowej albo z innego łącza lepiej sprawdza dostępność publiczną, ponieważ omija część problemów związanych z lokalnym routerem.

Na serwerze z Floodgate zaloguj się w Bedrock przy użyciu konta Microsoft. Po wejściu sprawdź, czy gracz pojawia się na liście online oraz czy może wykonywać podstawowe czynności: poruszać się, otwierać ekwipunek, pisać na czacie i ponownie dołączyć po rozłączeniu.

Test w bezpiecznej kolejności

1. Sprawdź, czy serwer Java działa bez błędów.
2. Potwierdź, że Geyser nasłuchuje na właściwym porcie UDP.
3. Zweryfikuj regułę zapory i przekierowanie na routerze.
4. Dodaj adres oraz port w kliencie Bedrock.
5. Zaloguj się kontem Microsoft.
6. Sprawdź wejście, ruch, czat i ponowne połączenie.

Takie podejście ułatwia znalezienie miejsca awarii. Jeżeli telefon nie widzi serwera, problem zwykle dotyczy adresu, portu, zapory albo routingu. Jeżeli serwer jest widoczny, ale odrzuca logowanie, należy sprawdzić Floodgate i tryb autoryzacji.

Typowe problemy po instalacji

Port jest otwarty, ale połączenie nadal nie działa

Sam fakt, że port został dodany do zapory, nie potwierdza jeszcze poprawnego routingu. W przypadku serwera domowego sprawdź, czy router otrzymuje publiczny adres IPv4. Jeżeli operator stosuje CGNAT, klasyczne przekierowanie portu może być niemożliwe. W takiej sytuacji potrzebny jest publiczny adres, tunel albo hosting, który obsługuje przychodzący ruch UDP.

Nie testuj wyłącznie z tego samego urządzenia i tej samej sieci Wi-Fi. Niektóre routery nie obsługują poprawnie połączeń do własnego publicznego adresu z sieci lokalnej. Do testu użyj danych komórkowych albo poproś inną osobę o próbę połączenia.

Problemy z nazwą gracza i uprawnieniami

Gracz Bedrock może być widoczny z prefiksem dodawanym przez Floodgate. Pluginy zarządzające uprawnieniami, działkami, whitelistą lub blokadami nazw muszą rozpoznawać taką tożsamość. Jeżeli gracz może wejść, ale nie otrzymuje uprawnień albo nie może budować, sprawdź jego rzeczywistą nazwę zapisaną przez serwer oraz reguły danego pluginu.

Nie dodawaj konta Bedrock do whitelisty wyłącznie na podstawie nazwy wyświetlanej w telefonie. Najpierw odczytaj identyfikator z konsoli lub komendy odpowiedniej dla używanego systemu uprawnień. Przy zmianie konfiguracji Floodgate sposób identyfikowania gracza może się zmienić, dlatego warto zachować spójne nazwy i dokumentować ręczne wpisy.

Aktualizacje i zgodność wersji

Geyser, Floodgate, Paper i Minecraft są rozwijane niezależnie. Po aktualizacji jednej części sprawdź, czy pozostałe nadal znajdują się w obsługiwanym zakresie. Szczególną uwagę zwróć na:

• wersję klienta Bedrock używaną przez graczy,
• wersję Minecrafta Java obsługiwaną przez serwer,
• wersję Paperu i wymaganej Javy,
• zgodność Geysera z Floodgate,
• pluginy ingerujące w logowanie, nicki, pakiety lub uprawnienia.

Przed aktualizacją zatrzymaj serwer, zachowaj kopię konfiguracji i sprawdź informacje o zmianach w wydaniu. Po podmianie plików uruchom serwer, przejrzyj logi i wykonaj test zarówno z klienta Java, jak i Bedrock. Nie aktualizuj kilku elementów naraz na działającym serwerze bez możliwości ustalenia, który z nich spowodował problem.

Końcowa checklista konfiguracji

• Geyser jest wersją pluginową przeznaczoną dla Paper lub Spigota.
• Floodgate jest zainstalowany, jeżeli Bedrock ma działać bez Java Edition.
• Oba pliki znajdują się bezpośrednio w katalogu plugins.
• Geyser wygenerował własną konfigurację po pierwszym uruchomieniu.
• Adres i port backendu Java odpowiadają konfiguracji serwera.
• auth-type jest zgodny z używanym modelem logowania.
• Port Bedrock jest otwarty jako UDP, a nie tylko TCP.
• Port jest przekierowany na właściwy komputer lub udostępniony w panelu hostingu.
• Telefon łączy się z publicznym adresem i właściwym portem.
• W logach nie ma błędów Geysera, Floodgate ani Paperu.
• Gracz Bedrock może wejść, poruszać się, pisać i ponownie się połączyć.
• Po aktualizacji wykonano test obu wydań Minecrafta.

Dokumentowanie działającej konfiguracji

Po pomyślnym teście warto zapisać najważniejsze informacje dotyczące serwera. Ułatwi to późniejsze odtworzenie ustawień po zmianie hostingu, routera albo wersji oprogramowania.

• adres domeny lub publiczny adres IP używany przez graczy,
• port Bedrock oraz informację, że jest udostępniony przez UDP,
• wersję Paperu, Geysera, Floodgate i wymaganej Javy,
• lokalizację plików konfiguracyjnych,
• ustawiony model autoryzacji,
• datę ostatniego poprawnego testu z klienta Java i Bedrock.

Nie zapisuj kluczy ani haseł w publicznej dokumentacji. Jeżeli konfiguracja ma być przechowywana w repozytorium lub udostępniana administratorom, usuń z niej dane uwierzytelniające i inne sekrety.

Kontrola po zmianie adresu lub portu

Zmiana domeny, publicznego adresu IP albo portu wymaga ponownego sprawdzenia całej ścieżki połączenia. Zaktualizuj wpisy w panelu hostingu, routerze i zaporze, a następnie potwierdź, że Geyser uruchomił listener na nowej wartości.

Po takiej zmianie wykonaj test spoza sieci lokalnej. W kliencie Bedrock wpisz nowy adres i port, a w logach sprawdź, czy połączenie dociera do serwera. Jeżeli gracze używają domeny, upewnij się również, że rekord DNS wskazuje aktualny adres serwera.

Bezpieczne zakończenie konfiguracji

Nie usuwaj starszej działającej konfiguracji natychmiast po udanym wdrożeniu. Zachowaj ją przez czas potrzebny na potwierdzenie, że gracze mogą korzystać z serwera w różnych warunkach sieciowych. Jeżeli po zmianie pojawią się problemy, łatwiej będzie porównać ustawienia i przywrócić poprzedni stan.

Od tego momentu administracja połączeniem Bedrock sprowadza się przede wszystkim do obserwowania logów, kontrolowania dostępności portu UDP oraz sprawdzania zgodności aktualizowanych komponentów. Dzięki temu Geyser i Floodgate pozostają częścią przewidywalnej konfiguracji Papera, a gracze z telefonu mogą korzystać z serwera bez dodatkowych zmian po swojej stronie.

Najczęściej zadawane pytania (FAQ)

Czy GeyserMC pozwala graczom z telefonu dołączyć do serwera Java?

Tak. Geyser tłumaczy ruch Bedrock na format rozumiany przez serwer Minecraft Java, taki jak Paper lub Spigot.

Czy Floodgate jest potrzebny do działania Geysera?

Nie zawsze. Floodgate jest potrzebny wtedy, gdy gracze Bedrock mają dołączać bez posiadania osobnego konta Java.

Czy trzeba tworzyć osobny świat dla graczy Bedrock?

Nie. Serwer nadal działa jako Java Edition i korzysta ze standardowego świata Minecraft Java.

Gdzie najlepiej zainstalować Geysera?

Na pojedynczym serwerze najprostsza będzie instalacja jako plugin Paper lub Spigot. W większej sieci lepszym miejscem może być proxy Velocity albo BungeeCord.

Czy Geyser zapewnia pełną zgodność Java i Bedrock?

Nie. Niektóre mechaniki, elementy interfejsu, pluginy i zachowania mogą różnić się między wydaniami gry.

Źródła

• [1] GeyserMC – Setup | GeyserMC ↑
• [2] GeyserMC – Floodgate Setup | GeyserMC ↑
• [3] GeyserMC – Frequently Asked Questions | GeyserMC ↑