Java a Bedrock jsou dvě různé verze Minecraftu, které spolu samy nehrají. Plugin Geyser překládá mezi nimi, takže se na váš Java server připojí i hráči z mobilu, Windows (Bedrock), Xboxu, PlayStationu nebo Switche. S doplňkem Floodgate k tomu nepotřebují Java účet. Ukážeme instalaci, nastavení portu a každou důležitou volbu.
Co budete potřebovat
- Minecraft server u StormHostu s Paperem nebo Purpurem (případně Fabric, NeoForge nebo proxy Velocity)
- Verze Minecraftu, kterou Geyser podporuje (viz Podporované servery a verze)
- Přístup do záložek Pluginy, Soubory, Síť a Nastavení serveru
- Záloha serveru (návod)
- Asi 25 minut
Jak Geyser a Floodgate fungují#
Java Edition komunikuje přes protokol TCP, Bedrock Edition přes UDP a úplně jiným jazykem. Geyser běží jako plugin na vašem serveru, poslouchá na UDP portu pro hráče z Bedrocku a každého z nich serveru „předvede“ jako Java hráče.
| Geyser | Floodgate | |
|---|---|---|
| K čemu je | Překládá mezi Bedrockem a Javou (oběma směry). Bez něj se Bedrock hráč nepřipojí vůbec. | Pustí Bedrock hráče bez placeného Java účtu, stačí jim účet Microsoft (Xbox). |
| Povinný | Ano | Prakticky ano – bez něj musí mít každý Bedrock hráč i koupenou Java Edition. |
| Kde běží | Na serveru, kam se Bedrock hráči připojují (u sítě na proxy) | Na stejném serveru jako Geyser (u sítě na proxy, volitelně i na backendech) |
Floodgate přidává ke jménům Bedrock hráčů prefix (výchozí je tečka, například .Steve123), aby se nepletli s Java hráči stejného jména.
Omezení crossplay
Některé věci Bedrock neumí a Geyser je nepřeloží: klikací odkazy v chatu, efekt Glowing, rozlišení levého a pravého kliknutí v inventáři, víc než 6 vrstev na praporech a další. Pluginy s vlastními menu v inventáři obvykle fungují, ale vyzkoušejte je. Úplný seznam je na stránce Current Limitations (otevře se v novém okně).
Podporované servery a verze#
- Typ serveru: Paper nebo Purpur (Geyser-Spigot), Fabric a NeoForge (Geyser jako mód) nebo proxy Velocity. Na Vanille Geyser nefunguje.
- Verze Minecraftu: Geyser se k serveru připojuje jako Java klient jedné konkrétní verze. Ke dni 1. 10. 2026 podporuje Java 26.2 a Bedrock 26.30–26.51 (aktuální stav na stránce Supported versions (otevře se v novém okně)).
- Server na starší verzi (Paper nebo Purpur 1.20.5 a novější): nainstalujte navíc plugin ViaVersion. Na serveru starším než 1.20.5 Geyser jako plugin nefunguje.
- Server na novější verzi, než Geyser zatím umí (například 26.3): nejspolehlivější je počkat na aktualizaci Geyseru (sledujte stránku Supported versions), nebo nový server založit na podporované verzi. Dokumentace Geyseru počítá s ViaVersion jen pro servery starší, než je podporovaná verze. Dvojice pluginů ViaVersion a ViaBackwards může mezeru dočasně překlenout, ale oficiálně popsaná není – zkoušejte ji jen se zálohou. Katalog v záložce Pluginy vám Geyser pro takovou verzi nenabídne, soubor
Geyser-Spigot.jarbyste nahráli ručně z geysermc.org/download (otevře se v novém okně). - Geyser jako mód (Fabric, NeoForge) funguje jen na verzi, kterou Geyser právě podporuje.
- UDP port: Bedrock se připojuje přes UDP. Porty serveru u nás fungují pro TCP i UDP, takže můžete použít buď port hry, nebo další port (viz níže).
Instalace na Paper a Purpur#
Vytvořte zálohu serveru v záložce Zálohy.
Otevřete záložku Pluginy › Procházet, zvolte zdroj Modrinth a vyhledejte
Geyser.U projektu Geyser od GeyserMC klikněte na Instalovat a potvrďte.
Katalog ukazuje jen verze pro váš server. Když Geyser pro vaši verzi nenajdete, nejspíš ji zatím nepodporuje (viz výše).
Stáhněte do počítače Floodgate pro Spigot/Paper z oficiální stránky geysermc.org/download (otevře se v novém okně) (soubor
Floodgate-Spigot.jar). Na Modrinthu je Floodgate jen pro Fabric a NeoForge.V záložce Soubory otevřete složku
pluginsa soubor nahrajte tlačítkem Nahrát. V seznamu pluginů bude označený Ručně nahráno (verzi a aktualizace pak hlídáte sami).Restartujte server.
V konzoli uvidíte řádek
Started Geyser on 0.0.0.0:19132(případněStarted Geyser on UDP port 19132) a vzniknou složkyplugins/Geyser-Spigotaplugins/floodgate(v ní souborkey.pem).
Teď nastavte port a Floodgate.
Port pro hráče z Bedrocku#
Geyser ve výchozím stavu poslouchá na portu 19132. Ten ale vašemu serveru u nás nepatří, takže se na něj nikdo nepřipojí. Vyberte jednu ze dvou variant:
| Varianta A: stejný port jako Java | Varianta B: samostatný port | |
|---|---|---|
| Co hráči zadají | Stejnou adresu a port jako Java hráči | Stejnou adresu, ale jiný port |
| Výhoda | Jednodušší, nespotřebuje další port | Nekoliduje s jinými UDP službami |
| Nevýhoda | Na portu hry nesmí běžet Query ani jiný UDP plugin | Spotřebuje jeden z dalších portů |
| Kdy použít | Většina serverů | Máte zapnuté Query nebo plugin s UDP (hlasový chat) na portu hry |
Java hra používá TCP a Bedrock UDP, proto mohou sdílet stejné číslo portu.
Varianta A: stejný port jako Java#
V záložce Soubory otevřete
plugins/.Geyser-Spigot/ config. yml V sekci
bedrocknastavteclone-remote-port: true:plugins/ Geyser-Spigot/ YAMLconfig.yml bedrock: address: 0.0.0.0 port: 19132 clone-remote-port: trueHodnotu
portneměňte – při zapnutémclone-remote-portji Geyser při každém startu nahradí portem Java serveru.Uložte soubor (Ctrl+S).
Varianta B: samostatný port#
V záložce Síť v části Další porty klikněte na Přidat port a zapamatujte si nové číslo.
V záložce Soubory otevřete
plugins/.Geyser-Spigot/ config. yml V sekci
bedrockzadejte nový port aclone-remote-portnechte vypnuté:plugins/ Geyser-Spigot/ YAMLconfig.yml bedrock: address: 0.0.0.0 port: <PORT> clone-remote-port: falseZa
<PORT>dosaďte číslo portu ze záložky Síť bez špičatých závorek, například27015.Uložte soubor.
Nastavení Floodgate#
V
plugins/najděte sekciGeyser-Spigot/ config. yml javaa nastavteauth-type:plugins/ Geyser-Spigot/ YAMLconfig.yml java: auth-type: floodgateVe starších verzích Geyseru se sekce jmenuje
remotemístojava. Nastavení je stejné.V záložce Nastavení serveru vypněte ve skupině Hráči volbu Vyžadovat podepsaný chat (
enforce-secure-profile=). Bedrock nepodporuje podepisování chatu a hráči z Bedrocku by jinak nemohli psát do chatu.false Klikněte na Uložit a restartovat.
Nejdůležitější volby v config.yml Geyseru#
| Nastavení | Co dělá | Doporučená hodnota | Kdy změnit |
|---|---|---|---|
bedrock.address | Na jaké IP adrese Geyser poslouchá. 0.0.0.0 = na všech. | 0.0.0.0 | Neměňte. |
bedrock.port | UDP port pro hráče z Bedrocku. | Port serveru (varianta B) | Při změně portu. |
bedrock. | Použije port Java serveru (varianta A). | true pro variantu A, jinak false | Při přechodu mezi variantami. |
java.auth-type | Jak se Bedrock hráči přihlašují: floodgate (bez Java účtu), online (musí mít Java účet), offline (bez ověření, nebezpečné). | floodgate | online jen bez Floodgate. offline nikdy na veřejném serveru. |
motd.primary-motd, motd.secondary-motd | První a druhý řádek popisu v seznamu serverů na Bedrocku. | Váš popis | Použije se jen při passthrough-motd: false. |
motd.passthrough-motd | Převezme MOTD z Java serveru. | true | false, když chcete pro Bedrock jiný popis. |
motd. | Převezme počet hráčů a slotů z Java serveru. | true | Neměňte. |
gameplay.server-name | Název serveru v menu pauzy a nastavení na Bedrocku. | Název vašeho serveru | Kdykoli. |
gameplay. | Zobrazí Bedrock hráčům souřadnice. | true | false na serverech, kde mají být souřadnice tajné (Java hráči je mají přes F3 vždy). |
gameplay. | Posílá Bedrock hráčům nápovědu příkazů. Při stovkách příkazů (hodně pluginů) může Bedrock při prvním otevření příkazového řádku zamrznout. | true | false, když hráčům z Bedrocku zamrzá hra po napsání /. |
gameplay. | Povolí hráčům z Bedrocku odemykat Xbox achievementy. Neznámý příkaz pak hráč uvidí jako hlášku, že jsou cheaty vypnuté, ostatní příkazy fungují. | false | true, když o achievementy hráči stojí. |
Nový způsob připojení Bedrocku
Nejnovější verze Geyseru mají v sekci bedrock i volbu transport pro nový způsob připojení Bedrock klientů (NetherNet). Výchozí hodnotu raknet neměňte, dokud ji Geyser ve své dokumentaci nedoporučí změnit.
Floodgate: config.yml#
Soubor plugins/:
| Nastavení | Co dělá | Doporučená hodnota | Kdy změnit |
|---|---|---|---|
username-prefix | Prefix před jménem Bedrock hráče. | "." | Neměňte. Bez prefixu hrozí, že Java a Bedrock hráč budou mít stejné jméno, a pak nefunguje teleport, bany ani oprávnění. |
replace-spaces | Nahradí mezery v Xbox jménu podtržítkem. | true | Neměňte – jména s mezerou rozbijí většinu příkazů. |
key-file-name | Soubor s klíčem, kterým Geyser a Floodgate ověřují data hráčů. | key.pem | Neměňte. |
player-link.enabled | Povolí propojení Java a Bedrock účtu jednoho hráče (sdílí pak inventář a data). | true | false, pokud propojení nechcete. |
player-link.require-link | Pustí jen Bedrock hráče s propojeným Java účtem. | false | true jen na serverech, kde chcete Bedrock hráče svázat s Java účtem. |
key.pem nikomu neposílejte
Soubor key.pem umožňuje přihlásit se na server jako jakýkoli Bedrock hráč bez ověření. Nesdílejte ho, nedávejte ho do veřejných záloh ani na GitHub.
Připojení z Bedrocku#
Hráči z Bedrocku zadávají adresu a port zvlášť (Bedrock nepoužívá SRV záznamy).
| Pole | Co zadat |
|---|---|
| Server Name | Libovolný název, například Muj server. |
| Server Address | IP adresa serveru ze záložky Síť (bez portu), nebo naše subdoména ze záložky Doména, nebo vaše vlastní doména. |
| Port | Varianta A: port hry ze záložky Síť. Varianta B: port nastavený v bedrock.port. |
Postup ve hře: Play › záložka Servers › Add Server, vyplnit pole a Save. Podrobně o adresách a doménách v návodu Adresa serveru a doména.
Konzole (Xbox, PlayStation, Switch)#
Konzole dovolují připojení jen k vybraným serverům. Na jiné servery se hráči dostanou přes neoficiální obejití, typicky službu BedrockConnect (změna DNS v nastavení sítě konzole) nebo aplikace, které server zpřístupní v místní síti. Postupy pro jednotlivé konzole popisuje dokumentace Geyseru na stránce Using Geyser with Consoles (otevře se v novém okně). Tyto služby neprovozujeme a jejich funkčnost nezaručujeme.
Whitelist a oprávnění pro Bedrock hráče#
Whitelist: použijte příkaz Floodgate
fwhitelistbez prefixu:text fwhitelist add Steve123 fwhitelist remove Steve123fwhitelist add– přidá Bedrock hráče na whitelist (dowhitelist.json).Steve123– Xbox jméno hráče bez tečky na začátku.
Běžný
whitelist addpro Bedrock hráče nefunguje, protože jejich jména nejsou v databázi Java účtů.Příkazy na hráče (teleport, ban) píšete se jménem včetně prefixu, například
tp .Steve123.LuckPerms: jména s tečkou LuckPerms ve výchozím stavu odmítá. V
plugins/nastavteLuckPerms/ config. yml allow-invalid-usernames: truea server restartujte (LuckPerms).
Geyser na proxy Velocity#
Na síti serverů za proxy instalujte Geyser a Floodgate jen na proxy. Bedrock hráči se připojují na port proxy a proxy je rozdělí na servery.
- Na Velocity nainstalujte Geyser a Floodgate pro Velocity (oba z geysermc.org/download (otevře se v novém okně)).
- V konfiguraci Geyseru na proxy nastavte port (varianta A nebo B jako výše) a
auth-type: floodgate. - V
velocity.tomlnastavteforce-key-authentication = false, jinak hráči z Bedrocku nebudou moci psát do chatu. - Všechny servery za proxy musí přijímat Java klienta verze, kterou Geyser podporuje – případně na nich nainstalujte ViaVersion.
Floodgate na serverech za proxy potřebujete jen tehdy, když jeho data využívají pluginy na těchto serverech. Pak na proxy v plugins/ (podsložka podle platformy) zapněte send-floodgate-data: true, nainstalujte Floodgate na backendy a zkopírujte na ně key.pem z proxy. Podrobně v návodu Síť serverů přes Velocity.
Geyser na Fabric a NeoForge#
- V záložce Módy › Procházet nainstalujte Geyser (u Fabricu se automaticky doplní povinný Fabric API).
- Nainstalujte Floodgate (na Modrinthu je pro Fabric i NeoForge).
- Restartujte server a nastavte port a
auth-typestejně jako výše. Konfigurace Geyseru je v souboruconfig/(u NeoForgeGeyser-Fabric/ config. yml config/).Geyser-NeoForge/ config. yml
Geyser jako mód podporuje jen jednu, nejnovější podporovanou verzi Minecraftu. Pro starší modovaný server ho nepoužijete.
Ověření#
Po restartu hledejte v konzoli řádek
Started Geyser on …s vaším portem.V konzoli spusťte test dostupnosti:
text geyser connectiontest <IP_ADRESA> <PORT>geyser connectiontest– ověří, jestli je Geyser zvenku dosažitelný, a případně poradí, co je špatně.<IP_ADRESA>– IP adresa serveru ze záložky Síť.<PORT>– Bedrock port (varianta A: port hry, varianta B: váš další port).
Server zkontrolujte nástrojem Minecraft Status v režimu Bedrock.
Připojte se z Bedrocku. Po připojení uvidíte v konzoli řádek, že se hráč s prefixem připojil, a v příkazu
geyser listjeho jméno.
Když něco nefunguje#
Bedrock: Unable to connect to world#
Nejčastější chyba. Projděte postupně:
- Hráč zadal špatný port. Varianta A: port hry, varianta B: port z
bedrock.port. Port19132u nás nefunguje. - Geyser neběží na portu, kde čekáte. V konzoli zkontrolujte řádek
Started Geyser on …. - Na stejném UDP portu běží něco jiného (Query, hlasový chat). Přejděte na variantu B.
- Spusťte
geyser connectiontest(viz Ověření) a řiďte se jeho radou. - Na mobilu zkuste hru úplně zavřít a znovu otevřít.
- Dokumentace Geyseru uvádí, že porty pod 10 000 někdy dělají potíže. Pokud máte možnost, zvolte vyšší port.
Outdated Bedrock client! This server supports the following Bedrock versions: …#
Hráč má jinou verzi Bedrocku, než Geyser podporuje. Hráč si aktualizuje hru, nebo aktualizujte Geyser (v záložce Pluginy › Zkontrolovat aktualizace; Floodgate nahraný ručně aktualizujete ručně).
This server does not support Java Edition …, which is required for Geyser to connect.#
Verze serveru se liší od verze, kterou Geyser emuluje. Nainstalujte ViaVersion (u novějšího serveru i ViaBackwards), nebo aktualizujte Geyser.
This server requires a paid Java account.#
Geyser má auth-type: online nebo Floodgate neběží. Nainstalujte Floodgate, nastavte auth-type: floodgate a restartujte.
Please log into Xbox to join this server.#
Hráč není ve hře přihlášený účtem Microsoft. Floodgate vyžaduje Xbox účet – hráč se přihlásí v nastavení hry.
Tried to log in as a Java Edition player! Is Floodgate set up correctly?#
Floodgate na serveru neběží nebo se nenačetl. V konzoli při startu hledejte chyby Floodgate a ověřte, že je ve složce plugins soubor pro Spigot/Paper.
javax.crypto.AEADBadTagException: Tag mismatch! #
Geyser a Floodgate používají jiný klíč. Vypněte server, smažte složku plugins/floodgate a případný soubor s klíčem ve složce Geyseru a server spusťte – klíč se vytvoří znovu.
Hráči z Bedrocku nemohou psát do chatu#
Je zapnuté enforce-secure-profile (na proxy Velocity force-key-authentication). Vypněte ho a restartujte.
Bedrock hráč není na whitelistu#
Přidejte ho příkazem fwhitelist add <NICK> bez tečky, ne příkazem whitelist add.
Shrnutí
- Geyser překládá Bedrock na Java, Floodgate pustí Bedrock hráče bez Java účtu (
auth-type: floodgate). - Port 19132 u nás nepoužijete: buď
clone-remote-port: true(stejný port jako Java), nebo další port ze záložky Síť. - Na portu Geyseru nesmí běžet Query ani jiný UDP plugin.
- Vypněte
enforce-secure-profile, jinak Bedrock hráči nenapíšou do chatu. - Bedrock hráči zadávají adresu i port zvlášť, whitelist přes
fwhitelist. key.pemnikomu nedávejte.