Geyser + Floodgate: Crossplay Java & Bedrock

Geyser es un puente que traduce el protocolo de Minecraft Bedrock al de Java Edition, permitiendo que jugadores de móvil, consola (Xbox, PlayStation, Switch) y Windows 10/11 se conecten a tu servidor Java sin modificar nada en el cliente.

Floodgate es un complemento opcional que permite que esos jugadores entren sin necesidad de tener una cuenta de Java Edition — solo necesitan su cuenta de Microsoft/Xbox.

¿Qué versiones soporta?

• Geyser se actualiza constantemente para soportar la última versión de Minecraft Bedrock y Java. Consulta siempre las versiones soportadas antes de instalar.
• Geyser emula una única versión de Java (la más reciente). Si tu servidor es de una versión distinta, necesitarás también el plugin ViaVersion para hacer de puente.
• Requiere Java 21 o superior en el servidor (en servidores 1.20.5+; en MixelNodes ya viene por defecto).

¿Tienes una red con proxy (Velocity/BungeeCord)?

Esta guía es para un servidor único. Si tienes una red (varios servidores tras un proxy), la instalación cambia: Geyser va en el proxy (Geyser-Velocity o Geyser-BungeeCord, no el de Spigot), y Floodgate debe estar en el proxy y en cada servidor, todos con la misma versión y el mismo key.pem. Si las versiones no coinciden, no funcionará. Pásate por el Discord y te ayudamos con el caso de red.

---

¿Para qué sirve cada cosa?

Plugin	Función	¿Es obligatorio?
Geyser	Traduce el protocolo Bedrock → Java. Sin él nada funciona.	✅ Sí
Floodgate	Autentica jugadores Bedrock con su cuenta Xbox sin Java Edition.	⬜ Opcional

Resumen rápido:

• Solo Geyser → los jugadores Bedrock pueden entrar, pero necesitan una cuenta de Java Edition.
• Geyser + Floodgate → los jugadores Bedrock entran solo con su cuenta de Xbox/Microsoft.

---

Requisitos previos

Antes de empezar asegúrate de tener:

• Un servidor con Paper, Spigot u otro fork compatible (Purpur, etc.)
• Acceso al SkyPanel en panel.mixelnodes.com
• Un puerto extra asignado para Bedrock (por defecto 19132)
• Java 21 o superior (en MixelNodes ya viene configurado por defecto)

El puerto de Bedrock

Los jugadores Bedrock se conectan a un puerto distinto del de Java (que es TCP 25565). Por eso necesitas una asignación (allocation) adicional para Bedrock, normalmente el 19132. SkyPanel reenvía TCP y UDP de forma automática en cada puerto asignado: no tienes que elegir protocolo. Más adelante te explicamos cómo añadirlo.

---

Paso 1 — Descargar los plugins

Ve a la página oficial de descargas y descarga los archivos según tu tipo de servidor:

👉 geysermc.org/download

En la página verás varias opciones. Para un servidor Paper/Spigot estándar descarga:

• Geyser-Spigot.jar (columna Spigot)
• Floodgate-Spigot.jar — solo si quieres que entren sin cuenta Java

Hangar (alternativa)

También puedes descargar desde Hangar, el repositorio oficial de PaperMC:

• Geyser en Hangar
• Floodgate en Hangar

---

Paso 2 — Subir los plugins a SkyPanel

1. Abre panel.mixelnodes.com e inicia sesión
2. Selecciona tu servidor de Minecraft Java
3. En el menú lateral haz clic en Files (Archivos)
4. Navega a la carpeta /plugins
5. Arrastra y suelta el archivo Geyser-Spigot.jar (y Floodgate-Spigot.jar si lo vas a usar)

Orden de instalación

Si vas a instalar Floodgate, súbelo junto a Geyser en el mismo paso. Ambos deben estar en la carpeta plugins/ antes de arrancar el servidor.

---

Paso 3 — Arrancar el servidor

1. Ve a la pestaña Console en SkyPanel
2. Haz clic en Start (o Restart si el servidor ya estaba encendido)
3. Espera a que cargue completamente — verás mensajes como:

[Geyser-Spigot] ******************************************
[Geyser-Spigot] Loading Geyser version 2.x.x ...
[Geyser-Spigot] Started Geyser on 0.0.0.0:19132
[Geyser-Spigot] Done (Xs)! Run /geyser help for help!

El servidor habrá generado los archivos de configuración en plugins/Geyser-Spigot/config.yml.

---

Paso 4 — Configurar Geyser

Ve a Files → plugins → Geyser-Spigot → config.yml en SkyPanel y edita el archivo.

Las opciones más importantes son las siguientes:

Sección bedrock — conexiones entrantes de Bedrock

bedrock:
  # IP en la que escucha Geyser. 0.0.0.0 = todas las interfaces (correcto)
  address: 0.0.0.0
  # Puerto UDP al que se conectarán los clientes Bedrock
  port: 19132
  # Muestra el servidor en el apartado "Amigos" de Bedrock (LAN)
  broadcast-to-lan: true

Sección remote — conexión con tu servidor Java

remote:
  # "auto" funciona perfectamente en modo plugin (lo más habitual)
  address: auto
  port: 25565
  # Opciones: online, floodgate, offline
  # - online   → los Bedrock necesitan cuenta Java (autenticación Mojang)
  # - floodgate → los Bedrock entran con su cuenta Xbox (requiere Floodgate instalado)
  # - offline  → sin autenticación (NO RECOMENDADO, riesgo de seguridad)
  auth-type: online

No uses offline salvo que sepas lo que haces

El modo offline deshabilita la autenticación por completo. Cualquier persona puede entrar con cualquier nombre. Además va contra los Términos de Servicio de Mojang.

Si instalas Floodgate

Cambia auth-type a floodgate:

remote:
  address: auto
  port: 25565
  auth-type: floodgate   # ← cambiar esto

Guarda el archivo y reinicia el servidor desde la consola de SkyPanel.

---

Paso 5 — Asignar el puerto de Bedrock en SkyPanel

Este es el paso que más gente olvida. Geyser escucha en el puerto 19132, y ese puerto debe estar asignado a tu servidor como una asignación adicional.

1. En SkyPanel ve a la sección Network (Red) de tu servidor
2. Comprueba que tienes el puerto 19132 en la lista de asignaciones (además del 25565 de Java)
3. Si no aparece, contacta con el soporte de MixelNodes para que lo añadan — puedes hacerlo desde Discord

¿Por qué es un puerto distinto al de Java?

Los jugadores Java se conectan por TCP (puerto 25565 por defecto). Los jugadores Bedrock usan un protocolo distinto (RakNet) que funciona sobre UDP. Son puertos separados. No tienes que elegir TCP o UDP en el panel: cada asignación reenvía ambos automáticamente.

---

Paso 6 — Probar la conexión

Desde Minecraft Bedrock

En Bedrock, ve a Jugar → Servidores → Añadir servidor e introduce:

Campo	Valor
Nombre del servidor	El nombre que quieras
Dirección	La IP de tu servidor MixelNodes
Puerto	19132 (o el que hayas configurado)

Comprobar que el puerto es accesible

Para verificar que el puerto de Bedrock es accesible desde fuera, usa el test de conexión oficial de GeyserMC:

👉 geysermc.org → Connection Test — introduce la IP de tu servidor y el puerto (19132).

Si quieres comprobar que Geyser cargó bien por dentro, en la consola de SkyPanel puedes ejecutar geyser dump (vuelca la configuración cargada) o geyser statistics. Si el test falla, revisa el apartado de solución de problemas.

---

Floodgate en detalle

Si instalaste Floodgate, aquí tienes lo que necesitas saber.

Prefijo de nombres de usuario

Floodgate añade un prefijo a todos los jugadores Bedrock para evitar conflictos con cuentas Java del mismo nombre. Por defecto es . (punto):

.TuNombreXbox   ← jugador Bedrock
TuNombreXbox    ← jugador Java (diferente jugador)

Puedes cambiarlo en plugins/floodgate/config.yml:

# Prefijo para jugadores Bedrock. Por defecto "."
# Puedes cambiarlo a "_" o dejarlo vacío "" (no recomendado)
username-prefix: "."

No elimines el prefijo sin pensarlo

Si hay jugadores Java y Bedrock con el mismo nombre y eliminas el prefijo, pueden surgir problemas como teletransportaciones incorrectas o permisos cruzados. Solo elimínalo si estás seguro de que no habrá duplicados.

El archivo key.pem

Floodgate genera un archivo plugins/floodgate/key.pem. Este archivo es una clave de cifrado privada.

• ❌ No lo compartas con nadie
• ❌ No lo subas a GitHub ni ningún sitio público
• ✅ Si usas varios servidores en red (proxy), todos deben tener la misma clave

---

Solución de problemas

Los jugadores Bedrock no pueden conectar

1. Comprueba que el puerto 19132 está asignado a tu servidor en SkyPanel
2. Usa el test de conexión de GeyserMC con tu IP y puerto
3. Verifica que bedrock.port en config.yml coincide con el puerto asignado
4. Asegúrate de que el servidor arrancó sin errores relacionados con Geyser

Error: "has been compiled by a more recent version of Java" al cargar Geyser

El servidor está usando una versión de Java demasiado antigua. Geyser necesita Java 21 o superior (el error suele mencionar class file version 65.0). En SkyPanel puedes cambiar la versión de Java desde la configuración de tu servidor, o contacta con soporte.

Error de autenticación al entrar

• Si usas auth-type: floodgate → asegúrate de que Floodgate está instalado y el servidor se reinició
• Si usas auth-type: online → el jugador Bedrock necesita una cuenta de Java Edition
• Verifica que el archivo key.pem de Floodgate existe en plugins/floodgate/

Geyser arranca pero nadie puede unirse

Revisa en la consola que aparece esta línea al arrancar:

[Geyser-Spigot] Started Geyser on 0.0.0.0:19132

Si el puerto es diferente a 19132, actualiza la configuración en tu cliente Bedrock.

Los jugadores Bedrock se unen pero sin inventario / chunks vacíos

Suele ser un desajuste de versión entre Geyser y tu servidor. Recuerda que Geyser emula la última versión de Java: si tu servidor es de otra versión, instala también ViaVersion. Y mantén Geyser actualizado desde geysermc.org/download.

---

Resumen rápido

plugins/
├── Geyser-Spigot.jar              ← plugin principal
├── Floodgate-Spigot.jar           ← opcional (sin cuenta Java)
├── Geyser-Spigot/
│   └── config.yml                 ← configuración de Geyser
└── floodgate/
    ├── config.yml                 ← configuración de Floodgate
    └── key.pem                    ← clave privada (¡no compartir!)

Situación	auth-type
Quiero que solo entren jugadores con cuenta Java (y Bedrock)	online
Quiero que entren jugadores Bedrock sin cuenta Java	floodgate (+ instalar Floodgate)

---

Enlaces de descarga y recursos

• 📥 Descargar Geyser
• 📥 Descargar Floodgate
• 📖 Wiki oficial de GeyserMC
• 🐛 Problemas conocidos y soporte
• 💬 Discord de MixelNodes — si tienes dudas, estamos aquí