Server Teleporters

Plugin de Teletransportadores entre Servidores

Un plugin de Hytale que permite la teletransportación entre servidores de forma fluida utilizando el sistema de teletransportadores y de desplazamiento nativo del juego.

Características

Teletransportación entre Servidores

Transfiere jugadores entre múltiples servidores de Hytale utilizando teletransportadores dentro del juego
Funciona con los bloques de teletransportador nativos de Hytale y el sistema de desplazamiento
Generación automática de jugadores en ubicaciones designadas en el servidor de destino

Interfaz de Comandos Sencilla

Comandos cortos y fáciles de recordar
Listar, crear y eliminar desplazamientos y ubicaciones de aparición

Almacenamiento Persistente

Datos de desplazamiento entre servidores almacenados en crossserver_warps.json
Sobrevive a los reinicios del servidor
Separado del warps.json de Hytale para evitar conflictos

Integración Nativa

Utiliza los bloques de teletransportador integrados de Hytale
Configura destinos a través de la interfaz normal del teletransportador
No se requieren bloques personalizados ni configuraciones complejas

Comandos

Desplazamientos entre Servidores

Registrar un desplazamiento entre servidores

/csw <nombreDesplazamiento> <servidorDestino> <idTeletransportador>

Eliminar un desplazamiento entre servidores

/delcsw <nombreDesplazamiento>

Listar todos los desplazamientos entre servidores

/listcsw

Ubicaciones de Aparición de Teletransportadores

Establecer ubicación de aparición en la posición actual

/settp <idTeletransportador>

Eliminar una ubicación de aparición

/deltp <idTeletransportador>

Listar todas las ubicaciones de aparición

/listtp

Cómo Funciona

Paso 1: Registrar un Desplazamiento entre Servidores

En el servidor fuente, crea un desplazamiento que redirigirá a los jugadores:

/csw hubWarp localhost:25565 spawn1

Esto crea un desplazamiento llamado hubWarp que transfiere a los jugadores a localhost:25565 y los genera en el teletransportador ID spawn1.

Paso 2: Establecer Ubicación de Aparición

En el servidor de destino, colócate donde quieras que aparezcan los jugadores y ejecuta:

/settp spawn1

Paso 3: Configurar Teletransportador

Coloca un bloque de teletransportador en el juego, haz clic derecho para configurarlo y selecciona el desplazamiento hubWarp de la lista.

Paso 4: Usar el Teletransportador

Cuando un jugador atraviese el teletransportador configurado, este:

Será transferido al servidor de destino
Aparecerá en la ubicación registrada del teletransportador

Detalles Técnicos

Coincidencia de Desplazamiento Basada en Posición

La implementación actual es bastante rudimentaria debido a la imposibilidad de acceder al nombre del desplazamiento de destino de un portal cuando el jugador lo atraviesa (se está trabajando en esto)

Cada desplazamiento entre servidores se asigna a coordenadas únicas (por ejemplo, 10000, 100, 10000)
El sistema intercepta eventos de teletransporte y coincide con las coordenadas de destino
Si se encuentra una coincidencia en el registro de desplazamientos entre servidores, se activa la transferencia

Integración del Sistema ECS

CrossServerTeleportInterceptor – RefChangeSystem que intercepta adiciones del componente Teleport
Modifica el destino del teletransporte para evitar movimientos no deseados
Llama a PlayerRef.referToServer() para iniciar la transferencia entre servidores

Almacenamiento de Datos

El plugin almacena datos de desplazamiento entre servidores en universe/crossserver_warps.json:

{
  "warps": {
    "hubwarp": {
      "targetServer": "localhost:25565",
      "teleporterId": "spawn1"
    }
  }
}

Copia build/libs/Hub-1.0.0-all.jar a la carpeta plugins/ de tu servidor Hytale
Reinicia el servidor
Configura los desplazamientos entre servidores utilizando los comandos anteriores

Casos de Uso

Redes de Servidores
Conecta múltiples servidores de juego (lobby a minijuegos a supervivencia)

Contenido Basado en Instancias
Transfiere jugadores a servidores dedicados para mazmorras/raids

Balanceo de Carga
Distribuye jugadores entre múltiples servidores

Servidores Regionales
Conecta servidores en diferentes ubicaciones geográficas

Consideraciones de Seguridad

Importante: Este plugin está actualmente en desarrollo y no tiene características de seguridad integradas. La mayoría de estas se están trabajando en este momento