Låt Bedrock-spelare joina din Java-server: Geyser + Floodgate (Paper, Velocity)

Vad Geyser och Floodgate gör

Geyser översätter mellan de två versionerna. Mot din server beter den sig som en Java-klient, så redstone, farmar och plugins fungerar precis som för Java-spelare. Floodgate låter Bedrock-spelare logga in med sitt Xbox-konto i stället för ett Java-konto.

Innan du börjar: Java och versioner

• Geyser behöver Java 21 eller nyare på maskinen som kör det.
• Din server måste ta emot den senaste Java-versionen, eftersom Geyser härmar en sådan klient. Äldre servrar behöver ViaVersion.
• Geyser-Spigot körs på Paper och Spigot från 1.20.5 och uppåt. Äldre servrar behöver en proxy, Geyser Standalone eller ViaProxy.
• Bara aktuella Bedrock-versioner stöds (oktober 2026: Bedrock 26.30 till 26.52, Java 26.2). Håll Geyser uppdaterat, eftersom Bedrock uppdaterar sig själv.

Ladda ner Geyser och Floodgate för din plattform från den officiella nedladdningssidan hos GeyserMC.

Inställning på en enskild Paper- eller Spigot-server

1. Lägg Geyser-Spigot.jar och Floodgate-Spigot.jar i mappen plugins.
2. Starta om servern. Geyser skapar plugins/Geyser-Spigot/config.yml, Floodgate skapar plugins/floodgate/ med config.yml och en key.pem.
3. Öppna Geysers config och kolla avsnittet bedrock. port är det som Bedrock-spelarna kommer att skriva in.
4. Sätt autentiseringstypen till floodgate och starta om igen.

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

java:
  auth-type: floodgate

Äldre Geyser-configs kallar det andra avsnittet remote, så inställningen heter då remote.auth-type. Aktuella builds byter själva till Floodgate när det körs på samma server; det skadar inte att sätta den.

På en enskild server ska du inte kopiera key.pem någonstans. Geyser läser den från Floodgate, och en kvarglömd kopia i Geyser-mappen orsakar inloggningsfel.

Öppna Bedrock-porten för UDP

Java använder TCP, Bedrock använder UDP. De flesta trasiga uppsättningar faller just här.

• Hostingpanel: lägg till en extra port (många hostar kallar det allocation) och ange den som bedrock.port. Vissa hostar kräver att Bedrock använder samma port som Java eller byter Java-porten vid varje start; där får clone-remote-port: true Geyser att använda Java-porten. Geysers installationssida har instruktioner för många hostar.
• Pterodactyl: tilldela servern porten under fliken Network.
• Egen maskin eller VPS: öppna porten för UDP i brandväggen och, hemma, i routern. OVH och Oracle Cloud blockerar dessutom UDP i sin egen brandvägg.

sudo ufw allow 19132/udp
sudo ufw reload

Röstchatt-plugins eller query kan inte dela port med Geyser. När porten är öppen, kör geyser connectiontest <ip> <port> i konsolen; den kontrollerar porten och föreslår lösningar.

Inställning i ett Velocity- eller BungeeCord-nätverk

I ett nätverk ansluter Bedrock-spelare till proxyn precis som Java-spelare. Därför körs Geyser bara på proxyn.

1. Installera Geyser och Floodgate för din proxy (Velocity eller BungeeCord) och starta om proxyn.
2. Sätt bedrock.port och autentiseringstypen floodgate i Geysers config på proxyn, och öppna porten för UDP enligt ovan.
3. Installera Floodgate-Spigot på varje backend. Det krävs för plugins som använder Floodgate-API:t och förbättrar skins.
4. Ställ in forwarding: på BungeeCord sätter du ip_forward: true i dess config.yml och bungeecord: true i varje backends spigot.yml; på Velocity ställer du in vidarebefordran av spelarinformation enligt Velocitys dokumentation.
5. I Floodgates config på proxyn sätter du send-floodgate-data: true.
6. Kopiera key.pem från proxyns Floodgate-mapp till Floodgate-mappen på varje backend-server och starta sedan om backends och proxyn.

send-floodgate-data: true

Håll key.pem hemlig: den släpper förbi konton utan Java-autentisering. Ladda upp den via FTP i binärläge, annars får du felet Tag mismatch.

Bedrock-namn: punktprefixet

Floodgate sätter ett prefix framför varje Bedrock-namn så att det aldrig kan krocka med ett Java-namn. Standard är en punkt, så Xbox-gamertaggen Steve blir .Steve på din server. Mellanslag i gamertaggar ersätts med _.

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

• I kommandon använder du hela namnet med prefix. Om ett kommando inte godtar det, sätt namnet inom citattecken: /tp ".Steve".
• För whitelisten använder du fwhitelist add Steve. Där behövs inget prefix.
• Om LuckPerms har problem med Bedrock-namn, sätt allow-invalid-usernames: true i dess config.

GeyserMC rekommenderar att behålla prefixet. Bedrock-spelare röstar också med det här namnet: på BestMCServerList skriver de .Steve, namnet som ditt plugin för röstbelöningar ser.

Länkade konton och skins (valfritt)

Global Linking är aktiverat som standard i Floodgate. Spelare som äger båda versionerna joinar link.geysermc.org med båda kontona och skriver /linkaccount. Därefter spelar de med sitt Java-inventory och sin Java-position från vilken enhet som helst, så de bör flytta sina Bedrock-föremål först. En lokal länkdatabas kräver ett extra Floodgate-tillägg.

Floodgate konverterar och laddar upp Bedrock-skins så att Java-spelare ser dem. Det går genom en kö och kan ta ett tag.

Vanliga fel och lösningar

Vissa saker går inte att översätta: vänster- och högerklick i inventories ser likadana ut, kommandon utan Brigadier får ingen tabbkomplettering och länkar i chatten är inte klickbara. Testa menyer med en riktig Bedrock-enhet. Plugins kan visa inbyggda Bedrock-formulär via Floodgate-API:t, vilket kräver Floodgate på deras server.

Visa båda adresserna på BestMCServerList

Bedrock-spelare ansluter med din adress plus Bedrock-porten, till exempel play.example.net och 19132. BestMCServerList visar Java- och Bedrock-adressen var för sig på varje serversida, båda med en kopieringsknapp.

1. Öppna Lägg till din server och ange din Java-adress.
2. Kryssa i Bedrock-spelare stöds.
3. Ange Bedrock-porten från bedrock.port. Lämna Bedrock-IP tom om den är samma som Java-adressen.

Crossplay är en verklig fördel för en ny server. Läs hur du får spelare till en ny server för resten av planen.