Päästä Bedrock-pelaajat Java-palvelimellesi: Geyser + Floodgate (Paper, Velocity)

Mitä Geyser ja Floodgate tekevät

Geyser kääntää kahden version välillä. Palvelimesi suuntaan se toimii kuin Java-client, joten redstone, farmit ja pluginit toimivat täsmälleen kuten Java-pelaajille. Floodgate antaa Bedrock-pelaajien kirjautua Xbox-tilillään Java-tilin sijaan.

Ennen kuin aloitat: Java ja versiot

• Geyser tarvitsee Java 21:n tai uudemman koneella, jolla se pyörii.
• Palvelimesi pitää hyväksyä uusin Java-versio, koska Geyser jäljittelee sellaista clientiä. Vanhemmat palvelimet tarvitsevat ViaVersionin.
• Geyser-Spigot toimii Paperilla ja Spigotilla versiosta 1.20.5 ylöspäin. Vanhemmat palvelimet tarvitsevat proxyn, Geyser Standalonen tai ViaProxyn.
• Vain nykyisiä Bedrock-versioita tuetaan (lokakuu 2026: Bedrock 26.30–26.52, Java 26.2). Pidä Geyser ajan tasalla, koska Bedrock päivittyy itsestään.

Lataa Geyser ja Floodgate alustallesi virallisalta GeyserMC:n lataussivulta.

Asennus yksittäiselle Paper- tai Spigot-palvelimelle

1. Laita Geyser-Spigot.jar ja Floodgate-Spigot.jar plugins-kansioon.
2. Käynnistä palvelin uudelleen. Geyser luo tiedoston plugins/Geyser-Spigot/config.yml, Floodgate luo kansion plugins/floodgate/, jossa on config.yml ja key.pem.
3. Avaa Geyserin config ja tarkista bedrock-osio. port on se, jonka Bedrock-pelaajat kirjoittavat.
4. Aseta autentikointityypiksi floodgate ja käynnistä taas uudelleen.

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

java:
  auth-type: floodgate

Vanhemmissa Geyser-configeissa toisen osion nimi on remote, joten asetus on remote.auth-type. Nykyiset buildit vaihtavat Floodgateen itsestään, kun se pyörii samalla palvelimella; asetuksesta ei ole haittaa.

Yksittäisellä palvelimella älä kopioi key.pem-tiedostoa minnekään. Geyser lukee sen Floodgatelta, ja Geyser-kansioon jäänyt kopio aiheuttaa kirjautumisvirheitä.

Avaa Bedrock-portti UDP:lle

Java käyttää TCP:tä, Bedrock UDP:tä. Useimmat rikkinäiset asennukset kaatuvat tähän.

• Hostauspaneeli: lisää ylimääräinen portti (monet hostit kutsuvat sitä nimellä allocation) ja syötä se kohtaan bedrock.port. Jotkin hostit vaativat, että Bedrock käyttää samaa porttia kuin Java, tai vaihtavat Java-portin joka käynnistyksellä; silloin clone-remote-port: true saa Geyserin käyttämään Java-porttia. Geyserin asennussivulla on ohjeet monille hosteille.
• Pterodactyl: varaa portti palvelimelle Network-välilehdellä.
• Oma kone tai VPS: avaa portti UDP:lle palomuurissa ja kotona myös reitittimessä. OVH ja Oracle Cloud estävät UDP:n myös omassa palomuurissaan.

sudo ufw allow 19132/udp
sudo ufw reload

Äänichat-pluginit tai query eivät voi jakaa porttia Geyserin kanssa. Kun portti on auki, aja konsolissa geyser connectiontest <ip> <port>; se tarkistaa portin ja ehdottaa korjauksia.

Asennus Velocity- tai BungeeCord-verkostoon

Verkostossa Bedrock-pelaajat yhdistävät proxyyn samoin kuin Java-pelaajat. Siksi Geyser pyörii vain proxyllä.

1. Asenna Geyser ja Floodgate proxyllesi (Velocity tai BungeeCord) ja käynnistä proxy uudelleen.
2. Aseta proxyn Geyser-configiin bedrock.port ja autentikointityyppi floodgate, ja avaa portti UDP:lle kuten yllä.
3. Asenna Floodgate-Spigot jokaiselle backendille. Sitä tarvitsevat Floodgate API:a käyttävät pluginit, ja se parantaa skinejä.
4. Määritä forwarding: BungeeCordissa aseta ip_forward: true sen config.yml-tiedostoon ja bungeecord: true jokaisen backendin spigot.yml-tiedostoon; Velocityssä määritä pelaajatietojen forwarding Velocityn dokumentaation mukaan.
5. Aseta proxyn Floodgate-configiin send-floodgate-data: true.
6. Kopioi key.pem proxyn Floodgate-kansiosta jokaisen backend-palvelimen Floodgate-kansioon ja käynnistä sitten backendit ja proxy uudelleen.

send-floodgate-data: true

Pidä key.pem salaisena: sillä pääsee Java-autentikoinnin ohi. Lataa se FTP:llä binääritilassa, muuten saat Tag mismatch -virheitä.

Bedrock-nimet: piste-etuliite

Floodgate lisää jokaisen Bedrock-nimen eteen etuliitteen, jotta se ei voi koskaan törmätä Java-nimeen. Oletus on piste, joten Xbox-gamertagista Steve tulee palvelimellasi .Steve. Gamertagien välilyönnit korvataan merkillä _.

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

• Käytä komennoissa koko nimeä etuliitteen kanssa. Jos komento ei hyväksy sitä, laita nimi lainausmerkkeihin: /tp ".Steve".
• Whitelistiin käytä komentoa fwhitelist add Steve. Siinä etuliitettä ei tarvita.
• Jos LuckPermsillä on ongelmia Bedrock-nimien kanssa, aseta sen configiin allow-invalid-usernames: true.

GeyserMC neuvoo pitämään etuliitteen. Bedrock-pelaajat myös äänestävät tällä nimellä: BestMCServerListissä he syöttävät .Steve, eli nimen, jonka äänestyspalkintopluginisi näkee.

Linkitetyt tilit ja skinit (valinnainen)

Global Linking on Floodgatessa oletuksena päällä. Pelaajat, jotka omistavat molemmat versiot, liittyvät palvelimelle link.geysermc.org molemmilla tileillä ja kirjoittavat /linkaccount. Sen jälkeen he pelaavat Java-inventaariollaan ja -sijainnillaan kummalta tahansa laitteelta, joten heidän kannattaa siirtää Bedrock-tavaransa ensin. Paikallinen linkkitietokanta vaatii erillisen Floodgate-laajennuksen.

Floodgate muuntaa ja lataa Bedrock-skinit, jotta Java-pelaajat näkevät ne. Tämä kulkee jonon kautta ja voi kestää hetken.

Yleiset virheet ja korjaukset

Joitain asioita ei voi kääntää: vasen ja oikea klikkaus inventaarioissa näyttävät samalta, komennot ilman Brigadieria eivät saa tab-täydennystä, chatin linkit eivät ole klikattavia. Testaa valikot oikealla Bedrock-laitteella. Pluginit voivat näyttää natiiveja Bedrock-lomakkeita Floodgate API:n kautta, mikä vaatii Floodgaten niiden palvelimelle.

Näytä molemmat osoitteet BestMCServerListissä

Bedrock-pelaajat yhdistävät osoitteellasi ja Bedrock-portilla, esimerkiksi play.example.net ja 19132. BestMCServerList näyttää Java- ja Bedrock-osoitteen erikseen jokaisella palvelinsivulla, kummallekin oma kopiointinappi.

1. Avaa Lisää palvelimesi ja syötä Java-osoitteesi.
2. Rastita Bedrock-pelaajat ovat tuettuja.
3. Syötä Bedrock-portti asetuksesta bedrock.port. Jätä Bedrock-IP tyhjäksi, jos se on sama kuin Java-osoite.

Crossplay on uudelle palvelimelle todellinen etu. Katso loput suunnitelmasta oppaasta miten saat pelaajia uudelle palvelimelle.