Server Hop

ServerHop – Plugin de Teletransportador Multi-Servidor

¡Conecta sin problemas tu red de servidores Hytale con bloques de teletransporte interactivos!

🌟 Visión General

ServerHop es un plugin para servidores de Hytale que te permite crear bloques de teletransporte que transportan a los jugadores entre servidores en tu red. Perfecto para servidores de vestíbulo, mundos hub o cualquier configuración de múltiples servidores donde desees una navegación fluida para los jugadores.

¡Simplemente colócate sobre un bloque, ejecuta un comando y ese bloque se convierte en un portal a otro servidor!

✨ Características

• 🚪 Activación al Pasar – Los jugadores ven una cuenta atrás cuando caminan sobre un portal, mostrándoles a qué mundo están a punto de trasladarse
• 🎨 Bloques de Teletransporte Visuales – Coloca automáticamente bloques de portal para una clara retroalimentación visual
• ⚙️ Configuración Sencilla – Comandos simples para configurar y gestionar los teletransportadores
• 💾 Almacenamiento Persistente – Todas las configuraciones se guardan automáticamente en formato JSON
• 🌍 Conocimiento del Mundo – Rastrean los teletransportadores a través de diferentes mundos utilizando identificadores únicos
• ⏱️ Enfriamiento Inteligente – Un enfriamiento de 1 segundo previene reactivaciones rápidas accidentales
• 🔌 Ligero – Mínimo impacto en el rendimiento utilizando sistemas de entidades eficientes

📦 Instalación

Descarga la última ServerHop-1.0-SNAPSHOT.jar de la sección de archivos

Coloca el archivo JAR en la carpeta mods/ de tu servidor Hytale

Reinicia tu servidor

Configura los teletransportadores utilizando los comandos del juego a continuación

El plugin creará automáticamente su directorio de configuración en mods/ServerHop/

🎮 Comandos

/setteleporter <host> <port> [displayName]

Crea un teletransportador en el bloque en el que estás de pie.

Ejemplos:

/setteleporter play.example.com 5520
/setteleporter 192.168.1.100 5520 Servidor de Supervivencia
/setteleporter minigames.mynetwork.com 25565 Minijuegos Divertidos

Uso:

Colócate sobre el bloque que deseas convertir en un teletransportador

Ejecuta el comando con los detalles de tu servidor de destino

Se colocará automáticamente un bloque de teletransporte visual

¡Camina sobre el bloque para probar la conexión!

/removeteleporter

Elimina el teletransportador del bloque en el que estás de pie.

Uso:

Colócate sobre cualquier bloque de teletransportador

Ejecuta /removeteleporter

El bloque vuelve a la normalidad

/listteleporters

Lista todos los teletransportadores configurados en el servidor.

Ejemplo de Salida:

=== Teletransportadores Configurados ===
Total: 3

1. Servidor de Supervivencia
   Ubicación: 10, 64, 20
   Servidor: play.example.com:5520

2. Hub de Minijuegos
   Ubicación: 15, 64, 20
   Servidor: minigames.example.com:5520

3. Mundo Creativo
   Ubicación: 20, 64, 20
   Servidor: 192.168.1.150:5520

🏗️ Ejemplo de Configuración: Servidor de Vestíbulo

Crea un hub central con teletransportadores a múltiples servidores de juego:

# Crea un teletransportador para el servidor de supervivencia
/setteleporter survival.mynetwork.com 5520 Modo Supervivencia

# Crea un teletransportador para minijuegos
/setteleporter minigames.mynetwork.com 5520 Minijuegos

# Crea un teletransportador para el servidor creativo
/setteleporter creative.mynetwork.com 5520 Construcción Creativa

# Lista todos los teletransportadores para verificar
/listteleporters

¡Ahora los jugadores pueden caminar sobre cualquiera de estos bloques para saltar instantáneamente a ese servidor!

🔧 Cómo Funciona

Designa un bloque como teletransportador utilizando /setteleporter

Indicador Visual – El plugin coloca un bloque de portal en esa ubicación

Activación del Jugador – Cuando un jugador camina sobre el bloque, es transferido

Transferencia Sin Problemas – Utiliza la API nativa de Hytale PlayerRef.referToServer()

Auto-Guardado – La configuración persiste a través de los reinicios del servidor

📋 Requisitos

• Servidor Hytale (compatible con el protocolo QUIC)
• Java 25 o superior
• Red de Múltiples Servidores – Se requieren al menos 2 servidores para teletransportar entre ellos

🛠️ Compilación desde la Fuente

Si deseas compilar el plugin tú mismo:

git clone <tu-repositorio>
cd ServerHop
mvn clean package

El JAR compilado se ubicará en target/ServerHop-1.0-SNAPSHOT.jar

🐛 Informes de Errores y Solicitudes de Funciones

¿Encontraste un error o tienes una idea para una nueva función? ¡Déjamelo saber en los comentarios!

📝 Configuración

Todas las configuraciones de teletransportadores se almacenan en mods/ServerHop/teleporters.json. Puedes editar manualmente este archivo si es necesario, pero se recomienda utilizar los comandos del juego para una validación adecuada.

Ejemplo de Configuración:

{
  "teleporters": {
    "world-abc123_10_64_20": {
      "host": "survival.server.com",
      "port": 5520,
      "displayName": "Servidor de Supervivencia"
    }
  }
}

🙏 Créditos

Creado por SpaceTurtles

¡Un agradecimiento especial a la comunidad de Hytale por sus comentarios y pruebas!

📊 Historial de Versiones

Versión 1.0-SNAPSHOT

• Lanzamiento inicial
• Activación del teletransportador al caminar
• Colocación automática de bloques visuales
• Sistema de configuración basado en JSON
• Seguimiento de la ubicación del bloque con conocimiento del mundo
• Tres comandos de gestión (configurar, eliminar, listar)
• Sistema de enfriamiento de 1 segundo
• Transferencia de servidor utilizando la API nativa de Hytale

¡Disfruta construyendo tu red de múltiples servidores con ServerHop! 🚀

¡Si te gusta este plugin, háznoslo saber en los comentarios!