Įleisk Bedrock žaidėjus į savo Java serverį: Geyser + Floodgate nustatymas (Paper, Velocity)

Ką daro Geyser ir Floodgate

Geyser verčia tarp dviejų leidimų. Tavo serverio atžvilgiu jis elgiasi kaip Java klientas, todėl redstone, fermos ir pluginai veikia lygiai taip pat kaip Java žaidėjams. Floodgate leidžia Bedrock žaidėjams prisijungti su Xbox paskyra, o ne Java paskyra.

Prieš pradedant: Java ir versijos

• Geyser reikia Java 21 ar naujesnės kompiuteryje, kuriame jis veikia.
• Tavo serveris turi priimti naujausią Java versiją, nes Geyser apsimeta tokiu klientu. Senesniems serveriams reikia ViaVersion.
• Geyser-Spigot veikia Paper ir Spigot nuo 1.20.5. Senesniems serveriams reikia proxy, Geyser Standalone arba ViaProxy.
• Palaikomos tik dabartinės Bedrock versijos (2026 m. spalis: Bedrock nuo 26.30 iki 26.52, Java 26.2). Nuolat atnaujink Geyser, nes Bedrock atsinaujina pats.

Atsisiųsk Geyser ir Floodgate savo platformai iš oficialaus GeyserMC atsisiuntimo puslapio.

Nustatymas viename Paper arba Spigot serveryje

1. Įdėk Geyser-Spigot.jar ir Floodgate-Spigot.jar į plugins aplanką.
2. Perkrauk serverį. Geyser sukuria plugins/Geyser-Spigot/config.yml, Floodgate sukuria plugins/floodgate/ su config.yml ir key.pem.
3. Atidaryk Geyser config ir patikrink bedrock skiltį. port yra tai, ką įves Bedrock žaidėjai.
4. Nustatyk autentifikacijos tipą floodgate ir vėl perkrauk.

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

java:
  auth-type: floodgate

Senesniuose Geyser config antra skiltis vadinasi remote, todėl nustatymas yra remote.auth-type. Naujausios versijos pačios persijungia į Floodgate, kai jis veikia tame pačiame serveryje; nustatyti vis tiek nepakenks.

Viename serveryje niekur nekopijuok key.pem. Geyser jį nuskaito iš Floodgate, o likusi kopija Geyser aplanke sukelia prisijungimo klaidas.

Atidaryk Bedrock portą UDP

Java naudoja TCP, Bedrock naudoja UDP. Dauguma neveikiančių nustatymų sugriūva būtent čia.

• Hostingo panelė: pridėk papildomą portą (daug hostingų tai vadina allocation) ir įrašyk jį kaip bedrock.port. Kai kurie hostingai reikalauja, kad Bedrock naudotų tą patį portą kaip Java, arba kiekvieno starto metu keičia Java portą; tada clone-remote-port: true priverčia Geyser naudoti Java portą. Geyser nustatymo puslapyje yra instrukcijos daugeliui hostingų.
• Pterodactyl: priskirk portą serveriui Network skirtuke.
• Savas kompiuteris ar VPS: atidaryk portą UDP ugniasienėje, o namie ir maršrutizatoriuje. OVH ir Oracle Cloud UDP blokuoja ir savo ugniasienėje.

sudo ufw allow 19132/udp
sudo ufw reload

Balso pokalbių pluginai ar query negali dalintis portu su Geyser. Kai portas atidarytas, konsolėje paleisk geyser connectiontest <ip> <port>; jis patikrina portą ir pasiūlo sprendimų.

Nustatymas Velocity arba BungeeCord tinkle

Tinkle Bedrock žaidėjai jungiasi prie proxy taip pat kaip Java žaidėjai. Todėl Geyser veikia tik proxy.

1. Įdiek Geyser ir Floodgate savo proxy (Velocity arba BungeeCord) ir perkrauk proxy.
2. Proxy Geyser config nustatyk bedrock.port ir autentifikacijos tipą floodgate, o portą atidaryk UDP, kaip aprašyta aukščiau.
3. Įdiek Floodgate-Spigot kiekviename backend serveryje. Jo reikia pluginams, naudojantiems Floodgate API, ir jis pagerina skinus.
4. Nustatyk persiuntimą (forwarding): BungeeCord atveju jo config.yml nustatyk ip_forward: true, o kiekvieno backend spigot.yml – bungeecord: true; Velocity atveju nustatyk žaidėjų informacijos persiuntimą pagal Velocity dokumentaciją.
5. Proxy Floodgate config nustatyk send-floodgate-data: true.
6. Nukopijuok key.pem iš proxy Floodgate aplanko į kiekvieno backend serverio Floodgate aplanką, tada perkrauk backend serverius ir proxy.

send-floodgate-data: true

Laikyk key.pem paslaptyje: su juo paskyros praeina pro Java autentifikaciją. Kelk jį per FTP dvejetainiu (binary) režimu, kitaip gausi Tag mismatch klaidas.

Bedrock vardai: taško prefiksas

Floodgate prieš kiekvieną Bedrock vardą prideda prefiksą, kad jis niekada nesutaptų su Java vardu. Pagal nutylėjimą tai taškas, todėl Xbox gamertag Steve tavo serveryje tampa .Steve. Tarpai gamertag’uose pakeičiami į _.

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

• Komandose naudok pilną vardą su prefiksu. Jei komanda jo nepriima, įrašyk vardą kabutėse: /tp ".Steve".
• Whitelist naudok fwhitelist add Steve. Ten prefikso nereikia.
• Jei LuckPerms turi problemų su Bedrock vardais, jo config nustatyk allow-invalid-usernames: true.

GeyserMC pataria prefiksą palikti. Bedrock žaidėjai ir balsuoja su šiuo vardu: BestMCServerList jie įveda .Steve, tą vardą, kurį mato tavo balsų prizų pluginas.

Susietos paskyros ir skinai (neprivaloma)

Global Linking Floodgate įjungtas pagal nutylėjimą. Žaidėjai, turintys abu leidimus, su abiem paskyromis prisijungia prie link.geysermc.org ir įveda /linkaccount. Po to iš bet kurio įrenginio jie žaidžia su savo Java inventoriumi ir vieta, todėl pirmiausia turėtų perkelti Bedrock daiktus. Vietinei susiejimų duomenų bazei reikia papildomo Floodgate plėtinio.

Floodgate konvertuoja ir įkelia Bedrock skinus, kad Java žaidėjai juos matytų. Tai vyksta per eilę ir gali šiek tiek užtrukti.

Dažnos klaidos ir jų taisymas

Kai kurių dalykų išversti neįmanoma: kairysis ir dešinysis paspaudimai inventoriuose atrodo vienodai, komandos be Brigadier negauna tab užbaigimo, nuorodos chate nepaspaudžiamos. Meniu išbandyk su tikru Bedrock įrenginiu. Pluginai gali rodyti natūralias Bedrock formas per Floodgate API, kuriai reikia Floodgate jų serveryje.

Parodyk abu adresus BestMCServerList

Bedrock žaidėjai jungiasi su tavo adresu ir Bedrock portu, pavyzdžiui, play.example.net ir 19132. BestMCServerList kiekviename serverio puslapyje Java ir Bedrock adresus rodo atskirai, kiekvieną su kopijavimo mygtuku.

1. Atidaryk Pridėk savo serverį ir įvesk savo Java adresą.
2. Pažymėk Palaikomi Bedrock žaidėjai.
3. Įvesk Bedrock portą iš bedrock.port. Bedrock IP palik tuščią, jei jis sutampa su Java adresu.

Crossplay yra tikras pranašumas naujam serveriui. Likusį planą rasi gide kaip gauti žaidėjų naujam serveriui.