Floodgate: Servidores Minecraft Multiplataforma

🐙 Proyecto Minecraft de código abierto

GeyserMC/Floodgate

Plugin de modo híbrido que permite a las conexiones de Geyser unirse a servidores en modo online.

⭐ 666 estrellas💻 Java📄 MIT

Ejecutar un servidor Minecraft que acepte jugadores tanto de Java como de Bedrock siempre ha sido un desafío técnico. Floodgate es la pieza que faltaba para hacerlo posible, permitiendo que tus amigos de Bedrock (en mobile, consola o Windows 11 Edition) se unan al mismo servidor que los jugadores de Java sin romper la autenticación ni crear dolores de cabeza administrativos.

Qué hace Floodgate

Floodgate es un plugin que resuelve un problema específico: permitir que los jugadores de Bedrock se autentiquen en servidores Java en modo online. Aquí está el problema que aborda. Normalmente, los servidores en modo online solo aceptan jugadores de Java Edition con cuentas Mojang válidas que hayan iniciado sesión a través del launcher oficial. Los jugadores de Bedrock Edition (ya sea en mobile, Switch, PlayStation o Windows 11) no tienen cuentas Mojang y no están en ese sistema de autenticación. No pueden iniciar sesión en absoluto.

Aquí es donde entra Geyser. Geyser traduce el protocolo de Bedrock al protocolo de Java para que los jugadores de Bedrock puedan conectarse técnicamente a servidores Java. Pero Geyser solo no resuelve el problema de autenticación. Puedes ejecutar Geyser en servidores en modo offline (donde cualquiera se une con cualquier nombre), pero eso te deja vulnerable a griefing, suplantación de identidad y jugadores destruyendo tu servidor. Si quieres un servidor real y seguro con progresión de jugadores real y consecuencias, necesitas modo online.

Floodgate cubre esa brecha, pero proporciona el sistema de encriptación y tokens que prueba a tu servidor Java: "Este jugador de Bedrock es legítimo y verificado por Geyser." Sin cuentas falsas. Sin suplantación. Solo apretones de manos firmados criptográficamente.

Suena simple en la superficie, pero detrás de las escenas está haciendo encriptación, validación de tokens, verificación de cuenta y gestión de sesiones para hacer que todo funcione sin problemas.

Por qué ejecutar un servidor multiplataforma

Antes de configurar esto, pregúntate honestamente: ¿realmente lo necesitas?

Los servidores multiplataforma son realmente útiles si estás en una de algunas pocas situaciones. Estás intentando construir una comunidad más grande y los jugadores de Bedrock superan vastamente en número a los jugadores de Java en general. Quieres apoyar a amigos en diferentes plataformas sin ejecutar dos servidores separados. Estás construyendo una economía persistente o un mundo compartido y quieres que todos estén en un lugar experimentándolo juntos.

No todos los servidores necesitan esto. Si estás ejecutando un pequeño realm vanilla con tres amigos cercanos, Geyser en modo offline está bien. No necesitas la sobrecarga de seguridad. Pero si quieres un servidor público próspero con progresión que importe, economías compartidas, gremios o sistemas de misiones, entonces vale la pena el esfuerzo.

Cómo instalar y configurar

Necesitarás tres cosas. Un servidor Java Edition ejecutando Paper, Spigot u otro software de servidor compatible. Geyser instalado (generalmente como un plugin en la misma instancia del servidor). Floodgate mismo, que descargas del sitio web oficial de GeyserMC y arrastras a tu carpeta de plugins.

En el primer inicio, Floodgate genera un par de claves automáticamente. Este es un par de claves RSA: una clave pública y una clave privada. La clave privada firma los tokens de autenticación que prueban que los jugadores de Bedrock son reales. Esa clave pública permite que tu servidor verifique esas firmas. Mantén tu clave privada segura. Si alguien la roba, pueden falsificar tokens de autenticación y conexiones falsas de Bedrock.

Tu archivo de configuración de Geyser necesita ser consciente de que Floodgate existe. En la configuración de Geyser, establece la opción auth-type apropiadamente y apúntala a la dirección de tu servidor Java. Si Geyser y Floodgate se están ejecutando en la misma instancia de Paper (que es la configuración más simple), esta comunicación ocurre automáticamente a través de IPC interno.

Una trampa que atrapa a la gente: si Geyser y Floodgate están en máquinas diferentes (digamos, Geyser en un servidor proxy y tu servidor Java en otro lugar), necesitas conectividad de red entre ellos. Asegúrate de que tu firewall permite conexiones de Geyser a tu servidor Java en el puerto configurado. La mayoría de la gente los ejecuta juntos en una instancia de Paper, así que esto generalmente no es un problema.

Cómo funciona la autenticación

Aquí está el flujo. Un jugador de Bedrock inicia Minecraft en su dispositivo. Geyser intercepta la conexión. El dispositivo del jugador de Bedrock envía su token de autenticación de Xbox Live a Geyser (o lo pasa localmente si Geyser está en el mismo dispositivo). Geyser valida con los servidores de Microsoft que el token de Xbox Live es real.

Una vez validado, Geyser crea un token de Floodgate que incluye el UUID y nombre de usuario del jugador de Bedrock. Geyser firma este token con la clave privada de Floodgate y lo envía al servidor Java. El servidor Java recibe el token firmado y verifica la firma usando la clave pública. Si la firma es válida, el servidor confía en que la conexión es legítima y el jugador inicia sesión.

Desde la perspectiva del servidor Java, esto se parece a cualquier otra conexión de jugador legítima. Los jugadores de Java y los jugadores de Bedrock juegan juntos en el mismo mundo exacto, comparten el mismo sistema de inventario exacto y experimentan la misma economía y progresión exactas. Literalmente no puedes notar la diferencia en el juego a menos que verifiques el UUID del jugador (los jugadores de Bedrock obtienen un UUID derivado determinísticamente basado en su UUID de Bedrock original, por lo que se mantiene consistente entre sesiones).

Si estás ejecutando plugins, puedes detectar si un jugador vino a través de Floodgate y aplicar lógica especial si quieres (como restringir ciertas características solo a Java o viceversa). Pero el comportamiento por defecto es la unificación completa.

De hecho, aquí hay algo que encontré sorprendente: si estás usando herramientas como la Calculadora de Portal del Nether para ayudar a los jugadores a navegar el Nether entre plataformas, o nuestro Generador de Texto para señalización personalizada y mensajes de chat, esos funcionan idénticamente para jugadores de Bedrock y Java una vez que Floodgate está manejando la autenticación. La experiencia del jugador es verdaderamente unificada.

Problemas comunes, solución de problemas y alternativas

Las discrepancias de versión entre Floodgate y Geyser causan la gran mayoría de fallos de autenticación. Floodgate 2.x es compatible con Geyser 2.x. Floodgate 1.x funciona con Geyser 1.x. Si actualizas uno sin actualizar el otro, obtendrás errores de validación de tokens. Actualízalos juntos, no por separado.

Tu servidor debe estar ejecutándose en modo online. Si está en modo offline, Floodgate no funcionará correctamente. Sí, el modo online tiene un pequeño costo de rendimiento (Microsoft autentica cada jugador en el inicio de sesión), pero la seguridad vale la pena.

Los jugadores de Bedrock detrás de firewalls corporativos restrictivos o ciertas VPNs a veces luchan por establecer la conexión a través de Geyser. Este es un problema de infraestructura de red, no un problema de Floodgate. Si estás ejecutando un servidor global y notas problemas de conectividad desde ciertas regiones, considera ejecutar un proxy de Geyser más cercano a tus jugadores objetivo.

Cuando la autenticación falla, verifica los registros de Floodgate primero. Generalmente son explícitos sobre qué salió mal: firma de token incorrecta, discrepancia de versión, tiempo de espera de red o firewall bloqueando. Leer los mensajes de error ahorra horas de tiempo de depuración.

Ahora bien, es posible que no necesites Floodgate en absoluto. Eso vale la pena reconocer. Los plugins de ViaVersion manejan la compatibilidad con múltiples versiones de Java en el mismo servidor, pero no resuelven el juego multiplataforma como lo hace Floodgate. Ejecutar dos servidores completamente separados (uno para Java, otro para Bedrock) y sincronizarlos a través de una base de datos compartida es viable arquitectónicamente si quieres aislamiento total. Algunas plataformas de hosting de terceros agrupan Geyser y Floodgate automáticamente, que es el camino más fácil si no quieres configurarlo tú mismo.

Pero si estás ejecutando tu propio servidor Java y quieres abrirlo a jugadores de Bedrock mientras mantienes la seguridad del modo online, Floodgate es la herramienta estándar. Es maduro, probado en batalla en servidores con miles de jugadores concurrentes, y el soporte de la comunidad de GeyserMC es sólido. El proyecto tiene 666 estrellas en GitHub y está escrito en Java, lo que lo convierte en un ajuste natural para el ecosistema de servidores Minecraft.