Lase Bedrocki mängijad oma Java serverisse: Geyseri ja Floodgate’i seadistus (Paper, Velocity)

Mida Geyser ja Floodgate teevad

Geyser tõlgib kahe versiooni vahel. Sinu serveri poole käitub see nagu Java klient, nii et redstone, farmid ja pluginad töötavad täpselt nagu Java mängijatele. Floodgate laseb Bedrocki mängijatel sisse logida oma Xboxi kontoga, Java konto asemel.

Enne alustamist: Java ja versioonid

• Geyser vajab masinas, kus see jookseb, Java 21 või uuemat.
• Sinu server peab vastu võtma uusima Java versiooni, sest Geyser jäljendab sellist klienti. Vanemad serverid vajavad ViaVersionit.
• Geyser-Spigot jookseb Paperil ja Spigotil alates versioonist 1.20.5. Vanemad serverid vajavad proksit, Geyser Standalone’i või ViaProxyt.
• Toetatud on ainult praegused Bedrocki versioonid (oktoober 2026: Bedrock 26.30 kuni 26.52, Java 26.2). Hoia Geyser ajakohasena, sest Bedrock uuendab end ise.

Laadi Geyser ja Floodgate oma platvormi jaoks alla ametlikult GeyserMC allalaadimislehelt.

Seadistus üksikul Paperi või Spigoti serveril

1. Pane Geyser-Spigot.jar ja Floodgate-Spigot.jar kausta plugins.
2. Taaskäivita server. Geyser loob faili plugins/Geyser-Spigot/config.yml, Floodgate loob kausta plugins/floodgate/ koos config.yml ja key.pem failiga.
3. Ava Geyseri config ja kontrolli bedrock sektsiooni. port on see, mida Bedrocki mängijad sisse trükivad.
4. Määra autentimise tüübiks floodgate ja taaskäivita uuesti.

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

java:
  auth-type: floodgate

Vanemates Geyseri configides on teise sektsiooni nimi remote, nii et seade on remote.auth-type. Praegused buildid lülituvad Floodgate’ile ise, kui see jookseb samas serveris; seade määramine ei tee siiski halba.

Üksikul serveril ära kopeeri key.pem faili kuhugi. Geyser loeb selle Floodgate’ist ja Geyseri kausta jäänud koopia põhjustab sisselogimise vigu.

Ava Bedrocki port UDP jaoks

Java kasutab TCP-d, Bedrock kasutab UDP-d. Enamik katkiseid seadistusi kukub läbi just siin.

• Hostingu paneel: lisa üks lisaport (paljud hostid kutsuvad seda allocationiks) ja sisesta see kui bedrock.port. Mõned hostid nõuavad, et Bedrock kasutaks sama porti mis Java, või muudavad Java porti igal käivitamisel; seal paneb clone-remote-port: true Geyseri Java porti kasutama. Geyseri seadistuslehel on juhised paljude hostide jaoks.
• Pterodactyl: määra port serverile Network vahekaardil.
• Oma masin või VPS: ava port UDP jaoks tulemüüris ja kodus ka ruuteris. OVH ja Oracle Cloud blokeerivad UDP-d ka oma tulemüüris.

sudo ufw allow 19132/udp
sudo ufw reload

Häälvestluse pluginad või query ei saa Geyseriga porti jagada. Kui port on avatud, käivita konsoolis geyser connectiontest <ip> <port>; see kontrollib porti ja pakub lahendusi.

Seadistus Velocity või BungeeCordi võrgustikus

Võrgustikus ühenduvad Bedrocki mängijad proksiga täpselt nagu Java mängijad. Seepärast jookseb Geyser ainult proksis.

1. Paigalda Geyser ja Floodgate oma proksi jaoks (Velocity või BungeeCord) ja taaskäivita proksi.
2. Määra proksi Geyseri configis bedrock.port ja autentimise tüüp floodgate ning ava port UDP jaoks nagu ülal kirjeldatud.
3. Paigalda Floodgate-Spigot igasse backendi. See on vajalik Floodgate API-t kasutavatele pluginatele ja parandab skine.
4. Seadista forwarding: BungeeCordis määra tema config.yml failis ip_forward: true ja iga backendi spigot.yml failis bungeecord: true; Velocitys seadista mängijainfo edastamine nagu Velocity dokumentatsioonis kirjeldatud.
5. Määra proksi Floodgate’i configis send-floodgate-data: true.
6. Kopeeri key.pem proksi Floodgate’i kaustast iga backend-serveri Floodgate’i kausta, seejärel taaskäivita backendid ja proksi.

send-floodgate-data: true

Hoia key.pem saladuses: see laseb kontodel Java autentimisest mööda minna. Laadi see FTP kaudu üles binaarrežiimis, muidu saad Tag mismatch vigu.

Bedrocki nimed: punkt-prefiks

Floodgate paneb iga Bedrocki nime ette prefiksi, et see ei läheks kunagi Java nimega konflikti. Vaikimisi on see punkt, nii et Xboxi gamertag Steve muutub sinu serveris nimeks .Steve. Tühikud gamertagides asendatakse märgiga _.

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

• Käskudes kasuta täisnime koos prefiksiga. Kui käsk seda vastu ei võta, pane nimi jutumärkidesse: /tp ".Steve".
• Whitelisti jaoks kasuta fwhitelist add Steve. Seal pole prefiksit vaja.
• Kui LuckPermsil on Bedrocki nimedega probleeme, määra tema configis allow-invalid-usernames: true.

GeyserMC soovitab prefiksi alles jätta. Bedrocki mängijad hääletavad ka selle nimega: BestMCServerListis sisestavad nad .Steve, nime, mida sinu hääletuse auhindade plugin näeb.

Lingitud kontod ja skinid (valikuline)

Global Linking on Floodgate’is vaikimisi sees. Mängijad, kellel on mõlemad versioonid, liituvad mõlema kontoga serveriga link.geysermc.org ja kirjutavad /linkaccount. Pärast seda mängivad nad mõlemast seadmest oma Java inventari ja asukohaga, seega peaksid nad enne oma Bedrocki asjad ära tõstma. Kohalik lingiandmebaas vajab Floodgate’i lisalaiendust.

Floodgate teisendab ja laadib Bedrocki skinid üles, et Java mängijad neid näeksid. See käib järjekorra kaudu ja võib natuke aega võtta.

Levinud vead ja lahendused

Mõnda asja ei saa tõlkida: vasak- ja paremklikk inventaris näevad välja ühesugused, Brigadierita käsud ei saa tab-täitmist, chati lingid pole klikitavad. Testi menüüsid päris Bedrocki seadmega. Pluginad saavad Floodgate API kaudu näidata Bedrocki omi vorme, mis vajab Floodgate’i nende serveris.

Näita BestMCServerListis mõlemat aadressi

Bedrocki mängijad ühenduvad sinu aadressi ja Bedrocki pordiga, näiteks play.example.net ja 19132. BestMCServerList näitab igal serveri lehel Java ja Bedrocki aadressi eraldi, kumbki oma kopeerimisnupuga.

1. Ava Lisa oma server ja sisesta oma Java aadress.
2. Märgi linnuke Bedrocki mängijad on toetatud.
3. Sisesta Bedrocki port väärtusest bedrock.port. Jäta Bedrocki IP tühjaks, kui see on sama mis Java aadress.

Crossplay on uuele serverile päris eelis. Ülejäänud plaani leiad juhendist kuidas saada uuele serverile mängijaid.