Wpuść graczy Bedrock na swój serwer Java: konfiguracja Geyser + Floodgate (Paper, Velocity)

Co robią Geyser i Floodgate

Geyser tłumaczy między obiema edycjami. Wobec twojego serwera zachowuje się jak klient Java, więc redstone, farmy i pluginy działają dokładnie tak jak dla graczy Java. Floodgate wpuszcza graczy Bedrock z kontem Xbox zamiast konta Java.

Zanim zaczniesz: Java i wersje

• Geyser potrzebuje Javy 21 lub nowszej na maszynie, na której działa.
• Twój serwer musi przyjmować najnowszą wersję Java, bo Geyser udaje takiego klienta. Starsze serwery potrzebują ViaVersion.
• Geyser-Spigot działa na Paper i Spigot od wersji 1.20.5. Starsze serwery potrzebują proxy, Geyser Standalone albo ViaProxy.
• Obsługiwane są tylko aktualne wersje Bedrock (październik 2026: Bedrock od 26.30 do 26.52, Java 26.2). Aktualizuj Geysera, bo Bedrock aktualizuje się sam.

Geysera i Floodgate dla swojej platformy pobierzesz z oficjalnej strony pobierania GeyserMC.

Konfiguracja na pojedynczym serwerze Paper lub Spigot

1. Wrzuć Geyser-Spigot.jar i Floodgate-Spigot.jar do folderu plugins.
2. Zrestartuj serwer. Geyser tworzy plugins/Geyser-Spigot/config.yml, a Floodgate folder plugins/floodgate/ z plikiem config.yml i key.pem.
3. Otwórz konfigurację Geysera i sprawdź sekcję bedrock. Wartość port to to, co wpisują gracze Bedrock.
4. Ustaw uwierzytelnianie na floodgate i zrestartuj serwer jeszcze raz.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

W starszych konfiguracjach Geysera druga sekcja nazywa się remote, więc ustawienie to remote.auth-type. Aktualne wersje same przełączają się na Floodgate, gdy działa on na tym samym serwerze; ustawienie tego ręcznie nie zaszkodzi.

Na pojedynczym serwerze nigdzie nie kopiujesz key.pem. Geyser czyta klucz prosto z Floodgate, a pozostawiona kopia w folderze Geysera powoduje błędy logowania.

Otwórz port Bedrock dla UDP

Java używa TCP, Bedrock używa UDP. Na tym kroku pada większość konfiguracji.

• Panel hostingu: dodaj dodatkowy port (wiele hostingów nazywa to alokacją) i wpisz go jako bedrock.port. Niektóre hostingi wymagają dla Bedrock tego samego portu co dla Java albo zmieniają port Java przy każdym starcie; wtedy clone-remote-port: true sprawia, że Geyser bierze port Java. Strona konfiguracji Geysera ma instrukcje dla wielu hostingów.
• Pterodactyl: przypisz port do serwera w zakładce Network.
• Własny komputer lub VPS: otwórz port dla UDP w zaporze, a w domu także na routerze. OVH i Oracle Cloud dodatkowo blokują UDP we własnej zaporze.

sudo ufw allow 19132/udp
sudo ufw reload

Pluginy do czatu głosowego ani query nie mogą dzielić portu z Geyserem. Gdy port jest otwarty, wpisz w konsoli geyser connectiontest <ip> <port>; komenda sprawdza port i podpowiada rozwiązania.

Konfiguracja w sieci z Velocity lub BungeeCord

W sieci gracze Bedrock łączą się z proxy tak samo jak gracze Java. Dlatego Geyser działa tylko na proxy.

1. Zainstaluj Geysera i Floodgate dla swojego proxy (Velocity lub BungeeCord) i zrestartuj proxy.
2. W konfiguracji Geysera na proxy ustaw bedrock.port i uwierzytelnianie floodgate, a port otwórz dla UDP jak wyżej.
3. Zainstaluj Floodgate-Spigot na każdym backendzie. Jest potrzebny pluginom korzystającym z API Floodgate i poprawia skiny.
4. Skonfiguruj przekazywanie: przy BungeeCord ip_forward: true w jego config.yml i bungeecord: true w spigot.yml każdego backendu; przy Velocity przekazywanie informacji o graczach tak, jak opisuje dokumentacja Velocity.
5. W konfiguracji Floodgate na proxy ustaw send-floodgate-data: true.
6. Skopiuj key.pem z folderu Floodgate na proxy do folderu Floodgate każdego serwera backend, potem zrestartuj backendy i proxy.

send-floodgate-data: true

Trzymaj key.pem w tajemnicy: z nim konta omijają uwierzytelnianie Java. Wgrywaj go przez FTP w trybie binarnym, inaczej pojawią się błędy Tag mismatch.

Nicki Bedrock: prefiks z kropką

Floodgate dodaje prefiks przed każdym nickiem Bedrock, żeby nigdy nie pokrył się z nickiem Java. Domyślnie to kropka, więc gamertag Xbox Steve na twoim serwerze to .Steve. Spacje w gamertagu są zamieniane na _.

username-prefix: "."
replace-spaces: true

• W komendach używaj pełnego nicku z prefiksem. Jeśli komenda go nie przyjmuje, weź nick w cudzysłów: /tp ".Steve".
• Do whitelisty służy fwhitelist add Steve. Prefiks nie jest tam potrzebny.
• Jeśli LuckPerms ma problem z nickami Bedrock, ustaw allow-invalid-usernames: true w jego konfiguracji.

GeyserMC radzi zostawić prefiks. Gracze Bedrock głosują też tym nickiem: na BestMCServerList wpisują .Steve, czyli nick, który widzi twój plugin do nagród za głosy.

Połączone konta i skiny (opcjonalnie)

Global Linking jest w Floodgate domyślnie włączony. Kto ma obie edycje, wchodzi na link.geysermc.org z obu kont i wpisuje /linkaccount. Potem na obu urządzeniach gra z ekwipunkiem i pozycją konta Java, więc najpierw powinien przenieść przedmioty z Bedrock. Własna baza połączeń wymaga dodatkowego rozszerzenia Floodgate.

Floodgate konwertuje i wysyła skiny Bedrock, żeby gracze Java je widzieli. Działa to przez kolejkę i może chwilę potrwać.

Typowe błędy i rozwiązania

Niektórych rzeczy nie da się przetłumaczyć: lewy i prawy klik w ekwipunku wyglądają tak samo, komendy bez Brigadiera nie mają podpowiedzi, linki na czacie nie są klikalne. Testuj menu na prawdziwym urządzeniu Bedrock. Pluginy mogą pokazywać natywne formularze Bedrock przez API Floodgate; wtedy Floodgate musi działać na ich serwerze.

Pokaż oba adresy na BestMCServerList

Gracze Bedrock łączą się przez twój adres i port Bedrock, na przykład play.example.net i 19132. BestMCServerList pokazuje na każdej stronie serwera adres Java i Bedrock osobno, każdy z przyciskiem kopiowania.

1. Otwórz Dodaj serwer i wpisz adres Java.
2. Zaznacz Obsługuje graczy Bedrock.
3. Wpisz Port Bedrock z bedrock.port. Pole IP Bedrock zostaw puste, jeśli to ten sam adres co Java.

Crossplay to dla nowego serwera prawdziwa przewaga. Resztę planu znajdziesz w poradniku jak zdobyć graczy na nowy serwer.