Jak skonfigurować Floodgate, aby gracze Bedrock mogli dołączyć bez konta Java?

Jeśli masz już zainstalowany GeyserMC, gracze Bedrock mogą już znaleźć Twój serwer — ale na serwerze z online-mode=true przy próbie dołączenia wciąż zostaną odrzuceni. Geyser tłumaczy bowiem tylko protokół; weryfikacja logowania nadal oczekuje płatnego konta Java, którego gracze na telefonie, tablecie czy konsoli zwykle nie mają. Floodgate rozwiązuje ten problem: gracze Bedrock są weryfikowani przez własne konto Microsoft/Xbox, dzięki czemu mogą bezpiecznie dołączyć bez konta Java, a Twój serwer normalnie pozostaje w trybie online. W tym artykule zainstalujesz Floodgate obok Geysera, powiążesz klucz, ustawisz właściwy auth-type i dowiesz się, jak działa prefiks gamertagów.

Krok 1: zainstaluj Floodgate obok Geysera

1. Pobierz Floodgate z oficjalnej strony pobierania GeyserMC. Wybierz ten sam wariant platformy co Twój plugin Geyser, na przykład floodgate-spigot.jar dla serwera Paper lub Spigot.
2. Zaloguj się do panelu gier, otwórz swój serwer i przejdź do zakładki Files.
3. Otwórz folder plugins i wgraj plik .jar Floodgate obok pluginu Geyser.
4. Zrestartuj serwer w zakładce Console. W konsoli zobaczysz, że Floodgate się ładuje; przy pierwszym uruchomieniu plugin automatycznie utworzy plik klucza plugins/floodgate/key.pem.

Krok 2: sprawdź powiązanie klucza między Floodgate a Geyserem

Plik key.pem to tajny klucz, dzięki któremu Geyser i Floodgate sobie ufają. Gdy oba działają jako pluginy na tym samym serwerze, Geyser wykrywa klucz automatycznie. Tak to sprawdzisz:

1. W zakładce Files otwórz plik plugins/Geyser-Spigot/config.yml.
2. Sprawdź, czy jest w nim linia floodgate-key-file: key.pem. To wartość domyślna; zwykle nie musisz tu niczego zmieniać.
3. Prowadzisz sieć za proxy (BungeeCord lub Velocity)? Skopiuj wtedy plugins/floodgate/key.pem z proxy do folderu plugins/floodgate/ każdego serwera backendowego. Wszystkie serwery muszą używać dokładnie tego samego klucza, inaczej Floodgate odrzuci logowania.

Krok 3: ustaw auth-type na floodgate

1. Ponownie otwórz plugins/Geyser-Spigot/config.yml.
2. W sekcji remote: znajdź linię auth-type: online i zmień ją na auth-type: floodgate.
3. Zapisz plik i zrestartuj serwer w zakładce Console.

Od teraz Floodgate obsługuje weryfikację graczy Bedrock przez ich gamertag Xbox. Gracze Java logują się jak zawsze; dla nich nic się nie zmienia.

Krok 4: sprawdź port UDP 19132

Bedrock łączy się przez UDP, domyślnie na porcie 19132. W pliku config.yml w sekcji bedrock: sprawdź, jaki port: jest ustawiony, i upewnij się, że ten numer portu jest faktycznie przypisany do Twojego serwera i otwarty. Jeśli 19132 nie jest u Ciebie dostępny, dodaj dodatkowy port — przeczytasz o tym w artykule o dodatkowych portach — i wpisz ten numer przy port:. Dodając serwer, gracze Bedrock używają IP Twojego serwera oraz tego numeru portu.

Prefiks gamertagów: dlaczego nazwy Bedrock zaczynają się od kropki

Floodgate domyślnie dodaje kropkę (.) przed każdym gamertagiem Bedrock, aby gracz Bedrock nigdy nie miał dokładnie takiej samej nazwy jak istniejące konto Java. Steve123 z Bedrocka nazywa się więc na Twoim serwerze .Steve123. Miej to na uwadze:

• Whitelista: /whitelist add .Steve123 często się nie udaje, bo serwer próbuje wyszukać tę nazwę u Mojangu. Pozwól graczowi najpierw raz dołączyć i dodaj go potem, albo edytuj whitelist.json bezpośrednio w zakładce Files.
• Uprawnienia: na przykład w LuckPerms zawsze używaj pełnej nazwy razem z kropką albo nadawaj uprawnienia, gdy gracz jest online.
• Zmiana prefiksu: możliwa przez username-prefix w plugins/floodgate/config.yml, ale najlepiej go nie ruszaj. Bez prefiksu ryzykujesz konflikty nazw między graczami Java i Bedrock, a po zmianie istniejące wpisy whitelisty i uprawnień przestaną się zgadzać.

Częste problemy

• „Unable to connect to world” na konsolach — Prawie zawsze problem z portem: port Bedrock jest nieosiągalny albo źle ustawiony w configu. Przejdź jeszcze raz krok 4 i pamiętaj, że chodzi o UDP. Sprawdź też, czy konsola ma najnowszą wersję Minecrafta; zewnętrzne serwery dodaje się na konsolach w zakładce Servers, a na przestarzałej wersji nie zawsze się to udaje.
• Gracze Bedrock są wyrzucani lub proszeni o konto Java — auth-type wciąż jest ustawiony na online. Zmień go na floodgate (krok 3) i zrestartuj serwer. Jeśli konsola pokazuje, że Geyser nie znajduje klucza Floodgate, sprawdź, czy Floodgate w ogóle się załadował i czy istnieje key.pem.
• Błędy klucza przy dołączaniu — Komunikaty typu „Please connect through the official Geyser” wskazują na niezgodność kluczy: Geyser używa innego key.pem niż Floodgate. Usuń zdublowane lub stare klucze, w sieci skopiuj wszędzie ten sam klucz i zrestartuj wszystko.
• Pluginy odrzucają graczy Bedrock — Niektóre pluginy walidują nazwy graczy i nie akceptują kropki. Sprawdź, czy dla danego pluginu dostępna jest aktualizacja lub hook Floodgate. Dopiero w ostateczności zmień prefiks na znak, który plugin akceptuje, a potem zaktualizuj whitelistę i uprawnienia.

Crossplay jako atut Twojego serwera

Z Geyserem i Floodgate wszyscy grają na jednym serwerze: rodzina ze Switchem w salonie i pecetem na piętrze albo paczka znajomych, z których połowa gra na konsoli. Nikt nie musi już kupować konta Java, żeby dołączyć. Ciekawi Cię różnica między obiema edycjami? Przeczytaj też nasz artykuł o Java vs Bedrock. Jeśli utkniesz, zespół wsparcia MC-Node chętnie pomoże przez ticket — podaj w nim komunikat błędu z konsoli.