Java a Bedrock sú dve rôzne verzie Minecraftu, ktoré spolu samy nehrajú. Plugin Geyser medzi nimi prekladá, takže sa na váš Java server pripoja aj hráči z mobilu, Windows (Bedrock), Xboxu, PlayStationu alebo Switchu. S doplnkom Floodgate k tomu nepotrebujú Java účet. Ukážeme inštaláciu, nastavenie portu a každú dôležitú voľbu.
Čo budete potrebovať
- Minecraft server u StormHostu s Paperom alebo Purpurom (prípadne Fabric, NeoForge alebo proxy Velocity)
- Verzia Minecraftu, ktorú Geyser podporuje (pozrite Podporované servery a verzie)
- Prístup do záložiek Pluginy, Súbory, Sieť a Nastavenia servera
- Záloha servera (návod)
- Asi 25 minút
Ako Geyser a Floodgate fungujú#
Java Edition komunikuje cez protokol TCP, Bedrock Edition cez UDP a úplne iným jazykom. Geyser beží ako plugin na vašom serveri, počúva na UDP porte pre hráčov z Bedrocku a každého z nich serveru „predvedie“ ako Java hráča.
| Geyser | Floodgate | |
|---|---|---|
| Na čo je | Prekladá medzi Bedrockom a Javou (oboma smermi). Bez neho sa Bedrock hráč nepripojí vôbec. | Pustí Bedrock hráčov bez plateného Java účtu, stačí im účet Microsoft (Xbox). |
| Povinný | Áno | Prakticky áno – bez neho musí mať každý Bedrock hráč aj kúpenú Java Edition. |
| Kde beží | Na serveri, kam sa Bedrock hráči pripájajú (pri sieti na proxy) | Na rovnakom serveri ako Geyser (pri sieti na proxy, voliteľne aj na backendoch) |
Floodgate pridáva k menám Bedrock hráčov prefix (predvolená je bodka, napríklad .Steve123), aby sa nepliedli s Java hráčmi rovnakého mena.
Obmedzenia crossplay
Niektoré veci Bedrock nevie a Geyser ich nepreloží: klikacie odkazy v chate, efekt Glowing, rozlíšenie ľavého a pravého kliknutia v inventári, viac než 6 vrstiev na zástavách a ďalšie. Pluginy s vlastnými menu v inventári zvyčajne fungujú, ale vyskúšajte ich. Úplný zoznam je na stránke Current Limitations (otvorí sa v novom okne).
Podporované servery a verzie#
- Typ servera: Paper alebo Purpur (Geyser-Spigot), Fabric a NeoForge (Geyser ako mod) alebo proxy Velocity. Na Vanille Geyser nefunguje.
- Verzia Minecraftu: Geyser sa k serveru pripája ako Java klient jednej konkrétnej verzie. K 1. 10. 2026 podporuje Java 26.2 a Bedrock 26.30–26.51 (aktuálny stav na stránke Supported versions (otvorí sa v novom okne)).
- Server na staršej verzii (Paper alebo Purpur 1.20.5 a novší): nainštalujte navyše plugin ViaVersion. Na serveri staršom než 1.20.5 Geyser ako plugin nefunguje.
- Server na novšej verzii, než Geyser zatiaľ vie (napríklad 26.3): najspoľahlivejšie je počkať na aktualizáciu Geyseru (sledujte stránku Supported versions), alebo nový server založiť na podporovanej verzii. Dokumentácia Geyseru počíta s ViaVersion iba pre servery staršie, než je podporovaná verzia. Dvojica pluginov ViaVersion a ViaBackwards môže medzeru dočasne preklenúť, ale oficiálne opísaná nie je – skúšajte ju iba so zálohou. Katalóg v záložke Pluginy vám Geyser pre takú verziu neponúkne, súbor
Geyser-Spigot.jarby ste nahrali ručne z geysermc.org/download (otvorí sa v novom okne). - Geyser ako mod (Fabric, NeoForge) funguje iba na verzii, ktorú Geyser práve podporuje.
- UDP port: Bedrock sa pripája cez UDP. Porty servera u nás fungujú pre TCP aj UDP, takže môžete použiť buď port hry, alebo ďalší port (pozrite nižšie).
Inštalácia na Paper a Purpur#
Vytvorte zálohu servera v záložke Zálohy.
Otvorte záložku Pluginy › Prechádzať, zvoľte zdroj Modrinth a vyhľadajte
Geyser.Pri projekte Geyser od GeyserMC kliknite na Inštalovať a potvrďte.
Katalóg ukazuje iba verzie pre váš server. Keď Geyser pre svoju verziu nenájdete, najskôr ju zatiaľ nepodporuje (pozrite vyššie).
Stiahnite do počítača Floodgate pre Spigot/Paper z oficiálnej stránky geysermc.org/download (otvorí sa v novom okne) (súbor
Floodgate-Spigot.jar). Na Modrinthe je Floodgate iba pre Fabric a NeoForge.V záložke Súbory otvorte priečinok
pluginsa súbor nahrajte tlačidlom Nahrať. V zozname pluginov bude označený Ručne nahrané (verziu a aktualizácie potom strážite sami).Reštartujte server.
V konzole uvidíte riadok
Started Geyser on 0.0.0.0:19132(prípadneStarted Geyser on UDP port 19132) a vzniknú priečinkyplugins/Geyser-Spigotaplugins/floodgate(v ňom súborkey.pem).
Teraz nastavte port a Floodgate.
Port pre hráčov z Bedrocku#
Geyser v predvolenom stave počúva na porte 19132. Ten však vášmu serveru u nás nepatrí, takže sa naň nikto nepripojí. Vyberte jeden z dvoch variantov:
| Variant A: rovnaký port ako Java | Variant B: samostatný port | |
|---|---|---|
| Čo hráči zadajú | Rovnakú adresu a port ako Java hráči | Rovnakú adresu, ale iný port |
| Výhoda | Jednoduchšie, nespotrebuje ďalší port | Nekoliduje s inými UDP službami |
| Nevýhoda | Na porte hry nesmie bežať Query ani iný UDP plugin | Spotrebuje jeden z ďalších portov |
| Kedy použiť | Väčšina serverov | Máte zapnuté Query alebo plugin s UDP (hlasový chat) na porte hry |
Java hra používa TCP a Bedrock UDP, preto môžu zdieľať rovnaké číslo portu.
Variant A: rovnaký port ako Java#
V záložke Súbory otvorte
plugins/.Geyser-Spigot/ config. yml V sekcii
bedrocknastavteclone-remote-port: true:plugins/ Geyser-Spigot/ YAMLconfig.yml bedrock: address: 0.0.0.0 port: 19132 clone-remote-port: trueHodnotu
portnemeňte – pri zapnutomclone-remote-portju Geyser pri každom štarte nahradí portom Java servera.Uložte súbor (Ctrl+S).
Variant B: samostatný port#
V záložke Sieť v časti Ďalšie porty kliknite na Pridať port a zapamätajte si nové číslo.
V záložke Súbory otvorte
plugins/.Geyser-Spigot/ config. yml V sekcii
bedrockzadajte nový port aclone-remote-portnechajte vypnuté:plugins/ Geyser-Spigot/ YAMLconfig.yml bedrock: address: 0.0.0.0 port: <PORT> clone-remote-port: falseZa
<PORT>dosaďte číslo portu zo záložky Sieť bez lomených zátvoriek, napríklad27015.Uložte súbor.
Nastavenie Floodgate#
V
plugins/nájdite sekciuGeyser-Spigot/ config. yml javaa nastavteauth-type:plugins/ Geyser-Spigot/ YAMLconfig.yml java: auth-type: floodgateV starších verziách Geyseru sa sekcia volá
remotenamiestojava. Nastavenie je rovnaké.V záložke Nastavenia servera vypnite v skupine Hráči voľbu Vyžadovať podpísaný chat (
enforce-secure-profile=). Bedrock nepodporuje podpisovanie chatu a hráči z Bedrocku by inak nemohli písať do chatu.false Kliknite na Uložiť a reštartovať.
Najdôležitejšie voľby v config.yml Geyseru#
| Nastavenie | Čo robí | Odporúčaná hodnota | Kedy zmeniť |
|---|---|---|---|
bedrock.address | Na akej IP adrese Geyser počúva. 0.0.0.0 = na všetkých. | 0.0.0.0 | Nemeňte. |
bedrock.port | UDP port pre hráčov z Bedrocku. | Port servera (variant B) | Pri zmene portu. |
bedrock. | Použije port Java servera (variant A). | true pre variant A, inak false | Pri prechode medzi variantmi. |
java.auth-type | Ako sa Bedrock hráči prihlasujú: floodgate (bez Java účtu), online (musia mať Java účet), offline (bez overenia, nebezpečné). | floodgate | online iba bez Floodgate. offline nikdy na verejnom serveri. |
motd.primary-motd, motd.secondary-motd | Prvý a druhý riadok popisu v zozname serverov na Bedrocku. | Váš popis | Použije sa iba pri passthrough-motd: false. |
motd.passthrough-motd | Prevezme MOTD z Java servera. | true | false, keď chcete pre Bedrock iný popis. |
motd. | Prevezme počet hráčov a slotov z Java servera. | true | Nemeňte. |
gameplay.server-name | Názov servera v menu pauzy a nastaveniach na Bedrocku. | Názov vášho servera | Kedykoľvek. |
gameplay. | Zobrazí Bedrock hráčom súradnice. | true | false na serveroch, kde majú byť súradnice tajné (Java hráči ich majú cez F3 vždy). |
gameplay. | Posiela Bedrock hráčom nápovedu príkazov. Pri stovkách príkazov (veľa pluginov) môže Bedrock pri prvom otvorení príkazového riadka zamrznúť. | true | false, keď hráčom z Bedrocku zamŕza hra po napísaní /. |
gameplay. | Povolí hráčom z Bedrocku odomykať Xbox achievementy. Neznámy príkaz potom hráč uvidí ako hlášku, že sú cheaty vypnuté, ostatné príkazy fungujú. | false | true, keď o achievementy hráči stoja. |
Nový spôsob pripojenia Bedrocku
Najnovšie verzie Geyseru majú v sekcii bedrock aj voľbu transport pre nový spôsob pripojenia Bedrock klientov (NetherNet). Predvolenú hodnotu raknet nemeňte, kým ju Geyser vo svojej dokumentácii neodporučí zmeniť.
Floodgate: config.yml#
Súbor plugins/:
| Nastavenie | Čo robí | Odporúčaná hodnota | Kedy zmeniť |
|---|---|---|---|
username-prefix | Prefix pred menom Bedrock hráča. | "." | Nemeňte. Bez prefixu hrozí, že Java a Bedrock hráč budú mať rovnaké meno, a potom nefunguje teleport, bany ani oprávnenia. |
replace-spaces | Nahradí medzery v Xbox mene podčiarkovníkom. | true | Nemeňte – mená s medzerou rozbijú väčšinu príkazov. |
key-file-name | Súbor s kľúčom, ktorým Geyser a Floodgate overujú dáta hráčov. | key.pem | Nemeňte. |
player-link.enabled | Povolí prepojenie Java a Bedrock účtu jedného hráča (zdieľa potom inventár a dáta). | true | false, ak prepojenie nechcete. |
player-link.require-link | Pustí iba Bedrock hráčov s prepojeným Java účtom. | false | true iba na serveroch, kde chcete Bedrock hráčov zviazať s Java účtom. |
key.pem nikomu neposielajte
Súbor key.pem umožňuje prihlásiť sa na server ako akýkoľvek Bedrock hráč bez overenia. Nezdieľajte ho, nedávajte ho do verejných záloh ani na GitHub.
Pripojenie z Bedrocku#
Hráči z Bedrocku zadávajú adresu a port zvlášť (Bedrock nepoužíva záznamy SRV).
| Pole | Čo zadať |
|---|---|
| Server Name | Ľubovoľný názov, napríklad Moj server. |
| Server Address | IP adresa servera zo záložky Sieť (bez portu), alebo naša subdoména zo záložky Doména, alebo vaša vlastná doména. |
| Port | Variant A: port hry zo záložky Sieť. Variant B: port nastavený v bedrock.port. |
Postup v hre: Play › záložka Servers › Add Server, vyplniť polia a Save. Podrobne o adresách a doménach v návode Adresa servera a doména.
Konzoly (Xbox, PlayStation, Switch)#
Konzoly dovoľujú pripojenie iba k vybraným serverom. Na iné servery sa hráči dostanú cez neoficiálne obídenie, typicky službu BedrockConnect (zmena DNS v nastaveniach siete konzoly) alebo aplikácie, ktoré server sprístupnia v miestnej sieti. Postupy pre jednotlivé konzoly opisuje dokumentácia Geyseru na stránke Using Geyser with Consoles (otvorí sa v novom okne). Tieto služby neprevádzkujeme a ich funkčnosť nezaručujeme.
Whitelist a oprávnenia pre Bedrock hráčov#
Whitelist: použite príkaz Floodgate
fwhitelistbez prefixu:text fwhitelist add Steve123 fwhitelist remove Steve123fwhitelist add– pridá Bedrock hráča na whitelist (dowhitelist.json).Steve123– Xbox meno hráča bez bodky na začiatku.
Bežný
whitelist addpre Bedrock hráčov nefunguje, pretože ich mená nie sú v databáze Java účtov.Príkazy na hráčov (teleport, ban) píšete s menom vrátane prefixu, napríklad
tp .Steve123.LuckPerms: mená s bodkou LuckPerms v predvolenom stave odmieta. V
plugins/nastavteLuckPerms/ config. yml allow-invalid-usernames: truea server reštartujte (LuckPerms).
Geyser na proxy Velocity#
V sieti serverov za proxy inštalujte Geyser a Floodgate iba na proxy. Bedrock hráči sa pripájajú na port proxy a proxy ich rozdelí na servery.
- Na Velocity nainštalujte Geyser a Floodgate pre Velocity (oba z geysermc.org/download (otvorí sa v novom okne)).
- V konfigurácii Geyseru na proxy nastavte port (variant A alebo B ako vyššie) a
auth-type: floodgate. - V
velocity.tomlnastavteforce-key-authentication = false, inak hráči z Bedrocku nebudú môcť písať do chatu. - Všetky servery za proxy musia prijímať Java klienta verzie, ktorú Geyser podporuje – prípadne na nich nainštalujte ViaVersion.
Floodgate na serveroch za proxy potrebujete iba vtedy, keď jeho dáta využívajú pluginy na týchto serveroch. Potom na proxy v plugins/ (podpriečinok podľa platformy) zapnite send-floodgate-data: true, nainštalujte Floodgate na backendy a skopírujte na ne key.pem z proxy. Podrobne v návode Sieť serverov cez Velocity.
Geyser na Fabric a NeoForge#
- V záložke Mody › Prechádzať nainštalujte Geyser (pri Fabricu sa automaticky doplní povinný Fabric API).
- Nainštalujte Floodgate (na Modrinthe je pre Fabric aj NeoForge).
- Reštartujte server a nastavte port a
auth-typerovnako ako vyššie. Konfigurácia Geyseru je v súboreconfig/(pri NeoForgeGeyser-Fabric/ config. yml config/).Geyser-NeoForge/ config. yml
Geyser ako mod podporuje iba jednu, najnovšiu podporovanú verziu Minecraftu. Pre starší modovaný server ho nepoužijete.
Overenie#
Po reštarte hľadajte v konzole riadok
Started Geyser on …s vaším portom.V konzole spustite test dostupnosti:
text geyser connectiontest <IP_ADRESA> <PORT>geyser connectiontest– overí, či je Geyser zvonka dosiahnuteľný, a prípadne poradí, čo je zle.<IP_ADRESA>– IP adresa servera zo záložky Sieť.<PORT>– Bedrock port (variant A: port hry, variant B: váš ďalší port).
Server skontrolujte nástrojom Minecraft Status v režime Bedrock.
Pripojte sa z Bedrocku. Po pripojení uvidíte v konzole riadok, že sa hráč s prefixom pripojil, a v príkaze
geyser listjeho meno.
Keď niečo nefunguje#
Bedrock: Unable to connect to world#
Najčastejšia chyba. Prejdite postupne:
- Hráč zadal zlý port. Variant A: port hry, variant B: port z
bedrock.port. Port19132u nás nefunguje. - Geyser nebeží na porte, kde čakáte. V konzole skontrolujte riadok
Started Geyser on …. - Na rovnakom UDP porte beží niečo iné (Query, hlasový chat). Prejdite na variant B.
- Spustite
geyser connectiontest(pozrite Overenie) a riaďte sa jeho radou. - Na mobile skúste hru úplne zavrieť a znova otvoriť.
- Dokumentácia Geyseru uvádza, že porty pod 10 000 niekedy robia problémy. Ak máte možnosť, zvoľte vyšší port.
Outdated Bedrock client! This server supports the following Bedrock versions: …#
Hráč má inú verziu Bedrocku, než Geyser podporuje. Hráč si aktualizuje hru, alebo aktualizujte Geyser (v záložke Pluginy › Skontrolovať aktualizácie; Floodgate nahraný ručne aktualizujete ručne).
This server does not support Java Edition …, which is required for Geyser to connect.#
Verzia servera sa líši od verzie, ktorú Geyser emuluje. Nainštalujte ViaVersion (pri novšom serveri aj ViaBackwards), alebo aktualizujte Geyser.
This server requires a paid Java account.#
Geyser má auth-type: online alebo Floodgate nebeží. Nainštalujte Floodgate, nastavte auth-type: floodgate a reštartujte.
Please log into Xbox to join this server.#
Hráč nie je v hre prihlásený účtom Microsoft. Floodgate vyžaduje Xbox účet – hráč sa prihlási v nastaveniach hry.
Tried to log in as a Java Edition player! Is Floodgate set up correctly?#
Floodgate na serveri nebeží alebo sa nenačítal. V konzole pri štarte hľadajte chyby Floodgate a overte, že je v priečinku plugins súbor pre Spigot/Paper.
javax.crypto.AEADBadTagException: Tag mismatch! #
Geyser a Floodgate používajú iný kľúč. Vypnite server, zmažte priečinok plugins/floodgate a prípadný súbor s kľúčom v priečinku Geyseru a server spustite – kľúč sa vytvorí znova.
Hráči z Bedrocku nemôžu písať do chatu#
Je zapnuté enforce-secure-profile (na proxy Velocity force-key-authentication). Vypnite ho a reštartujte.
Bedrock hráč nie je na whiteliste#
Pridajte ho príkazom fwhitelist add <NICK> bez bodky, nie príkazom whitelist add.
Zhrnutie
- Geyser prekladá Bedrock na Java, Floodgate pustí Bedrock hráčov bez Java účtu (
auth-type: floodgate). - Port 19132 u nás nepoužijete: buď
clone-remote-port: true(rovnaký port ako Java), alebo ďalší port zo záložky Sieť. - Na porte Geyseru nesmie bežať Query ani iný UDP plugin.
- Vypnite
enforce-secure-profile, inak Bedrock hráči nenapíšu do chatu. - Bedrock hráči zadávajú adresu aj port zvlášť, whitelist cez
fwhitelist. key.pemnikomu nedávajte.