Qué hacen Geyser y Floodgate
Geyser traduce entre las dos ediciones. Ante tu servidor se comporta como un cliente de Java, así que la redstone, las granjas y los plugins funcionan igual que para los jugadores de Java. Floodgate deja entrar a los jugadores de Bedrock con su cuenta de Xbox en lugar de una cuenta de Java.
| Plugin | Función | Dónde se instala |
|---|---|---|
| Geyser | Acepta conexiones de Bedrock en un puerto UDP y las traduce | Servidor Paper/Spigot, o el proxy en una red |
| Floodgate | Inicio de sesión sin cuenta de Java, nombres de Bedrock y skins | Donde está Geyser, opcional en los servidores backend |
Antes de empezar: Java y versiones
- Geyser necesita Java 21 o superior en la máquina donde se ejecuta.
- Tu servidor tiene que aceptar la versión más reciente de Java, porque Geyser imita a un cliente así. Los servidores más antiguos necesitan ViaVersion.
- Geyser-Spigot funciona en Paper y Spigot desde la 1.20.5. Los servidores más antiguos necesitan un proxy, Geyser Standalone o ViaProxy.
- Solo se admiten versiones actuales de Bedrock (octubre de 2026: Bedrock 26.30 a 26.52, Java 26.2). Mantén Geyser al día, porque Bedrock se actualiza solo.
Descarga Geyser y Floodgate para tu plataforma desde la página oficial de descargas de GeyserMC.
Instalación en un único servidor Paper o Spigot
- Pon
Geyser-Spigot.jaryFloodgate-Spigot.jaren la carpetaplugins. - Reinicia el servidor. Geyser crea
plugins/Geyser-Spigot/config.ymly Floodgate la carpetaplugins/floodgate/conconfig.ymly unkey.pem. - Abre la configuración de Geyser y revisa la sección
bedrock. Elportes lo que escribirán los jugadores de Bedrock. - Pon la autenticación en
floodgatey reinicia otra vez.
bedrock:
address: 0.0.0.0
port: 19132
clone-remote-port: false
java:
auth-type: floodgateEn configuraciones antiguas de Geyser la segunda sección se llama remote, así que el ajuste es remote.auth-type. Las versiones actuales cambian solas a Floodgate cuando está en el mismo servidor; ponerlo a mano no hace daño.
En un único servidor no copias key.pem a ningún sitio. Geyser lo lee directamente de Floodgate, y una copia olvidada en la carpeta de Geyser provoca errores de inicio de sesión.
Abre el puerto de Bedrock para UDP
Java usa TCP, Bedrock usa UDP. Aquí fallan la mayoría de las instalaciones.
- Panel del hosting: añade un puerto extra (muchos hostings lo llaman asignación o allocation) y ponlo como
bedrock.port. Algunos hostings exigen para Bedrock el mismo puerto que para Java o cambian el puerto de Java en cada arranque; ahíclone-remote-port: truehace que Geyser use el puerto de Java. La página de instalación de Geyser tiene instrucciones para muchos hostings. - Pterodactyl: asigna el puerto al servidor en la pestaña Network.
- PC propio o VPS: abre el puerto para UDP en el firewall y, en casa, también en el router. OVH y Oracle Cloud además bloquean UDP en su propio firewall.
sudo ufw allow 19132/udp
sudo ufw reloadLos plugins de chat de voz o query no pueden compartir el puerto con Geyser. Con el puerto abierto, ejecuta geyser connectiontest <ip> <port> en la consola; comprueba el puerto y sugiere soluciones.
Instalación en una red con Velocity o BungeeCord
En una red, los jugadores de Bedrock se conectan al proxy igual que los de Java. Por eso Geyser va solo en el proxy.
- Instala Geyser y Floodgate para tu proxy (Velocity o BungeeCord) y reinicia el proxy.
- En la configuración de Geyser del proxy pon el
bedrock.porty la autenticaciónfloodgate, y abre el puerto para UDP como arriba. - Instala Floodgate-Spigot en cada backend. Es necesario para plugins que usan la API de Floodgate y mejora las skins.
- Configura el reenvío: en BungeeCord,
ip_forward: trueen suconfig.ymlybungeecord: trueen elspigot.ymlde cada backend; en Velocity, el reenvío de información de jugadores tal como lo explica la documentación de Velocity. - En la configuración de Floodgate del proxy, pon
send-floodgate-data: true. - Copia
key.pemde la carpeta de Floodgate del proxy a la carpeta de Floodgate de cada servidor backend y luego reinicia los backends y el proxy.
send-floodgate-data: trueGuarda key.pem en secreto: con él, las cuentas se saltan la autenticación de Java. Súbelo por FTP en modo binario, o tendrás errores Tag mismatch.
Nombres de Bedrock: el prefijo con punto
Floodgate pone un prefijo delante de cada nombre de Bedrock para que nunca choque con un nombre de Java. Por defecto es un punto, así que el gamertag de Xbox Steve pasa a ser .Steve en tu servidor. Los espacios del gamertag se sustituyen por _.
username-prefix: "."
replace-spaces: true- En los comandos usa el nombre completo con el prefijo. Si un comando no lo acepta, pon el nombre entre comillas:
/tp ".Steve". - Para la whitelist usa
fwhitelist add Steve. Ahí no hace falta el prefijo. - Si LuckPerms da problemas con los nombres de Bedrock, pon
allow-invalid-usernames: trueen su configuración.
GeyserMC aconseja mantener el prefijo. Los jugadores de Bedrock también votan con ese nombre: en BestMCServerList escriben .Steve, el nombre que ve tu plugin de recompensas por votar.
Cuentas vinculadas y skins (opcional)
Global Linking viene activado por defecto en Floodgate. Quien tiene las dos ediciones entra en link.geysermc.org con ambas cuentas y escribe /linkaccount. Después juega desde cualquier dispositivo con el inventario y la posición de la cuenta de Java, así que antes debería pasar sus objetos de Bedrock. Una base de datos de vínculos propia necesita una extensión extra de Floodgate.
Floodgate convierte y sube las skins de Bedrock para que los jugadores de Java las vean. Va por una cola y puede tardar un rato.
Errores típicos y soluciones
| Síntoma | Causa habitual | Solución |
|---|---|---|
| «Unable to connect to world» | Puerto UDP cerrado, puerto equivocado o ajuste del hosting | Abre el puerto para UDP, sigue las instrucciones de Geyser para tu hosting, ejecuta geyser connectiontest |
| Java funciona, Bedrock no | Puerto abierto solo para TCP | Bedrock necesita UDP |
| «Invalid IP address!» | El dominio solo tiene un registro SRV | Bedrock no admite registros SRV. Escribe la dirección IPv4 |
Address already in use al arrancar | Otra cosa usa el puerto | Dale a Geyser su propio puerto UDP |
| «Please connect through the official Geyser» | Plugins desactualizados o archivos key.pem distintos | Actualiza Geyser y Floodgate, vuelve a copiar la clave del proxy |
| «Outdated server» | Servidor demasiado antiguo para Geyser | Instala ViaVersion o actualiza el servidor |
Algunas cosas no se pueden traducir: el clic izquierdo y el derecho se ven igual en los inventarios, los comandos sin Brigadier no tienen autocompletado y los enlaces del chat no se pueden pulsar. Prueba los menús con un dispositivo Bedrock real. Los plugins pueden mostrar formularios nativos de Bedrock con la API de Floodgate, que necesita Floodgate en su servidor.
Muestra las dos direcciones en BestMCServerList
Los jugadores de Bedrock se conectan con tu dirección más el puerto de Bedrock, por ejemplo play.example.net y 19132. BestMCServerList muestra en cada página de servidor la dirección de Java y la de Bedrock por separado, cada una con su botón de copiar.
- Abre Añadir tu servidor y escribe tu dirección de Java.
- Marca Se admiten jugadores de Bedrock.
- Escribe el Puerto de Bedrock de
bedrock.port. Deja vacía la IP de Bedrock si es la misma que la de Java.
El crossplay es una ventaja real para un servidor nuevo. El resto del plan está en cómo conseguir jugadores para un servidor nuevo.