Crossplay: gracze Bedrocka (telefony, konsole, Windows) na serwerze Java

Java i Bedrock to dwie różne edycje Minecrafta, które same z siebie nie mogą grać razem. Plugin Geyser tłumaczy między nimi, więc do Twojego serwera Java mogą dołączać także gracze na telefonach, Windowsie (Bedrock), Xboksie, PlayStation czy Switchu. Z dodatkiem Floodgate nie potrzebują nawet konta Java. Ten poradnik obejmuje instalację, ustawienie portu i wszystkie ważne opcje.

Jak działają Geyser i Floodgate#

Java Edition komunikuje się przez TCP, Bedrock Edition przez UDP i zupełnie innym protokołem. Geyser działa jako plugin na Twoim serwerze, nasłuchuje na porcie UDP graczy Bedrocka i każdego z nich „przedstawia” serwerowi jako gracza Java.

Floodgate dodaje do nicków graczy Bedrocka prefiks (domyślnie kropkę, na przykład .Steve123), aby nie mylili się z graczami Java o tym samym nicku.

Obsługiwane serwery i wersje#

• Typ serwera: Paper lub Purpur (Geyser-Spigot), Fabric i NeoForge (Geyser jako mod) albo proxy Velocity. Na Vanilli Geyser nie działa.
• Wersja Minecrafta: Geyser łączy się z serwerem jako klient Java jednej konkretnej wersji. Na dzień 1 października 2026 obsługuje Javę 26.2 i Bedrock 26.30–⁠26.51 (aktualny stan jest na stronie Supported versions (otwiera się w nowym oknie)).
  • Serwer na starszej wersji (Paper lub Purpur 1.20.5 i nowszy): zainstaluj także plugin ViaVersion. Na serwerach starszych niż 1.20.5 Geyser jako plugin nie działa.
  • Serwer na nowszej wersji, niż Geyser już obsługuje (na przykład 26.3): najpewniej jest poczekać na aktualizację Geysera (obserwuj stronę Supported versions) albo założyć nowy serwer na obsługiwanej wersji. Dokumentacja Geysera przewiduje ViaVersion tylko dla serwerów starszych niż obsługiwana wersja. Para ViaVersion i ViaBackwards może przez jakiś czas wypełnić tę lukę, ale nie jest to oficjalnie udokumentowane – próbuj tego tylko z kopią zapasową. Katalog w zakładce Pluginy nie zaproponuje Ci Geysera dla takiej wersji, więc plik Geyser-Spigot.jar musiałbyś wgrać ręcznie z geysermc.org/download (otwiera się w nowym oknie).
  • Geyser jako mod (Fabric, NeoForge) działa tylko na wersji, którą Geyser aktualnie obsługuje.
• Port UDP: Bedrock łączy się przez UDP. Porty naszych serwerów działają zarówno dla TCP, jak i UDP, więc możesz użyć portu gry albo dodatkowego portu (patrz niżej).

Instalacja na Paperze i Purpurze#

1. Zrób kopię zapasową serwera w zakładce Kopie zapasowe.

2. Otwórz zakładkę Pluginy › Przeglądaj, jako źródło wybierz Modrinth i wyszukaj Geyser.

3. Przy projekcie Geyser od GeyserMC kliknij Zainstaluj i potwierdź.

   Katalog pokazuje tylko wersje dla Twojego serwera. Jeśli nie znajdziesz Geysera dla swojej wersji, najpewniej jeszcze jej nie obsługuje (patrz wyżej).

4. Pobierz na komputer Floodgate dla Spigot/Paper z oficjalnej strony geysermc.org/download (otwiera się w nowym oknie) (plik Floodgate-Spigot.jar). Na Modrinth Floodgate jest dostępny tylko dla Fabric i NeoForge.

5. W zakładce Pliki otwórz folder plugins i wgraj plik przyciskiem Prześlij. Na liście pluginów będzie oznaczony jako Przesłano ręcznie (jego wersji i aktualizacji pilnujesz wtedy sam).

6. Uruchom serwer ponownie.

   W konsoli pojawi się linia Started Geyser on 0.0.0.0:19132 (lub Started Geyser on UDP port 19132) i powstaną foldery plugins/Geyser-Spigot oraz plugins/floodgate (z plikiem key.pem w środku).

Teraz ustaw port i Floodgate.

Port dla graczy Bedrocka#

Domyślnie Geyser nasłuchuje na porcie 19132. Ten port nie należy w StormHost do Twojego serwera, więc nikt się na nim nie połączy. Wybierz jedną z dwóch opcji:

Gra Java używa TCP, a Bedrock UDP, dlatego mogą dzielić ten sam numer portu.

Opcja A: ten sam port co Java#

1. W zakładce Pliki otwórz plugins/Geyser-Spigot/config.yml.

2. W sekcji bedrock ustaw clone-remote-port: true:

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

   Wartości port nie zmieniaj – przy włączonym clone-remote-port Geyser przy każdym starcie zastępuje ją portem serwera Java.

3. Zapisz plik (Ctrl+S).

Opcja B: osobny port#

1. W zakładce Sieć w części Dodatkowe porty kliknij Dodaj port i zapamiętaj nowy numer.

2. W zakładce Pliki otwórz plugins/Geyser-Spigot/config.yml.

3. W sekcji bedrock wpisz nowy port i zostaw clone-remote-port wyłączone:

   bedrock:
     address: 0.0.0.0
     port: <PORT>
     clone-remote-port: false

   Zamiast <PORT> wpisz numer portu z zakładki Sieć, bez nawiasów ostrych, na przykład 27015.

4. Zapisz plik.

Konfiguracja Floodgate#

1. W plugins/Geyser-Spigot/config.yml znajdź sekcję java i ustaw auth-type:

   java:
     auth-type: floodgate

   W starszych wersjach Geysera sekcja nazywa się remote zamiast java. Ustawienie jest takie samo.

2. W zakładce Ustawienia serwera w grupie Gracze wyłącz Wymagaj podpisanego czatu (enforce-secure-profile=false). Bedrock nie obsługuje podpisywania czatu i gracze Bedrocka inaczej nie mogliby pisać.

3. Kliknij Zapisz i uruchom ponownie.

Najważniejsze opcje w config.yml Geysera#

Floodgate: config.yml#

Plik plugins/floodgate/config.yml:

Łączenie z Bedrocka#

Gracze Bedrocka wpisują adres i port osobno (Bedrock nie używa rekordów SRV).

W grze: Play › zakładka Servers › Add Server, wypełnij pola i kliknij Save. Więcej o adresach i domenach w poradniku Adres serwera i domena.

Konsole (Xbox, PlayStation, Switch)#

Konsole pozwalają łączyć się tylko z wybranymi serwerami. Do innych serwerów gracze dostają się przez nieoficjalne obejścia, typowo usługę BedrockConnect (zmiana DNS w ustawieniach sieci konsoli) albo aplikacje, które pokazują serwer w sieci lokalnej. Kroki dla poszczególnych konsol opisuje dokumentacja Geysera na stronie Using Geyser with Consoles (otwiera się w nowym oknie). Tych usług nie prowadzimy i nie możemy zagwarantować, że działają.

Whitelista i uprawnienia graczy Bedrocka#

• Whitelista: użyj polecenia fwhitelist z Floodgate bez prefiksu:

  fwhitelist add Steve123
  fwhitelist remove Steve123

  • fwhitelist add – dodaje gracza Bedrocka do whitelisty (do whitelist.json).
  • Steve123 – nazwa Xbox gracza bez kropki na początku.

  Zwykłe whitelist add dla graczy Bedrocka nie działa, bo ich nicków nie ma w bazie kont Java.

• Polecenia skierowane na gracza (teleport, ban) używają nicku łącznie z prefiksem, na przykład tp .Steve123.

• LuckPerms: domyślnie LuckPerms odrzuca nicki z kropką. W plugins/LuckPerms/config.yml ustaw allow-invalid-usernames: true i uruchom serwer ponownie (LuckPerms).

Geyser na proxy Velocity#

W sieci serwerów za proxy zainstaluj Geysera i Floodgate tylko na proxy. Gracze Bedrocka łączą się z portem proxy, a proxy przekazuje ich dalej na serwery.

1. Na Velocity zainstaluj Geysera i Floodgate dla Velocity (oba z geysermc.org/download (otwiera się w nowym oknie)).
2. W konfiguracji Geysera na proxy ustaw port (opcja A lub B jak wyżej) i auth-type: floodgate.
3. W velocity.toml ustaw force-key-authentication = false, inaczej gracze Bedrocka nie będą mogli pisać na czacie.
4. Wszystkie serwery za proxy muszą przyjmować klienta Java w wersji obsługiwanej przez Geysera – w razie potrzeby zainstaluj na nich ViaVersion.

Floodgate na serwerach za proxy potrzebujesz tylko wtedy, gdy pluginy na tych serwerach korzystają z jego danych. W takim przypadku włącz na proxy send-floodgate-data: true w plugins/floodgate/config.yml (podfolder zależy od platformy), zainstaluj Floodgate na serwerach za proxy i skopiuj na nie key.pem z proxy. Szczegóły znajdziesz w poradniku Sieć serwerów z Velocity.

Geyser na Fabricu i NeoForge#

1. W zakładce Mody › Przeglądaj zainstaluj Geysera (na Fabricu wymagane Fabric API zostanie dodane automatycznie).
2. Zainstaluj Floodgate (na Modrinth jest dostępny zarówno dla Fabric, jak i NeoForge).
3. Uruchom serwer ponownie i ustaw port oraz auth-type jak wyżej. Konfiguracja Geysera jest w config/Geyser-Fabric/config.yml (na NeoForge w config/Geyser-NeoForge/config.yml).

Geyser jako mod obsługuje tylko jedną wersję Minecrafta, najnowszą obsługiwaną. Na starszym serwerze z modami go nie użyjesz.

Weryfikacja#

1. Po restarcie poszukaj w konsoli linii Started Geyser on … ze swoim portem.

2. Uruchom w konsoli test dostępności:

   geyser connectiontest <IP_ADDRESS> <PORT>

   • geyser connectiontest – sprawdza, czy Geyser jest osiągalny z zewnątrz, a jeśli nie, podpowiada, co jest nie tak.
   • <IP_ADDRESS> – adres IP serwera z zakładki Sieć.
   • <PORT> – port dla Bedrocka (opcja A: port gry, opcja B: Twój dodatkowy port).

3. Sprawdź serwer narzędziem Minecraft Status w trybie Bedrock.

4. Połącz się z Bedrocka. Gdy wejdziesz, w konsoli pojawi się linia o dołączeniu gracza z prefiksem, a geyser list pokaże jego nick.

Rozwiązywanie problemów#

Bedrock: Unable to connect to world#

Najczęstszy błąd. Sprawdź po kolei:

• Gracz wpisał zły port. Opcja A: port gry, opcja B: port z bedrock.port. Port 19132 w StormHost nie działa.
• Geyser nie działa na porcie, którego się spodziewasz. Sprawdź w konsoli linię Started Geyser on ….
• Na tym samym porcie UDP działa coś innego (Query, czat głosowy). Przejdź na opcję B.
• Uruchom geyser connectiontest (patrz Weryfikacja) i postępuj według jego wskazówek.
• Na telefonie spróbuj całkowicie zamknąć grę i otworzyć ją ponownie.
• Dokumentacja Geysera podaje, że porty poniżej 10 000 czasem sprawiają problemy. Jeśli możesz, wybierz wyższy port.

Outdated Bedrock client! This server supports the following Bedrock versions: …#

Gracz ma inną wersję Bedrocka, niż obsługuje Geyser. Gracz aktualizuje grę albo Ty aktualizujesz Geysera (w zakładce Pluginy › Sprawdź aktualizacje; Floodgate wgrany ręcznie trzeba zaktualizować ręcznie).

This server does not support Java Edition …, which is required for Geyser to connect.#

Wersja serwera różni się od wersji, którą emuluje Geyser. Zainstaluj ViaVersion (a dla nowszego serwera ViaBackwards) albo zaktualizuj Geysera.

This server requires a paid Java account.#

Geyser ma auth-type: online albo Floodgate nie działa. Zainstaluj Floodgate, ustaw auth-type: floodgate i uruchom serwer ponownie.

Please log into Xbox to join this server.#

Gracz nie jest zalogowany w grze kontem Microsoft. Floodgate wymaga konta Xbox – gracz loguje się w ustawieniach gry.

Tried to log in as a Java Edition player! Is Floodgate set up correctly?#

Floodgate nie działa na serwerze albo się nie wczytał. Poszukaj błędów Floodgate w konsoli podczas startu i sprawdź, czy w folderze plugins jest plik dla Spigot/Paper.

javax.crypto.AEADBadTagException: Tag mismatch!#

Geyser i Floodgate używają różnych kluczy. Zatrzymaj serwer, usuń folder plugins/floodgate i ewentualny plik klucza w folderze Geysera, a potem uruchom serwer – powstanie nowy klucz.

Gracze Bedrocka nie mogą pisać na czacie#

Włączone jest enforce-secure-profile (na proxy Velocity force-key-authentication). Wyłącz je i uruchom serwer ponownie.

Gracz Bedrocka nie jest na whiteliście#

Dodaj go poleceniem fwhitelist add <NICK> bez kropki, a nie whitelist add.

Dalsza lektura#

• Geyser: konfiguracja na Paper/Spigot u dostawcy hostingu (otwiera się w nowym oknie)
• Obsługiwane wersje Geysera (otwiera się w nowym oknie)
• Naprawa „Unable to Connect to World” (otwiera się w nowym oknie)
• Floodgate: konfiguracja (otwiera się w nowym oknie)
• Geyser i podpisywanie czatu (otwiera się w nowym oknie)