Gestionar Residencias Multi-Servidor con ResidenceBridge

Ejecutar una red Minecraft en múltiples servidores ha significado gestionar reclamaciones de residencia separadas en cada uno, algo que está a punto de cambiar. ResidenceBridge sincroniza datos de residencias en tu red Velocity o BungeeCord, permitiendo que los jugadores construyan una sola vez y reclamen globalmente. Se acabó reconstruir bases o perder tiempo con permisos por servidor.

Qué Hace ResidenceBridge

ResidenceBridge es un plugin puente escrito en Kotlin que se ubica entre el plugin Residence y tu configuración multi-servidor. Está diseñado específicamente para redes que ejecutan Velocity o BungeeCord como capa proxy, y resuelve un problema molesto: las reclamaciones de residencia son locales a cada servidor de forma predeterminada.

Piénsalo. Tu SMP tiene un servidor de supervivencia, un servidor creativo y un servidor de construcción. Un jugador construye una base en supervivencia, configura su reclamación de residencia, luego cambia al servidor de construcción para diseñar algo. ¿Esa reclamación? No existe allí. Tiene que configurar una nueva. ResidenceBridge soluciona esto manteniendo todos los datos de residencia en una base de datos MySQL central y sincronizándolos en cada servidor de tu red.

Los jugadores ahora pueden teletransportarse entre servidores mientras permanecen en su propia residencia. Comandos como /res tp no solo los envían a otro servidor, sino que mueven al jugador y luego lo teletransportan a la residencia objetivo en ese servidor. Todo es automático.

Por Qué Querrías Esto Para Tu Red

La mayoría de servidores SMP pequeños no lo necesitan. Los mundos de supervivencia de un solo servidor funcionan bien con Residence vainilla.

Pero en el momento en que expandas a múltiples servidores, ya sea un mundo de supervivencia, parcelas creativas, instancias skyblock o servidores de eventos, este plugin se paga a sí mismo rápidamente. Aquí es donde brilla:

• La retención de jugadores mejora. Construir una casa en el Servidor A, luego cambiar al Servidor B para jugar minijuegos, ¿luego volver al Servidor A? Todo se siente conectado cuando tu residencia te acompaña. Sin desorientación, sin "espera, ¿dónde está mi base?"
• La carga de trabajo del administrador disminuye. No estás arbitrando disputas sobre quién posee qué reclamación en qué servidor. Todo es global y permanente.
• La consistencia de permisos importa. ResidenceBridge se integra con LuckPerms, así que puedes establecer límites de residencia por rango de jugador. Los jugadores VIP obtienen 5 residencias en toda la red, los regulares obtienen 2, los miembros obtienen 1. Es configurable y simplemente funciona.
• El autocompletado funciona entre servidores. Cuando un jugador escribe /res tp, ve una lista de nombres de residencias de cada servidor al que puede acceder, no solo el actual.

Las redes con 50 o más jugadores regulares se benefician notablemente de este tipo de reducción de fricción.

Instalarlo

ResidenceBridge se envía como dos archivos jar separados: uno para tus sub-servidores (Paper, Spigot o Folia 1.16+) y uno para Velocity. Necesitas instalarlo en ambos lugares.

Primero, descarga ambos jars de la última versión en GitHub. La versión actual es 1.2.3, y ambos artefactos deben provenir de la misma etiqueta de versión para evitar problemas de compatibilidad.

En cada sub-servidor, coloca el jar del lado del servidor en la carpeta plugins/. Haz lo mismo con el jar de Velocity en tu proxy. Inicia cada servidor una vez para generar el archivo de configuración, luego apágalos.

Aquí es donde ocurre la verdadera configuración. Abre plugins/ResidenceBridge/config.yml en cada sub-servidor y completa los detalles de conexión MySQL:

server-id: "survival-1"

mysql:
  host: "127.0.0.1"
  port: 3306
  database: "minecraft"
  username: "root"
  password: "password"
  maximum-pool-size: 10

Asegúrate de que el server-id coincida con el nombre del servidor en el velocity.toml de Velocity. Si Velocity tiene s2 = "127.0.0.1:25567", establece server-id: "s2" en ese sub-servidor. Debe ser exacto.

Luego reinicia todos los servidores (o ejecuta /rb reload desde la consola). Una vez que estén activos, ejecuta rb sync desde la consola de cada sub-servidor para indexar cualquier dato de Residence existente del plugin Residence en la base de datos central.

Una cosa más: mantén la configuración velocity.channel en el valor predeterminado residencebridge:main. El plugin escucha en ese canal la comunicación del proxy, y cambiarlo rompe el puente. En realidad, debo señalar que esta es una de esas configuraciones que no tocas a menos que realmente sepas lo que estás haciendo.

Características Que Cambian Cómo Funciona Tu Red

Una vez que está en funcionamiento, varias cosas se hacen posibles que antes no lo eran.

Nombres de residencia globales y límites. Cada residencia obtiene un nombre único en toda tu red. Tu jugador no puede tener dos bases ambas nombradas "MyHouse" - una en supervivencia, otra en creativo, pero el sistema impone la singularidad. Renombra una residencia y el nuevo nombre se reserva en todas partes. También puedes establecer límites de residencia por permiso, así que los jugadores VIP podrían obtener 10 reclamaciones mientras que los miembros obtienen 3, y se cuenta en toda la red en lugar de por servidor.

Teletransporte entre servidores y autocompletado. Cuando un jugador escribe /res tp, ve cada residencia a la que tiene acceso, en todos los servidores. Elige una y se teletransportan a ese servidor, luego se colocan en la residencia. El sistema maneja el cambio de servidor y el teletransporte final automáticamente.

/res list global que realmente muestra todo. En lugar de mostrar solo residencias en el servidor actual, /res list ahora muestra todas las residencias propiedad de ese jugador en toda la red. Los administradores pueden ejecutar /res list <player> para auditar reclamaciones de cualquier usuario en cualquier lugar. Si necesitas gestionar tierras propiedad de jugadores, esa visibilidad es enorme.

Acciones comunes como /res rename, /res give y /res remove funcionan en servidores. El plugin detecta qué servidor posee la residencia y cambia al jugador allí para ejecutar el comando.

Mensajes personalizados con soporte completo de color. ResidenceBridge te permite personalizar mensajes de difusión con códigos de color heredados e incluso colores RGB hexadecimales. Puedes hacer que las notificaciones de residencia destaquen con estilo personalizado. Si estás diseñando esos mensajes coloreados, nuestro Generador de Texto Minecraft puede ayudarte a formatearlos rápidamente con los colores exactos que deseas.

La integración de PlaceholderAPI está incluida, así que si ejecutas servicios que necesitan mostrar el tamaño de residencia o listas, tienes marcadores de posición como %reslink_ressize% y %reslink_reslist_1% con los que trabajar. Útil para marcadores o plugins personalizados que leen estos valores.

Problemas e Inconvenientes de Configuración

La mayoría de problemas provienen de configuración desajustada o problemas de conexión MySQL.

Si los jugadores no pueden teletransportarse entre servidores, verifica que los valores de server-id coincidan exactamente con tu configuración de Velocity. Un error tipográfico allí rompe silenciosamente el puente.

La conectividad MySQL es otra. Asegúrate de que cada sub-servidor pueda llegar a tu base de datos y que todos usen las mismas credenciales. Mira, si un servidor está en una red diferente o detrás de un cortafuegos, no se sincronizará. Prueba la conexión manualmente si no estás seguro.

El temporizador de espera de teletransporte tiene un valor predeterminado de 3 segundos y es completamente configurable. Algunos administradores lo desactivan, otros lo aumentan. Si los jugadores se quejan del lag de teletransporte, verifica si tienes el temporizador de espera muy alto o si la cancelación de movimiento es demasiado agresiva. Puedes configurar diferentes tiempos de espera por grupo de permisos, lo cual es bueno para servidores híbridos donde el personal debe teletransportarse al instante pero los jugadores regulares esperan un poco.

Una cosa que he notado mientras investigaba configuraciones de plugins: algunos administradores olvidan ejecutar el comando rb sync inicial, luego se preguntan por qué las residencias antiguas no aparecen en la lista global. Ese comando es importante. Ejecútalo una vez en la configuración y listo.

Cuando explores tus bases y áreas reclamadas en servidores, podrías querer buscar primero recursos o bloques específicos. Nuestro Búsqueda de Bloques Minecraft te ayuda a identificar rápidamente dónde se encuentran bloques específicos en tus mundos, para que puedas planificar tu estrategia de exploración.

¿Vale La Pena O No

Si ejecutas un solo servidor, no lo necesitas. Usa el plugin Residence regular.

Si ejecutas 2-3 servidores y planeas quedarte allí, probablemente sea excesivo a menos que las reclamaciones sean un punto de dolor importante para tus jugadores. Pero si estás construyendo una red con planes de crecer, este plugin te ahorra enormes dolores de cabeza en el futuro. Las 102 estrellas en GitHub sugieren que es bien considerado en la comunidad de redes, y la licencia MIT significa que no hay drama de licencias - puedes bifurcarlo o modificarlo si necesitas hacerlo.

Además, se mantiene activamente.

La configuración toma alrededor de una hora una vez que tengas tu servidor MySQL listo. Es un costo único por eliminar toneladas de gestión de reclamaciones por servidor para siempre. Si estás serio sobre una red multi-servidor, el esfuerzo vale la pena.