Hva Geyser og Floodgate gjør
Geyser oversetter mellom de to utgavene. Overfor serveren din oppfører den seg som en Java-klient, så redstone, farmer og plugins fungerer akkurat som for Java-spillere. Floodgate lar Bedrock-spillere logge inn med Xbox-kontoen sin i stedet for en Java-konto.
| Plugin | Oppgave | Hvor det kjører |
|---|---|---|
| Geyser | Tar imot Bedrock-tilkoblinger på en UDP-port og oversetter dem | Paper/Spigot-server, eller proxyen i et nettverk |
| Floodgate | Innlogging uten Java-konto, Bedrock-navn og skins | Samme sted som Geyser, valgfritt på backend-servere |
Før du begynner: Java og versjoner
- Geyser trenger Java 21 eller nyere på maskinen som kjører den.
- Serveren din må godta den nyeste Java-versjonen, fordi Geyser etterligner en slik klient. Eldre servere trenger ViaVersion.
- Geyser-Spigot kjører på Paper og Spigot fra 1.20.5 og oppover. Eldre servere trenger en proxy, Geyser Standalone eller ViaProxy.
- Bare aktuelle Bedrock-versjoner støttes (oktober 2026: Bedrock 26.30 til 26.52, Java 26.2). Hold Geyser oppdatert, fordi Bedrock oppdaterer seg selv.
Last ned Geyser og Floodgate for plattformen din fra den offisielle nedlastingssiden til GeyserMC.
Oppsett på en enkelt Paper- eller Spigot-server
- Legg
Geyser-Spigot.jarogFloodgate-Spigot.jari mappenplugins. - Start serveren på nytt. Geyser oppretter
plugins/Geyser-Spigot/config.yml, Floodgate oppretterplugins/floodgate/medconfig.ymlog enkey.pem. - Åpne Geyser-configen og sjekk seksjonen
bedrock.porter det Bedrock-spillerne skal skrive inn. - Sett autentiseringstypen til
floodgateog start på nytt igjen.
bedrock:
address: 0.0.0.0
port: 19132
clone-remote-port: false
java:
auth-type: floodgateEldre Geyser-configer kaller den andre seksjonen remote, så innstillingen heter remote.auth-type. Nyere builds bytter selv til Floodgate når det kjører på samme server; det skader ikke å sette den.
På en enkelt server skal du ikke kopiere key.pem noe sted. Geyser leser den fra Floodgate, og en gjenglemt kopi i Geyser-mappen gir innloggingsfeil.
Åpne Bedrock-porten for UDP
Java bruker TCP, Bedrock bruker UDP. De fleste oppsett som ikke fungerer, stopper her.
- Hostingpanel: legg til en ekstra port (mange hoster kaller det en allocation) og angi den som
bedrock.port. Noen hoster krever at Bedrock bruker samme port som Java, eller bytter Java-porten ved hver oppstart; der fårclone-remote-port: trueGeyser til å bruke Java-porten. Oppsettsiden til Geyser har veiledninger for mange hoster. - Pterodactyl: tildel porten til serveren i fanen Network.
- Egen maskin eller VPS: åpne porten for UDP i brannmuren og, hjemme, i ruteren. OVH og Oracle Cloud blokkerer også UDP i sin egen brannmur.
sudo ufw allow 19132/udp
sudo ufw reloadVoice chat-plugins eller query kan ikke dele port med Geyser. Når porten er åpen, kjører du geyser connectiontest <ip> <port> i konsollen; den sjekker porten og foreslår løsninger.
Oppsett på et Velocity- eller BungeeCord-nettverk
I et nettverk kobler Bedrock-spillere seg til proxyen akkurat som Java-spillere. Geyser kjører derfor bare på proxyen.
- Installer Geyser og Floodgate for proxyen din (Velocity eller BungeeCord) og start proxyen på nytt.
- Sett
bedrock.portog autentiseringstypenfloodgatei Geyser-configen på proxyen, og åpne porten for UDP som beskrevet over. - Installer Floodgate-Spigot på alle backendene. Det kreves av plugins som bruker Floodgate-API-et, og det gir bedre skins.
- Sett opp forwarding: på BungeeCord setter du
ip_forward: trueiconfig.ymlogbungeecord: trueispigot.ymlpå hver backend; på Velocity setter du opp player information forwarding som beskrevet i Velocity-dokumentasjonen. - I Floodgate-configen på proxyen setter du
send-floodgate-data: true. - Kopier
key.pemfra Floodgate-mappen på proxyen til Floodgate-mappen på hver backend-server, og start deretter backendene og proxyen på nytt.
send-floodgate-data: trueHold key.pem hemmelig: den slipper kontoer forbi Java-autentiseringen. Last den opp via FTP i binærmodus, ellers får du Tag mismatch-feil.
Bedrock-navn: punktum-prefikset
Floodgate setter et prefiks foran hvert Bedrock-navn, så det aldri kan kollidere med et Java-navn. Standard er et punktum, så Xbox-gamertaggen Steve blir til .Steve på serveren din. Mellomrom i gamertagger erstattes med _.
username-prefix: "."
replace-spaces: true- I kommandoer bruker du hele navnet med prefiks. Hvis en kommando ikke godtar det, setter du navnet i anførselstegn:
/tp ".Steve". - For whitelisten bruker du
fwhitelist add Steve. Der trengs ikke prefikset. - Hvis LuckPerms har problemer med Bedrock-navn, setter du
allow-invalid-usernames: truei configen.
GeyserMC anbefaler å beholde prefikset. Bedrock-spillere stemmer også med dette navnet: på BestMCServerList skriver de .Steve, navnet som pluginet ditt for stemmebelønninger ser.
Koblede kontoer og skins (valgfritt)
Global Linking er slått på som standard i Floodgate. Spillere som eier begge utgavene, kobler seg til link.geysermc.org med begge kontoene og skriver /linkaccount. Etter det spiller de med Java-inventoryet og -posisjonen sin fra begge enhetene, så de bør flytte Bedrock-itemene sine først. En lokal link-database krever en ekstra Floodgate-utvidelse.
Floodgate konverterer og laster opp Bedrock-skins, så Java-spillere kan se dem. Dette går gjennom en kø og kan ta litt tid.
Vanlige feil og løsninger
| Symptom | Vanlig årsak | Løsning |
|---|---|---|
| «Unable to connect to world» | UDP-porten er stengt, feil port eller feil innstilling hos hosten | Åpne porten for UDP, følg Geyser-veiledningen til hosten din, kjør geyser connectiontest |
| Fungerer på Java, ikke på Bedrock | Porten er bare åpnet for TCP | Bedrock trenger UDP |
| «Invalid IP address!» | Domenet har bare en SRV-record | Bedrock støtter ikke SRV-records. Skriv inn IPv4-adressen i stedet |
Address already in use ved oppstart | Noe annet bruker porten | Gi Geyser sin egen UDP-port |
| «Please connect through the official Geyser» | Utdaterte plugins eller ulike key.pem-filer | Oppdater Geyser og Floodgate, kopier nøkkelen fra proxyen på nytt |
| «Outdated server» | Serveren er for gammel for Geyser | Installer ViaVersion eller oppdater serveren |
Noen ting kan ikke oversettes: venstre- og høyreklikk i inventories ser like ut, kommandoer uten Brigadier får ingen tab-fullføring, og lenker i chatten er ikke klikkbare. Test menyer med en ekte Bedrock-enhet. Plugins kan vise native Bedrock-skjemaer via Floodgate-API-et, som krever Floodgate på serveren de kjører på.
Vis begge adressene på BestMCServerList
Bedrock-spillere kobler til med adressen din pluss Bedrock-porten, for eksempel play.example.net og 19132. BestMCServerList viser Java- og Bedrock-adressen hver for seg på alle serversider, hver med sin egen kopieringsknapp.
- Åpne Legg til serveren din og skriv inn Java-adressen din.
- Huk av for Bedrock-spillere støttes.
- Skriv inn Bedrock-porten fra
bedrock.port. La Bedrock-IP-en stå tom hvis den er den samme som Java-adressen.
Crossplay er en reell fordel for en ny server. Se hvordan du får spillere til en ny server for resten av planen.