Deixa entrar jugadors de Bedrock al teu servidor Java: Geyser + Floodgate (Paper, Velocity)

Què fan Geyser i Floodgate

Geyser tradueix entre les dues edicions. Davant del teu servidor es comporta com un client de Java, així que la redstone, les granges i els plugins funcionen igual que per als jugadors de Java. Floodgate deixa entrar els jugadors de Bedrock amb el seu compte de Xbox en lloc d’un compte de Java.

Abans de començar: Java i versions

• Geyser necessita Java 21 o superior a la màquina on s’executa.
• El teu servidor ha d’acceptar la versió més recent de Java, perquè Geyser imita un client així. Els servidors més antics necessiten ViaVersion.
• Geyser-Spigot funciona a Paper i Spigot des de la 1.20.5. Els servidors més antics necessiten un proxy, Geyser Standalone o ViaProxy.
• Només s’admeten versions actuals de Bedrock (octubre de 2026: Bedrock 26.30 a 26.52, Java 26.2). Mantén Geyser al dia, perquè Bedrock s’actualitza sol.

Descarrega Geyser i Floodgate per a la teva plataforma des de la pàgina oficial de descàrregues de GeyserMC.

Instal·lació en un únic servidor Paper o Spigot

1. Posa Geyser-Spigot.jar i Floodgate-Spigot.jar a la carpeta plugins.
2. Reinicia el servidor. Geyser crea plugins/Geyser-Spigot/config.yml i Floodgate la carpeta plugins/floodgate/ amb config.yml i un key.pem.
3. Obre la configuració de Geyser i revisa la secció bedrock. El port és el que escriuran els jugadors de Bedrock.
4. Posa l’autenticació a floodgate i reinicia una altra vegada.

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

java:
  auth-type: floodgate

En configuracions antigues de Geyser la segona secció es diu remote, així que l’ajust és remote.auth-type. Les versions actuals canvien soles a Floodgate quan és al mateix servidor; posar-ho a mà no fa cap mal.

En un únic servidor no copiïs key.pem enlloc. Geyser el llegeix directament de Floodgate, i una còpia oblidada a la carpeta de Geyser provoca errors d’inici de sessió.

Obre el port de Bedrock per a UDP

Java fa servir TCP, Bedrock fa servir UDP. Aquí és on fallen la majoria d’instal·lacions.

• Panell del hosting: afegeix un port extra (molts hostings en diuen assignació o allocation) i posa’l com a bedrock.port. Alguns hostings exigeixen per a Bedrock el mateix port que per a Java o canvien el port de Java a cada arrencada; aleshores clone-remote-port: true fa que Geyser faci servir el port de Java. La pàgina d’instal·lació de Geyser té instruccions per a molts hostings.
• Pterodactyl: assigna el port al servidor a la pestanya Network.
• Ordinador propi o VPS: obre el port per a UDP al tallafoc i, a casa, també al router. OVH i Oracle Cloud, a més, bloquegen UDP al seu propi tallafoc.

sudo ufw allow 19132/udp
sudo ufw reload

Els plugins de xat de veu o query no poden compartir el port amb Geyser. Amb el port obert, executa geyser connectiontest <ip> <port> a la consola; comprova el port i suggereix solucions.

Instal·lació en una xarxa amb Velocity o BungeeCord

En una xarxa, els jugadors de Bedrock es connecten al proxy igual que els de Java. Per això Geyser va només al proxy.

1. Instal·la Geyser i Floodgate per al teu proxy (Velocity o BungeeCord) i reinicia el proxy.
2. A la configuració de Geyser del proxy posa el bedrock.port i l’autenticació floodgate, i obre el port per a UDP com s’explica més amunt.
3. Instal·la Floodgate-Spigot a cada backend. Cal per als plugins que fan servir l’API de Floodgate i millora les skins.
4. Configura el reenviament: a BungeeCord, ip_forward: true al seu config.yml i bungeecord: true al spigot.yml de cada backend; a Velocity, el reenviament d’informació dels jugadors tal com ho explica la documentació de Velocity.
5. A la configuració de Floodgate del proxy, posa send-floodgate-data: true.
6. Copia key.pem de la carpeta de Floodgate del proxy a la carpeta de Floodgate de cada servidor backend i després reinicia els backends i el proxy.

send-floodgate-data: true

Guarda key.pem en secret: amb ell, els comptes se salten l’autenticació de Java. Puja’l per FTP en mode binari, o tindràs errors Tag mismatch.

Noms de Bedrock: el prefix amb punt

Floodgate posa un prefix davant de cada nom de Bedrock perquè mai no xoqui amb un nom de Java. Per defecte és un punt, així que el gamertag de Xbox Steve passa a ser .Steve al teu servidor. Els espais del gamertag se substitueixen per _.

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

• A les comandes fes servir el nom complet amb el prefix. Si una comanda no l’accepta, posa el nom entre cometes: /tp ".Steve".
• Per a la whitelist fes servir fwhitelist add Steve. Allà no cal el prefix.
• Si LuckPerms dona problemes amb els noms de Bedrock, posa allow-invalid-usernames: true a la seva configuració.

GeyserMC aconsella mantenir el prefix. Els jugadors de Bedrock també voten amb aquest nom: a BestMCServerList escriuen .Steve, el nom que veu el teu plugin de recompenses per votar.

Comptes vinculats i skins (opcional)

Global Linking ve activat per defecte a Floodgate. Qui té les dues edicions entra a link.geysermc.org amb tots dos comptes i escriu /linkaccount. Després juga des de qualsevol dispositiu amb l’inventari i la posició del compte de Java, així que abans hauria de passar-hi els seus objectes de Bedrock. Una base de dades de vincles pròpia necessita una extensió extra de Floodgate.

Floodgate converteix i puja les skins de Bedrock perquè els jugadors de Java les vegin. Va per una cua i pot trigar una estona.

Errors típics i solucions

Algunes coses no es poden traduir: el clic esquerre i el dret es veuen igual als inventaris, les comandes sense Brigadier no tenen autocompletat i els enllaços del xat no es poden clicar. Prova els menús amb un dispositiu Bedrock real. Els plugins poden mostrar formularis nadius de Bedrock amb l’API de Floodgate, que necessita Floodgate al seu servidor.

Mostra les dues adreces a BestMCServerList

Els jugadors de Bedrock es connecten amb la teva adreça més el port de Bedrock, per exemple play.example.net i 19132. BestMCServerList mostra a cada pàgina de servidor l’adreça de Java i la de Bedrock per separat, cadascuna amb el seu botó de copiar.

1. Obre Afegeix el teu servidor i escriu la teva adreça de Java.
2. Marca S’admeten jugadors de Bedrock.
3. Escriu el Port de Bedrock de bedrock.port. Deixa buida la IP de Bedrock si és la mateixa que la de Java.

El crossplay és un avantatge real per a un servidor nou. La resta del pla és a com aconseguir jugadors per a un servidor nou.