Lad Bedrock-spillere joine din Java-server: opsætning af Geyser + Floodgate (Paper, Velocity)

Hvad Geyser og Floodgate gør

Geyser oversætter mellem de to udgaver. Over for din server opfører den sig som en Java-klient, så redstone, farme og plugins virker præcis som for Java-spillere. Floodgate lader Bedrock-spillere logge ind med deres Xbox-konto i stedet for en Java-konto.

Før du går i gang: Java og versioner

• Geyser kræver Java 21 eller nyere på den maskine, der kører den.
• Din server skal tage imod den nyeste Java-version, fordi Geyser efterligner sådan en klient. Ældre servere kræver ViaVersion.
• Geyser-Spigot kører på Paper og Spigot fra 1.20.5 og op. Ældre servere kræver en proxy, Geyser Standalone eller ViaProxy.
• Kun aktuelle Bedrock-versioner understøttes (oktober 2026: Bedrock 26.30 til 26.52, Java 26.2). Hold Geyser opdateret, fordi Bedrock opdaterer sig selv.

Download Geyser og Floodgate til din platform fra den officielle downloadside hos GeyserMC.

Opsætning på en enkelt Paper- eller Spigot-server

1. Læg Geyser-Spigot.jar og Floodgate-Spigot.jar i mappen plugins.
2. Genstart serveren. Geyser opretter plugins/Geyser-Spigot/config.yml, Floodgate opretter plugins/floodgate/ med config.yml og en key.pem.
3. Åbn Geyser-configen, og tjek afsnittet bedrock. port er det, Bedrock-spillere skal skrive.
4. Sæt godkendelsestypen til floodgate, og genstart igen.

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

java:
  auth-type: floodgate

Ældre Geyser-configs kalder det andet afsnit remote, så indstillingen hedder remote.auth-type. Aktuelle builds skifter selv til Floodgate, når det kører på samme server; det skader ikke at sætte den.

På en enkelt server skal du ikke kopiere key.pem nogen steder hen. Geyser læser den fra Floodgate, og en overset kopi i Geyser-mappen giver loginfejl.

Åbn Bedrock-porten for UDP

Java bruger TCP, Bedrock bruger UDP. De fleste opsætninger, der ikke virker, fejler her.

• Hostingpanel: tilføj en ekstra port (mange hosts kalder det en allocation), og angiv den som bedrock.port. Nogle hosts kræver, at Bedrock bruger samme port som Java, eller skifter Java-porten ved hver start; der får clone-remote-port: true Geyser til at bruge Java-porten. Geysers opsætningsside har vejledninger til mange hosts.
• Pterodactyl: tildel porten til serveren under fanen Network.
• Egen maskine eller VPS: åbn porten for UDP i firewallen og, derhjemme, i routeren. OVH og Oracle Cloud blokerer også UDP i deres egen firewall.

sudo ufw allow 19132/udp
sudo ufw reload

Voice chat-plugins eller query kan ikke dele port med Geyser. Når porten er åben, så kør geyser connectiontest <ip> <port> i konsollen; den tjekker porten og foreslår løsninger.

Opsætning på et Velocity- eller BungeeCord-netværk

I et netværk forbinder Bedrock-spillere til proxyen ligesom Java-spillere. Geyser kører derfor kun på proxyen.

1. Installer Geyser og Floodgate til din proxy (Velocity eller BungeeCord), og genstart proxyen.
2. Sæt bedrock.port og godkendelsestypen floodgate i Geysers config på proxyen, og åbn porten for UDP som beskrevet ovenfor.
3. Installer Floodgate-Spigot på alle backends. Det kræves af plugins, der bruger Floodgate-API’et, og det forbedrer skins.
4. Sæt forwarding op: på BungeeCord sætter du ip_forward: true i dens config.yml og bungeecord: true i hver backends spigot.yml; på Velocity sætter du player information forwarding op som beskrevet i Velocity-dokumentationen.
5. I Floodgates config på proxyen sætter du send-floodgate-data: true.
6. Kopiér key.pem fra proxyens Floodgate-mappe ind i Floodgate-mappen på hver backend-server, og genstart så backends og proxyen.

send-floodgate-data: true

Hold key.pem hemmelig: den lukker konti forbi Java-godkendelsen. Upload den via FTP i binær tilstand, ellers får du Tag mismatch-fejl.

Bedrock-navne: punktum-præfikset

Floodgate sætter et præfiks foran hvert Bedrock-navn, så det aldrig kan støde sammen med et Java-navn. Standard er et punktum, så Xbox-gamertagget Steve bliver til .Steve på din server. Mellemrum i gamertags erstattes med _.

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

• I kommandoer bruger du hele navnet med præfiks. Hvis en kommando ikke accepterer det, så sæt navnet i anførselstegn: /tp ".Steve".
• Til whitelisten bruger du fwhitelist add Steve. Der er præfikset ikke nødvendigt.
• Hvis LuckPerms har problemer med Bedrock-navne, så sæt allow-invalid-usernames: true i dens config.

GeyserMC anbefaler at beholde præfikset. Bedrock-spillere stemmer også med dette navn: på BestMCServerList skriver de .Steve, det navn, dit plugin til stemmebelønninger ser.

Forbundne konti og skins (valgfrit)

Global Linking er slået til som standard i Floodgate. Spillere, der ejer begge udgaver, joiner link.geysermc.org med begge konti og skriver /linkaccount. Derefter spiller de med deres Java-inventory og -position fra begge enheder, så de bør flytte deres Bedrock-items først. En lokal link-database kræver en ekstra Floodgate-udvidelse.

Floodgate konverterer og uploader Bedrock-skins, så Java-spillere kan se dem. Det kører gennem en kø og kan tage et stykke tid.

Typiske fejl og løsninger

Nogle ting kan ikke oversættes: venstre- og højreklik i inventories ser ens ud, kommandoer uden Brigadier får ingen tab-completion, og links i chatten kan ikke klikkes. Test menuer med en rigtig Bedrock-enhed. Plugins kan vise native Bedrock-formularer via Floodgate-API’et, som kræver Floodgate på deres server.

Vis begge adresser på BestMCServerList

Bedrock-spillere forbinder med din adresse plus Bedrock-porten, f.eks. play.example.net og 19132. BestMCServerList viser Java- og Bedrock-adressen hver for sig på alle serversider, hver med en kopiknap.

1. Åbn Tilføj din server, og indtast din Java-adresse.
2. Sæt flueben ved Bedrock-spillere understøttes.
3. Indtast Bedrock-porten fra bedrock.port. Lad Bedrock-IP’en være tom, hvis den er den samme som Java-adressen.

Crossplay er en reel fordel for en ny server. Se hvordan du får spillere til en ny server for resten af planen.