Wat Geyser a Floodgate maachen
Geyser iwwersetzt tëscht deenen zwou Editiounen. Géintiwwer dengem Server verhält et sech wéi e Java-Client, also funktionéieren Redstone, Farmen a Plugins genee esou wéi fir Java-Spiller. Floodgate léisst Bedrock-Spiller sech mat hirem Xbox-Kont aloggen amplaz mat engem Java-Kont.
| Plugin | Aufgab | Wou et leeft |
|---|---|---|
| Geyser | Hëlt Bedrock-Verbindungen op engem UDP-Port un an iwwersetzt se | Paper/Spigot-Server, oder de Proxy an engem Netzwierk |
| Floodgate | Login ouni Java-Kont, Bedrock-Nimm a Skins | Op der selwechter Plaz wéi Geyser, optional op Backend-Serveren |
Ier s de ufänks: Java a Versiounen
- Geyser brauch Java 21 oder méi nei op der Maschinn, op där et leeft.
- Däi Server muss déi neist Java-Versioun unhuelen, well Geyser esou e Client imitéiert. Méi al Serveren brauchen ViaVersion.
- Geyser-Spigot leeft op Paper a Spigot vun 1.20.5 un. Méi al Serveren brauchen e Proxy, Geyser Standalone oder ViaProxy.
- Just aktuell Bedrock-Versioune ginn ënnerstëtzt (Oktober 2026: Bedrock 26.30 bis 26.52, Java 26.2). Hal Geyser um neiste Stand, well Bedrock sech selwer updatet.
Lued Geyser a Floodgate fir deng Plattform vun der offizieller GeyserMC-Download-Säit erof.
Astellung op engem eenzele Paper- oder Spigot-Server
- Setz
Geyser-Spigot.jaranFloodgate-Spigot.jaran de Dossierplugins. - Start de Server nei. Geyser mécht
plugins/Geyser-Spigot/config.yml, Floodgate méchtplugins/floodgate/matconfig.ymlan engemkey.pem. - Maach d’Geyser-Config op a kuck d’Sektioun
bedrockno. Deportass dat, wat Bedrock-Spiller antippen. - Setz den Authentifizéierungstyp op
floodgatea start nach eng Kéier nei.
bedrock:
address: 0.0.0.0
port: 19132
clone-remote-port: false
java:
auth-type: floodgateMéi al Geyser-Configs nennen déi zweet Sektioun remote, d’Astellung heescht do also remote.auth-type. Aktuell Builds wiessele vu selwer op Floodgate, wann et um selwechte Server leeft; et ze setze schuet net.
Op engem eenzele Server kopéiers de key.pem néierens hin. Geyser liest en vu Floodgate, an eng iwwreg Kopie am Geyser-Dossier mécht Login-Feeler.
Maach de Bedrock-Port fir UDP op
Java benotzt TCP, Bedrock benotzt UDP. Déi meescht futtis Setups scheiteren hei.
- Hosting-Panel: füüg en extra Port derbäi (vill Hoster nennen dat eng Allocation) a dro en als
bedrock.portan. Verschidden Hoster verlaangen, datt Bedrock dee selwechte Port wéi Java benotzt, oder änneren de Java-Port bei all Start; do suergtclone-remote-port: truedofir, datt Geyser de Java-Port hëlt. D’Geyser-Setup-Säit huet Uleedunge fir vill Hoster. - Pterodactyl: wies de Port dem Server am Network-Tab zou.
- Eege Maschinn oder VPS: maach de Port fir UDP an der Firewall op an, doheem, och am Router. OVH an Oracle Cloud blockéieren UDP och an hirer eegener Firewall.
sudo ufw allow 19132/udp
sudo ufw reloadVoice-Chat-Plugins oder Query kënnen de Port net mat Geyser deelen. Soubal de Port op ass, lanz geyser connectiontest <ip> <port> an der Konsol; dat kontrolléiert de Port a proposéiert Léisungen.
Astellung an engem Velocity- oder BungeeCord-Netzwierk
An engem Netzwierk verbanne sech Bedrock-Spiller grad wéi Java-Spiller mam Proxy. Geyser leeft dofir just um Proxy.
- Installéier Geyser a Floodgate fir däi Proxy (Velocity oder BungeeCord) a start de Proxy nei.
- Setz de
bedrock.portan den Authentifizéierungstypfloodgatean der Geyser-Config um Proxy, a maach de Port fir UDP op, wéi uewe beschriwwen. - Installéier Floodgate-Spigot op all Backend. Dat ass néideg fir Plugins, déi d’Floodgate-API benotzen, a mécht d’Skins besser.
- Stell d’Forwarding an: op BungeeCord setz
ip_forward: truea sengerconfig.ymlanbungeecord: truean derspigot.ymlvun all Backend; op Velocity stell de Player Information Forwarding an, wéi et an der Velocity-Dokumentatioun steet. - An der Floodgate-Config um Proxy setz
send-floodgate-data: true. - Kopéier
key.pemaus dem Floodgate-Dossier vum Proxy an de Floodgate-Dossier vun all Backend-Server, a start duerno d’Backends an de Proxy nei.
send-floodgate-data: trueHal key.pem geheim: domat kommen Konten un der Java-Authentifizéierung laanscht. Lued en iwwer FTP am Binärmodus erop, soss kriss de Tag mismatch-Feeler.
Bedrock-Nimm: de Punkt-Prefix
Floodgate setzt e Prefix virun all Bedrock-Numm, sou datt en ni mat engem Java-Numm kollidéiere kann. Standard ass e Punkt, also gëtt den Xbox-Gamertag Steve op dengem Server zu .Steve. Espacen a Gamertage ginn duerch _ ersat.
username-prefix: "."
replace-spaces: true- A Commanden benotz de ganzen Numm mam Prefix. Wann e Command en net unhëlt, setz den Numm an Ufierungszeechen:
/tp ".Steve". - Fir d’Whitelist benotz
fwhitelist add Steve. Do brauchs de de Prefix net. - Wann LuckPerms Problemer mat Bedrock-Nimm huet, setz
allow-invalid-usernames: truea senger Config.
GeyserMC roden, de Prefix ze halen. Bedrock-Spiller vote och mat dësem Numm: op BestMCServerList ginn se .Steve an, den Numm, deen däi Vote-Belounungs-Plugin gesäit.
Verlinkte Konten a Skins (optional)
Global Linking ass a Floodgate standardméisseg aktivéiert. Spiller, déi béid Editiounen hunn, ginn mat béide Konten op link.geysermc.org an tippen /linkaccount. Duerno spille se vun all Apparat aus mat hirem Java-Inventar an hirer Java-Positioun, also sollte se hir Bedrock-Saachen éischter réckelen. Eng lokal Link-Datebank brauch eng extra Floodgate-Extensioun.
Floodgate konvertéiert Bedrock-Skins a luet se erop, sou datt Java-Spiller se gesinn. Dat leeft iwwer eng Waardeschlaang a ka eng Zäit daueren.
Heefeg Feeler a Léisungen
| Symptom | Üblech Ursaach | Léisung |
|---|---|---|
| „Unable to connect to world“ | UDP-Port zou, falsche Port oder Hoster-Astellung | Port fir UDP opmaachen, d’Geyser-Uleedung vun dengem Hoster befollegen, geyser connectiontest lafe loossen |
| Geet op Java, net op Bedrock | Port just fir TCP opgemaach | Bedrock brauch UDP |
| „Invalid IP address!“ | D’Domain huet just en SRV-Record | Bedrock ënnerstëtzt keng SRV-Records. Gëff amplaz d’IPv4-Adress an |
Address already in use beim Start | Eppes anescht benotzt de Port | Gëff Geyser säin eegenen UDP-Port |
| „Please connect through the official Geyser“ | Al Plugins oder ënnerschiddlech key.pem-Fichieren | Geyser a Floodgate updaten, de Schlëssel vum Proxy nach eng Kéier kopéieren |
| „Outdated server“ | Server ze al fir Geyser | ViaVersion installéieren oder de Server updaten |
Verschidde Saache loosse sech net iwwersetzen: Lénks- a Rietsklicken an Inventaren gesinn d’selwecht aus, Commanden ouni Brigadier kréie keng Tab-Vervollstännegung, Chat-Linke sinn net klickbar. Test Menüe mat engem richtege Bedrock-Apparat. Plugins kënnen iwwer d’Floodgate-API native Bedrock-Formulairen weisen, dofir brauche se Floodgate op hirem Server.
Weis béid Adressen op BestMCServerList
Bedrock-Spiller verbanne sech mat denger Adress plus dem Bedrock-Port, zum Beispill play.example.net an 19132. BestMCServerList weist d’Java- an d’Bedrock-Adress op all Serversäit getrennt, all mat engem Kopéier-Knäppchen.
- Maach Däi Server androen op a gëff deng Java-Adress an.
- Kräiz Bedrock-Spiller ginn ënnerstëtzt un.
- Gëff de Bedrock-Port aus
bedrock.portan. Looss d’Bedrock-IP eidel, wann se d’selwecht wéi d’Java-Adress ass.
Crossplay ass e richtege Virdeel fir en neie Server. Kuck wéi s de Spiller fir en neie Server fënns fir de Rescht vum Plang.