Cómo Configurar un Servidor Hytale

Tu guía completa para crear, configurar y ejecutar un servidor dedicado de Hytale.

Lo Que Aprenderás

Requisitos del sistema e instalación de Java
Obtener y ejecutar archivos del servidor
Configuración de autenticación y firewall
Configuración y plugins recomendados

Requisitos del Sistema

Requisitos Mínimos

  • 4GB RAM mínimo
  • Java 25 (recomendamos Adoptium)
  • Arquitectura x64 o arm64 soportada

Controladores de Recursos

  • CPU: Alto número de jugadores/entidades
  • RAM: Gran área del mundo cargada, alta distancia de visión

Tip: Monitorea el uso de RAM y CPU mientras el servidor está ejecutándose. El uso de recursos depende mucho del comportamiento de los jugadores. Experimenta con el parámetro -Xmx de Java para establecer límites de memoria.

Paso 1: Instalar Java 25

Descargar Java 25

Descarga e instala Java 25 desde Adoptium (recomendado).

Verificar Instalación

Ejecuta este comando para confirmar que Java está instalado:

java --version

Salida esperada:

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)

Paso 2: Obtener Archivos del Servidor

Hay dos formas de obtener los archivos del servidor:

Opción A: Copiar del Launcher

Mejor para pruebas rápidas. Encuentra los archivos en tu carpeta de instalación del launcher:

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

Copia la carpeta Server y Assets.zip a tu directorio del servidor.

Recomendado

Opción B: Hytale Downloader CLI

Mejor para servidores de producción. Fácil de mantener actualizado. Descarga la herramienta CLI y ejecuta:

./hytale-downloader # Descargar última versión

./hytale-downloader -print-version # Mostrar versión

./hytale-downloader -check-update # Buscar actualizaciones

Paso 3: Ejecutar el Servidor

Comando de Inicio

Inicia el servidor con:

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

El flag -XX:AOTCache usa la caché AOT pre-entrenada para tiempos de arranque más rápidos.

Autenticar tu Servidor

Después del primer inicio, autentica tu servidor para habilitar las conexiones de jugadores:

> /auth login device
===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
===================================================================
Waiting for authorization...

[Complete authorization in browser]

> Authentication successful! Mode: OAUTH_DEVICE

Note: Hay un límite de 100 servidores por licencia de juego Hytale.

Cambiar Puerto

El puerto predeterminado es 5520. Cámbialo con el argumento --bind:

java -jar HytaleServer.jar --assets Assets.zip --bind 3500

Paso 4: Configurar Firewall

Important: Hytale usa el protocolo QUIC sobre UDP (no TCP). Configura tu firewall y reenvío de puertos solo para UDP.

Windows Firewall

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

Linux (ufw)

sudo ufw allow 5520/udp

Reenvío de Puertos

Si estás detrás de un router, reenvía UDP puerto 5520 (o tu puerto personalizado) a tu máquina servidor. No se requiere reenvío TCP.

Estructura de Archivos del Servidor

Diseño de Directorios

Directorios

  • .cache/ - Caché para archivos optimizados
  • logs/ - Archivos de registro del servidor
  • mods/ - Mods instalados
  • universe/ - Datos guardados del mundo y jugadores

Archivos de Configuración

  • config.json - Configuración del servidor
  • permissions.json - Configuración de permisos
  • bans.json - Jugadores baneados
  • whitelist.json - Jugadores en lista blanca

Plugins Recomendados

Instala mods descargando archivos .zip o .jar y colocándolos en la carpeta mods/.

Nitrado:WebServer

Plugin base para aplicaciones web y APIs.

Nitrado:Query

Expone el estado del servidor (conteo de jugadores, etc.) vía HTTP.

Nitrado:PerformanceSaver

Limita dinámicamente la distancia de visión basado en el uso de recursos.

ApexHosting:PrometheusExporter

Expone métricas detalladas del servidor y JVM.

Consejos y Trucos

Distancia de Visión

La distancia de visión es el principal controlador del uso de RAM. Recomendamos limitar la distancia de visión máxima a 12 chunks (384 bloques) tanto para rendimiento como para jugabilidad. El valor predeterminado de Hytale de 384 bloques equivale aproximadamente a 24 chunks de Minecraft.

Copias de Seguridad Automáticas

Habilita copias de seguridad automáticas con argumentos de línea de comandos:

java -jar HytaleServer.jar --assets Assets.zip --backup --backup-frequency 30

Desactivar Sentry (Desarrollo)

Al desarrollar plugins, desactiva el reporte de errores de Sentry para evitar enviar tus errores de desarrollo:

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

Referencia de Comandos

Ver todos los argumentos disponibles:

java -jar HytaleServer.jar --help

Argumentos Comunes

ArgumentoDescripción
--assets <Path>Directorio de assets (predeterminado: ../HytaleAssets)
-b, --bind <Address>Dirección para escuchar (predeterminado: 0.0.0.0:5520)
--auth-modeModo de autenticación: authenticated u offline
--backupHabilitar copias de seguridad automáticas
--backup-frequency <Int>Intervalo de backup en minutos (predeterminado: 30)
--allow-opPermitir comandos de operador

Próximos Pasos

Únete a la Comunidad

Una vez que tu servidor esté listo, únete a estos servidores en la clasificación.