Saltar al contenido principal

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 traduce clientes Bedrock 1.21.x y soporta servidores Java 1.13 – 1.21.5
  • Requiere Java 17 o superior en el servidor

¿Para qué sirve cada cosa?​

PluginFunción¿Es obligatorio?
GeyserTraduce el protocolo Bedrock → Java. Sin él nada funciona.✅ Sí
FloodgateAutentica 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
  • El puerto UDP 19132 disponible (o cualquier otro que elijas para Bedrock)
  • Java 17 o superior (en MixelNodes ya viene configurado por defecto)
Puerto UDP

El puerto de Bedrock usa el protocolo UDP, no TCP. Asegúrate de que el puerto esté asignado como UDP en tu servidor. Más adelante te explicamos cómo hacerlo desde SkyPanel.

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

Página de descarga de GeyserMC

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:

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 — Abrir el puerto UDP en SkyPanel​

Este es el paso que más gente olvida. Geyser usa UDP en el puerto 19132, y hay que asegurarse de que ese puerto esté asignado a tu servidor.

  1. En SkyPanel ve a la configuración de tu servidor
  2. En la sección de Network / Puertos comprueba que tienes el puerto 19132 asignado con protocolo UDP
  3. Si no aparece, contacta con el soporte de MixelNodes para que lo añadan — puedes hacerlo desde Discord
¿Por qué es diferente al puerto 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 dos puertos separados y ambos deben estar abiertos.

Paso 6 — Probar la conexión​

Desde Minecraft Bedrock​

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

CampoValor
Nombre del servidorEl nombre que quieras
DirecciónLa IP de tu servidor MixelNodes
Puerto19132 (o el que hayas configurado)

Test de conectividad desde la consola​

Ejecuta este comando en la consola de SkyPanel para verificar que el puerto es accesible desde fuera:

geyser connectiontest

Si el resultado es verde, todo está bien. Si 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 UDP está abierto y asignado en SkyPanel
  2. Ejecuta geyser connectiontest en la consola
  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: "class file version 60.0" al cargar Geyser

El servidor necesita Java 17 o superior. 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 problema de versión. Asegúrate de que tu servidor Java es compatible con la versión de Geyser instalada (1.13–1.21.5). Actualiza Geyser a la última versión 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ónauth-type
Quiero que solo entren jugadores con cuenta Java (y Bedrock)online
Quiero que entren jugadores Bedrock sin cuenta Javafloodgate (+ instalar Floodgate)

Enlaces de descarga y recursos​