Guía Completa del Servidor Hytale: Configuración y Administración

¿Quieres crear tu propio servidor de Hytale pero no sabes por dónde empezar? Esta guía te llevará paso a paso por todo lo que necesitas saber para configurar, ejecutar y administrar un servidor dedicado de Hytale, desde los conceptos básicos hasta configuraciones avanzadas.

¿Para quién es esta guía?

Esta guía está pensada para:

• Administradores de servidores que quieren configurar su propio servidor
• Jugadores que desean alojar un servidor para ellos y sus amigos
• Desarrolladores interesados en crear experiencias personalizadas con mods y plugins

No necesitas ser un experto en programación, pero sí tener conocimientos básicos de línea de comandos y administración de sistemas.

---

Contenido de la Guía

Esta guía cubre los siguientes temas:

Sección	Qué aprenderás
Configuración Inicial	Cómo instalar Java y obtener los archivos del servidor
Ejecutar el Servidor	Comandos básicos, autenticación y configuración de red
Consejos y Trucos	Optimización, mods, plugins recomendados y ajustes de rendimiento
Arquitectura Multiserver	Cómo conectar múltiples servidores y crear redes complejas
Detalles Adicionales	Configuraciones avanzadas y optimizaciones del JVM
Funcionalidades Futuras	Qué viene en el futuro para los servidores de Hytale

---

Configuración Inicial

Requisitos del Sistema

Antes de comenzar, asegúrate de que tu servidor cumpla con estos requisitos mínimos:

Requisitos básicos:

• Memoria RAM: Mínimo 4 GB (recomendado 8 GB o más)
• Java: Versión 25 (OpenJDK 25)
• Arquitectura: x64 o arm64 (ambas son compatibles)
• Espacio en disco: Al menos 10 GB libres (más si planeas tener muchos mundos)

¿Por qué estos requisitos?

El uso de recursos depende mucho de cómo se use el servidor:

• CPU: Se usa más cuando hay muchos jugadores o entidades (NPCs, criaturas) activas
• RAM: Se consume más cuando hay un área grande del mundo cargada (muchos jugadores explorando en diferentes direcciones)

💡 Consejo: Es difícil saber exactamente cuánta RAM necesita un proceso Java sin herramientas especializadas. Experimenta con diferentes valores del parámetro -Xmx de Java para establecer límites explícitos. Si ves que el CPU se dispara, podría ser porque el servidor está haciendo “limpieza de memoria” (garbage collection) constantemente.

Instalación de Java 25

Hytale requiere Java 25 para funcionar. Te recomendamos usar Adoptium (anteriormente conocido como AdoptOpenJDK), que es una distribución confiable y mantenida por la comunidad.

Paso 1: Descargar Java 25

Visita Adoptium y descarga la versión 25 para tu sistema operativo.

Paso 2: Instalar Java

Sigue las instrucciones de instalación según tu sistema operativo:

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install openjdk-25-jdk

Windows: Descarga el instalador .msi y ejecútalo siguiendo el asistente.

macOS: Descarga el archivo .pkg y ejecútalo, o usa Homebrew:

brew install openjdk@25

Paso 3: Verificar la Instalación

Abre una terminal o línea de comandos y ejecuta:

java --version

Deberías ver algo como esto:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

Si ves esta salida, ¡Java está instalado correctamente! 🎉

Obtener los Archivos del Servidor

Tienes dos opciones para obtener los archivos del servidor de Hytale:

Opción 1: Copiar Manualmente desde el Launcher

Mejor para: Pruebas rápidas. Puede ser molesto mantener actualizado.

Si ya tienes el launcher de Hytale instalado, puedes copiar los archivos directamente:

Ubicaciones de los archivos:

• Windows: %appdata%\Hytale\install\release\package\game\latest
• Linux: $XDG_DATA_HOME/Hytale/install/release/package/game/latest
• macOS: ~/Application Support/Hytale/install/release/package/game/latest

Pasos:

1. Navega a la carpeta mencionada según tu sistema operativo
2. Verifica que contenga estas carpetas:

   ├── Client/
   ├── Server/
   └── Assets.zip

3. Copia la carpeta Server/ y el archivo Assets.zip a tu carpeta de servidor

Opción 2: Usar el Hytale Downloader CLI (Recomendado)

Mejor para: Servidores en producción. Fácil de mantener actualizado.

El Hytale Downloader es una herramienta oficial de línea de comandos que descarga automáticamente los archivos del servidor y los assets usando autenticación OAuth2.

Descargar:

• hytale-downloader.zip (Linux & Windows)

Comandos útiles:

Comando	Descripción
./hytale-downloader	Descarga la última versión
./hytale-downloader -print-version	Muestra la versión del juego sin descargar
./hytale-downloader -version	Muestra la versión del downloader
./hytale-downloader -check-update	Verifica actualizaciones del downloader
./hytale-downloader -download-path game.zip	Descarga a un archivo específico
./hytale-downloader -patchline pre-release	Descarga desde el canal pre-release
./hytale-downloader -skip-update-check	Omite la verificación automática de actualizaciones

📖 Nota: Dentro del archivo ZIP encontrarás un archivo QUICKSTART.md con instrucciones detalladas.

---

Ejecutar el Servidor

Comando Básico de Inicio

Una vez que tengas los archivos, inicia el servidor con este comando:

java -jar HytaleServer.jar --assets PathToAssets.zip

Explicación del comando:

• java -jar HytaleServer.jar: Ejecuta el servidor usando Java
• --assets PathToAssets.zip: Le dice al servidor dónde encontrar los archivos de assets (texturas, modelos, etc.)

Autenticación del Servidor

La primera vez que ejecutes el servidor, necesitarás autenticarlo con tu cuenta de Hytale.

Proceso de Autenticación

1. Inicia el servidor con el comando anterior
2. Ejecuta en la consola del servidor:

   /auth login device

3. Verás un mensaje como este:

   ===================================================================
   DEVICE AUTHORIZATION
   ===================================================================
   Visit: https://accounts.hytale.com/device
   Enter code: ABCD-1234
   Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234
   ===================================================================
   Waiting for authorization (expires in 900 seconds)...

4. Abre la URL en tu navegador e ingresa el código mostrado
5. Autoriza el acceso en la página web
6. El servidor confirmará: Authentication successful! Mode: OAUTH_DEVICE

Una vez autenticado, tu servidor podrá aceptar conexiones de jugadores.

Información Adicional sobre Autenticación

¿Por qué necesita autenticación?

Los servidores de Hytale requieren autenticación para:

• Habilitar la comunicación con las APIs de servicio de Hytale
• Prevenir abusos y mantener la seguridad

⚠️ Límite importante: Hay un límite de 100 servidores por licencia de juego de Hytale para prevenir abusos tempranos. Si necesitas más capacidad, puedes comprar licencias adicionales o solicitar una cuenta de Proveedor de Servidores.

Si necesitas autenticar muchos servidores o hacerlo automáticamente, consulta la Guía de Autenticación para Proveedores de Servidores.

Ver Todos los Argumentos Disponibles

Para ver todas las opciones de configuración disponibles, ejecuta:

java -jar HytaleServer.jar --help

Esto mostrará una lista completa de argumentos que puedes usar, como:

• --backup: Habilita copias de seguridad automáticas
• --backup-dir: Especifica dónde guardar las copias de seguridad
• --backup-frequency: Intervalo de copias de seguridad en minutos
• Y muchos más…

Configuración del Puerto

Por defecto, el servidor usa el puerto 5520. Si quieres cambiarlo, usa el argumento --bind:

java -jar HytaleServer.jar --assets PathToAssets.zip --bind 0.0.0.0:25565

Explicación:

• 0.0.0.0: Escucha en todas las interfaces de red (permite conexiones desde cualquier IP)
• 25565: El puerto que quieres usar (puede ser cualquier puerto disponible)

Configuración de Firewall y Red

Importante: Hytale usa el protocolo QUIC sobre UDP (no TCP). Esto es diferente a muchos otros juegos que usan TCP.

Redirección de Puertos (Port Forwarding)

Si tu servidor está detrás de un router, necesitas redirigir el puerto UDP 5520 (o el puerto personalizado que uses) a tu máquina servidor.

Pasos generales:

1. Accede a la configuración de tu router (normalmente 192.168.1.1 o 192.168.0.1)
2. Busca la sección de “Port Forwarding” o “Redirección de Puertos”
3. Crea una regla para:
   • Protocolo: UDP
   • Puerto externo: 5520 (o el que uses)
   • Puerto interno: 5520
   • IP destino: La IP local de tu servidor

⚠️ No necesitas redirigir TCP - solo UDP es necesario.

Reglas de Firewall

Windows (Firewall de Windows):

Abre PowerShell como administrador y ejecuta:

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Linux (iptables):

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Linux (ufw):

sudo ufw allow 5520/udp

Consideraciones sobre NAT

QUIC maneja bien el “NAT traversal” (atravesar routers) en la mayoría de los casos. Si los jugadores tienen problemas para conectarse:

• Asegúrate de que la redirección de puertos sea específicamente para UDP, no TCP
• Las configuraciones de NAT simétrico pueden causar problemas - considera usar un VPS o servidor dedicado
• Los jugadores detrás de NAT de nivel de operador (común en redes móviles) deberían poder conectarse sin problemas como clientes

Estructura de Archivos del Servidor

Una vez que el servidor se ejecuta por primera vez, creará esta estructura de carpetas:

Ruta	Descripción
.cache/	Caché para archivos optimizados
logs/	Archivos de registro del servidor
mods/	Mods instalados
universe/	Datos del mundo y jugadores guardados
bans.json	Lista de jugadores baneados
config.json	Configuración del servidor
permissions.json	Configuración de permisos
whitelist.json	Lista de jugadores permitidos

Estructura del Universo

La carpeta universe/worlds/ contiene todos los mundos jugables. Cada mundo tiene su propio archivo config.json con configuraciones como:

• Seed: La semilla del mundo (para generación procedural)
• IsPvpEnabled: Si el PvP está habilitado
• IsFallDamageEnabled: Si el daño por caída está activo
• View Distance: Distancia de renderizado
• Y muchas más opciones…

Cada mundo se ejecuta en su propio hilo principal y delega trabajo paralelo a un grupo de hilos compartido.

---

Consejos y Trucos

Instalación de Mods

Los mods pueden agregar funcionalidades increíbles a tu servidor. Para instalarlos:

1. Descarga mods (archivos .zip o .jar) de fuentes como CurseForge
2. Colócalos en la carpeta mods/ de tu servidor
3. Reinicia el servidor para que los mods se carguen

💡 Consejo: Algunos mods pueden requerir versiones específicas del servidor. Siempre verifica la compatibilidad antes de instalar.

Desactivar Sentry (Reporte de Errores)

⚠️ Importante: Desactiva Sentry durante el desarrollo activo de plugins.

Hytale usa Sentry para rastrear crashes y errores. Si estás desarrollando plugins y no quieres que tus errores de desarrollo se envíen, desactívalo con:

java -jar HytaleServer.jar --assets PathToAssets.zip --disable-sentry

Aprovechar el Caché Ahead-Of-Time (AOT)

El servidor incluye un caché AOT pre-entrenado (HytaleServer.aot) que mejora los tiempos de arranque al saltarse el “calentamiento” del compilador JIT.

Para usarlo:

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets PathToAssets.zip

Esto puede reducir significativamente el tiempo que tarda el servidor en iniciar. Para más información técnica, consulta JEP-514.

Plugins Recomendados

Nuestros socios de desarrollo en Nitrado y Apex Hosting mantienen plugins útiles para necesidades comunes de alojamiento:

Plugin	Descripción
Nitrado:WebServer	Plugin base para aplicaciones web y APIs
Nitrado:Query	Expone el estado del servidor (número de jugadores, etc.) vía HTTP
Nitrado:PerformanceSaver	Limita dinámicamente la distancia de renderizado según el uso de recursos
ApexHosting:PrometheusExporter	Expone métricas detalladas del servidor y JVM

Distancia de Renderizado (View Distance)

La distancia de renderizado es el principal factor que afecta el uso de RAM. Recomendamos limitar la distancia máxima a 12 chunks (384 bloques) tanto para rendimiento como para gameplay.

Comparación con Minecraft:

• Los servidores de Minecraft por defecto usan 10 chunks (160 bloques)
• El valor por defecto de Hytale de 384 bloques es aproximadamente equivalente a 24 chunks de Minecraft
• Con la configuración por defecto, espera un mayor uso de RAM - ajusta este valor según tu número esperado de jugadores

¿Cómo ajustarlo?

Puedes configurarlo en el archivo config.json de cada mundo o usar comandos del servidor.

---

Arquitectura Multiserver

Una de las características más poderosas de Hytale es su soporte nativo para conectar múltiples servidores. No necesitas un proxy inverso como BungeeCord - Hytale lo hace nativamente.

Referencia de Jugadores (Player Referral)

Transfiere un jugador conectado a otro servidor. El servidor envía un “paquete de referencia” que contiene el host de destino, el puerto y un payload opcional de 4KB.

Uso básico:

PlayerRef.referToServer(@Nonnull final String host, final int port, @Nullable byte[] data)

⚠️ Advertencia de Seguridad: El payload se transmite a través del cliente y puede ser manipulado. Firma los payloads criptográficamente (por ejemplo, con HMAC y una clave secreta compartida) para que el servidor receptor pueda verificar la autenticidad.

Casos de uso:

• Transferir jugadores entre servidores de juego
• Pasar contexto de sesión
• Controlar el acceso detrás de un sistema de matchmaking

🔜 Próximamente: Array de objetivos intentados en secuencia para conexiones de respaldo.

Redirección de Conexión

Durante el handshake de conexión, un servidor puede rechazar al jugador y redirigirlo a un servidor diferente. El cliente se conecta automáticamente a la dirección redirigida.

Casos de uso:

• Balanceo de carga
• Enrutamiento regional de servidores
• Forzar conexiones primero a un lobby

Desconexión con Respaldo (Disconnect Fallback)

Cuando un jugador se desconecta inesperadamente (crash del servidor, interrupción de red), el cliente se reconecta automáticamente a un servidor de respaldo preconfigurado en lugar de volver al menú principal.

Casos de uso:

• Devolver jugadores a un lobby después de un crash del servidor de juego
• Mantener el engagement durante reinicios

🔜 Próximamente: La implementación del paquete de respaldo se espera dentro de semanas después del lanzamiento de Early Access.

Construir un Proxy Personalizado

Puedes construir servidores proxy personalizados usando Netty QUIC. Hytale usa QUIC exclusivamente para la comunicación cliente-servidor.

Las definiciones de paquetes y la estructura del protocolo están disponibles en HytaleServer.jar:

com.hypixel.hytale.protocol.packets

Úsalas para decodificar, inspeccionar, modificar o reenviar tráfico entre clientes y servidores backend.

---

Detalles Adicionales

Argumentos de Línea de Comandos de Java

Para optimizar el rendimiento, puedes ajustar parámetros del JVM (Java Virtual Machine). Consulta la Guía de los Parámetros JVM Más Importantes para temas como:

• -Xms: Memoria inicial del heap
• -Xmx: Memoria máxima del heap
• -XX:+UseG1GC: Usar el recolector de basura G1
• Y muchos más…

Ejemplo de uso:

java -Xms4G -Xmx8G -jar HytaleServer.jar --assets PathToAssets.zip

Esto asigna 4 GB de RAM inicial y permite hasta 8 GB.

Actualizaciones del Protocolo

El protocolo de Hytale usa un hash para verificar la compatibilidad cliente-servidor. Si los hashes no coinciden exactamente, la conexión se rechaza.

⚠️ Limitación Actual: El cliente y el servidor deben estar en la misma versión exacta del protocolo. Cuando lanzamos una actualización, los servidores deben actualizarse inmediatamente o los jugadores en la nueva versión no podrán conectarse.

🔜 Próximamente: Tolerancia de protocolo que permitirá una diferencia de ±2 versiones entre cliente y servidor. Los operadores de servidores tendrán una ventana para actualizar sin perder conectividad de jugadores.

Archivos de Configuración

Los archivos de configuración (config.json, permissions.json, etc.) se leen al iniciar el servidor y se escriben cuando ocurren acciones en el juego (por ejemplo, asignar permisos mediante comandos).

⚠️ Importante: Los cambios manuales mientras el servidor está en ejecución probablemente serán sobrescritos. Si necesitas hacer cambios, hazlos cuando el servidor esté detenido o usa los comandos del servidor.

Artefacto en Maven Central

El JAR de HytaleServer se publicará en Maven Central para usarse como dependencia en proyectos de modding.

<dependency>
    <groupId>com.hypixel.hytale</groupId>
    <artifactId>Server</artifactId>
</dependency>

Los detalles exactos, incluyendo el versionado, están pendientes para el lanzamiento. Consulta los recursos de la comunidad de modding para la información más reciente sobre el uso de estas dependencias.

---

Funcionalidades Futuras

Hytale tiene planes emocionantes para el futuro de los servidores. Aquí te contamos qué viene:

Descubrimiento de Servidores y Minijuegos

Un catálogo de descubrimiento accesible desde el menú principal donde los jugadores pueden navegar y encontrar servidores y minijuegos. Los operadores de servidores pueden optar por aparecer en el catálogo para promocionar su contenido directamente a los jugadores.

Requisitos para aparecer en la lista:

Requisito	Descripción
Directrices para Operadores	Los servidores deben adherirse a las directrices de operadores y estándares de la comunidad
Auto-Calificación	Los operadores deben calificar con precisión el contenido de su servidor. Las calificaciones alimentan el filtrado de contenido y controles parentales
Aplicación	Los servidores que violen su auto-calificación están sujetos a acciones de aplicación según las políticas de operadores de servidores

Verificación de Conteo de Jugadores:

Los conteos de jugadores mostrados en el descubrimiento de servidores se recopilan de la telemetría del cliente en lugar de datos reportados por el servidor. Esto previene el “spoofing” de conteos y asegura que los jugadores puedan confiar en los números que ven al navegar servidores.

Sistema de Grupos (Parties)

Un sistema de grupos que permite a los jugadores agruparse y permanecer juntos a través de transferencias de servidor y colas de minijuegos.

Integración con descubrimiento de servidores:

Los jugadores pueden navegar servidores con su grupo y unirse juntos. Los requisitos de tamaño del grupo y restricciones son visibles antes de unirse, para que los grupos sepan de antemano si pueden jugar juntos.

Este sistema proporciona la base para una experiencia social fluida donde los amigos pueden moverse a través del ecosistema de Hytale como un grupo sin coordinación manual.

Sistema de Pagos Integrado

Una pasarela de pagos integrada en el cliente que los servidores pueden usar para aceptar pagos de jugadores. Es opcional pero recomendado.

Beneficios para operadores de servidores:

• Aceptar pagos sin manejar detalles de pago o construir infraestructura
• Transacciones procesadas a través de un sistema confiable y seguro

Beneficios para jugadores:

• No necesitan visitar sitios web externos
• Todas las transacciones son seguras y rastreables
• La información de pago permanece dentro del ecosistema de Hytale

Soporte para Registros SRV

Los registros SRV permiten a los jugadores conectarse usando un nombre de dominio (por ejemplo, play.ejemplo.com) sin especificar un puerto, con DNS manejando la búsqueda para resolver la dirección y puerto real del servidor.

Estado Actual: No soportado. En evaluación.

¿Por qué no está disponible aún?

No hay una biblioteca C# probada en batalla para la resolución de registros SRV. Las opciones existentes requieren incorporar una implementación completa de cliente DNS, lo que introduce complejidad innecesaria y riesgos potenciales de estabilidad, o carecen de la preparación para producción que requerimos para una característica de red central.

Estamos evaluando alternativas y revisaremos esto cuando exista una solución adecuada.

Endpoints de API Oficiales

Los servidores autenticados tendrán acceso a endpoints de API oficiales para datos de jugadores, versionado y operaciones de servidor. Estos endpoints reducen la necesidad de servicios de terceros y proporcionan datos autoritativos directamente de Hytale.

Endpoints Planificados:

Endpoint	Descripción
UUID ↔ Búsqueda de Nombre	Resolver nombres de jugadores a UUIDs y viceversa. Soporta búsquedas individuales y masivas
Versión del Juego	Consultar versión actual del juego, versión del protocolo y verificar actualizaciones
Perfil de Jugador	Obtener datos del perfil del jugador incluyendo cosméticos, renders de avatar e información de perfil público
Telemetría del Servidor	Reportar estado del servidor, conteo de jugadores y metadatos para integración de descubrimiento
Reporte	Reportar jugadores por violaciones de Términos de Servicio
Pagos	Procesar pagos usando nuestra pasarela de pagos integrada

Bajo Consideración:

Endpoint	Descripción
Sanciones Globales	Consultar si un jugador tiene sanciones a nivel de plataforma (no baneos específicos del servidor)
Lista de Amigos	Recuperar la lista de amigos de un jugador (con permisos apropiados) para características sociales
Suscripciones Webhook	Suscribirse a notificaciones push para eventos como cambios de nombre de jugador o actualizaciones de sanciones

Objetivos de Diseño:

• Límites de tasa generosos: Endpoints masivos y respuestas amigables para caché para soportar redes grandes
• Acceso autenticado: Todos los endpoints requieren autenticación del servidor para prevenir abusos
• API versionada: Contratos estables con ventanas de deprecación para cambios que rompen compatibilidad

---

Conclusión

Configurar y administrar un servidor de Hytale puede parecer abrumador al principio, pero con esta guía tienes toda la información necesaria para comenzar. Desde la instalación básica hasta configuraciones avanzadas de multiserver, ahora tienes las herramientas para crear tu propia experiencia de servidor.

Próximos Pasos

1. Instala Java 25 y verifica que funciona correctamente
2. Descarga los archivos del servidor usando el método que prefieras
3. Ejecuta el servidor por primera vez y completa la autenticación
4. Experimenta con la configuración y ajusta según tus necesidades
5. Explora los mods y plugins disponibles para personalizar tu servidor

Recursos Adicionales

• Documentación Oficial de Hytale
• CurseForge - Mods de Hytale
• Comunidad de Hytale

¿Tienes preguntas o necesitas ayuda? ¡Déjanos un comentario o visita nuestro canal de contacto!

¡Feliz administración de servidores! 🎮✨