Pusť Bedrock hráče na svůj Java server: nastavení Geyser + Floodgate (Paper, Velocity)

Co Geyser a Floodgate dělají

Geyser překládá mezi oběma edicemi. Vůči tvému serveru se chová jako Java klient, takže redstone, farmy a pluginy fungují přesně jako pro Java hráče. Floodgate umožní Bedrock hráčům přihlásit se Xbox účtem místo Java účtu.

Než začneš: Java a verze

• Geyser potřebuje na stroji, kde běží, Javu 21 nebo novější.
• Tvůj server musí přijímat nejnovější verzi Javy, protože Geyser napodobuje takového klienta. Starší servery potřebují ViaVersion.
• Geyser-Spigot běží na Paperu a Spigotu od 1.20.5 výš. Starší servery potřebují proxy, Geyser Standalone nebo ViaProxy.
• Podporované jsou jen aktuální verze Bedrocku (říjen 2026: Bedrock 26.30 až 26.52, Java 26.2). Udržuj Geyser aktuální, protože Bedrock se aktualizuje sám.

Geyser a Floodgate pro svou platformu stáhni z oficiální stránky ke stažení GeyserMC.

Nastavení na jednom Paper nebo Spigot serveru

1. Dej Geyser-Spigot.jar a Floodgate-Spigot.jar do složky plugins.
2. Restartuj server. Geyser vytvoří plugins/Geyser-Spigot/config.yml, Floodgate vytvoří plugins/floodgate/ s config.yml a key.pem.
3. Otevři config Geyseru a zkontroluj sekci bedrock. port je to, co budou Bedrock hráči zadávat.
4. Nastav typ ověřování na floodgate a znovu restartuj.

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

java:
  auth-type: floodgate

Starší configy Geyseru nazývají druhou sekci remote, takže nastavení je remote.auth-type. Aktuální buildy přepnou na Floodgate samy, když běží na stejném serveru; nastavit to ale neuškodí.

Na jednom serveru key.pem nikam nekopíruj. Geyser ho čte z Floodgate a zapomenutá kopie ve složce Geyseru způsobuje chyby při přihlášení.

Otevři Bedrock port pro UDP

Java používá TCP, Bedrock UDP. Tady selhává většina nefunkčních nastavení.

• Hostingový panel: přidej port navíc (hodně hostingů tomu říká alokace) a zadej ho jako bedrock.port. Některé hostingy vyžadují, aby Bedrock používal stejný port jako Java, nebo Java port mění při každém startu; tam clone-remote-port: true přiměje Geyser použít Java port. Stránka s nastavením Geyseru má návody pro hodně hostingů.
• Pterodactyl: přiřaď port serveru na kartě Network.
• Vlastní stroj nebo VPS: otevři port pro UDP ve firewallu a doma i v routeru. OVH a Oracle Cloud blokují UDP navíc ve vlastním firewallu.

sudo ufw allow 19132/udp
sudo ufw reload

Pluginy na hlasový chat ani query nemůžou s Geyserem sdílet port. Jakmile je port otevřený, spusť v konzoli geyser connectiontest <ip> <port>; zkontroluje port a navrhne řešení.

Nastavení na síti s Velocity nebo BungeeCordem

Na síti se Bedrock hráči připojují k proxy stejně jako Java hráči. Geyser proto běží jen na proxy.

1. Nainstaluj Geyser a Floodgate pro svou proxy (Velocity nebo BungeeCord) a proxy restartuj.
2. V configu Geyseru na proxy nastav bedrock.port a typ ověřování floodgate a otevři port pro UDP, jak je popsáno výše.
3. Na každý backend nainstaluj Floodgate-Spigot. Je potřeba pro pluginy, které používají Floodgate API, a zlepšuje skiny.
4. Nastav forwarding: na BungeeCordu nastav ip_forward: true v jeho config.yml a bungeecord: true ve spigot.yml každého backendu; na Velocity nastav player information forwarding podle dokumentace Velocity.
5. V configu Floodgate na proxy nastav send-floodgate-data: true.
6. Zkopíruj key.pem ze složky Floodgate na proxy do složky Floodgate na každém backend serveru a pak restartuj backendy i proxy.

send-floodgate-data: true

Drž key.pem v tajnosti: s ním projdou účty kolem Java ověřování. Nahrávej ho přes FTP v binárním režimu, jinak dostaneš chyby Tag mismatch.

Bedrock jména: prefix s tečkou

Floodgate dává před každé Bedrock jméno prefix, aby se nikdy nepletlo s Java jménem. Výchozí je tečka, takže z Xbox gamertagu Steve se na tvém serveru stane .Steve. Mezery v gamertagu se nahrazují znakem _.

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

• V příkazech používej celé jméno s prefixem. Pokud ho příkaz nepřijme, dej jméno do uvozovek: /tp ".Steve".
• Pro whitelist použij fwhitelist add Steve. Prefix tam není potřeba.
• Pokud má LuckPerms s Bedrock jmény potíže, nastav v jeho configu allow-invalid-usernames: true.

GeyserMC radí prefix ponechat. Bedrock hráči pod tímto jménem i hlasují: na BestMCServerList zadají .Steve, tedy jméno, které vidí tvůj plugin na odměny za hlasování.

Propojené účty a skiny (volitelné)

Global Linking je ve Floodgate ve výchozím stavu zapnuté. Hráči, kteří vlastní obě edice, se připojí na link.geysermc.org oběma účty a napíšou /linkaccount. Potom hrají se svým Java inventářem a pozicí z kteréhokoli zařízení, takže by si měli nejdřív přesunout své Bedrock předměty. Lokální databáze propojení potřebuje extra rozšíření Floodgate.

Floodgate převádí a nahrává Bedrock skiny, aby je Java hráči viděli. Běží to přes frontu a může to chvíli trvat.

Časté chyby a jejich řešení

Některé věci přeložit nejde: levé a pravé kliknutí v inventářích vypadá stejně, příkazy bez Brigadieru nemají doplňování tabulátorem, odkazy v chatu nejsou klikací. Otestuj menu na skutečném Bedrock zařízení. Pluginy můžou přes Floodgate API zobrazovat nativní Bedrock formuláře, což vyžaduje Floodgate na jejich serveru.

Ukaž obě adresy na BestMCServerList

Bedrock hráči se připojují přes tvou adresu plus Bedrock port, například play.example.net a 19132. BestMCServerList ukazuje Java a Bedrock adresu na každé stránce serveru zvlášť, každou s tlačítkem pro kopírování.

1. Otevři Přidat server a zadej svou Java adresu.
2. Zaškrtni Bedrock hráči jsou podporováni.
3. Zadej Bedrock port z bedrock.port. Bedrock IP nech prázdnou, pokud je stejná jako Java adresa.

Crossplay je pro nový server skutečná výhoda. Zbytek plánu najdeš v návodu, jak získat hráče pro nový server.