Variables de Entorno

Referencia completa de todas las variables de entorno.

Variables del Servidor

Variable	Por defecto	Descripción
JAVA_XMS	4G	Tamaño mínimo del heap de Java
JAVA_XMX	8G	Tamaño máximo del heap de Java
BIND_PORT	5520	Puerto UDP del servidor
AUTO_DOWNLOAD	true	Descarga automática al iniciar
SERVER_EXTRA_ARGS	-	Argumentos adicionales
TZ	UTC	Zona horaria del contenedor

Variables del Panel

Variable	Por defecto	Descripción
PANEL_USER	admin	Usuario de login
PANEL_PASS	admin	Contraseña de login
PANEL_PORT	3000	Puerto HTTP del servidor
JWT_SECRET	(aleatorio)	Clave secreta para firmar JWT
MODTALE_API_KEY	-	API key para integración Modtale

Variables de Docker

Variable	Por defecto	Descripción
CONTAINER_NAME	hytale-server	Nombre del contenedor del servidor

Descripciones Detalladas

JAVA_XMS / JAVA_XMX

Controla la asignación de memoria de la JVM.

# Mínimo 4GB, máximo 8GB
JAVA_XMS=4G
JAVA_XMX=8G

Guía de RAM

Jugadores	Recomendado
1-10	4G
10-20	6G
20-50	8G
50+	12G+

AUTO_DOWNLOAD

Cuando es true, el servidor descargará automáticamente HytaleServer.jar y Assets.zip al iniciar por primera vez.

# Deshabilitar para ARM64 o configuración manual
AUTO_DOWNLOAD=false

ARM64

La descarga automática no está disponible en ARM64. Configura false y proporciona los archivos manualmente.

SERVER_EXTRA_ARGS

Pasa argumentos adicionales al ejecutable del servidor.

# Habilitar mods
SERVER_EXTRA_ARGS=--mods mods

# Múltiples argumentos
SERVER_EXTRA_ARGS=--mods mods --debug

TZ (Zona Horaria)

Configura la zona horaria del contenedor para timestamps de logs.

TZ=America/Santiago
TZ=Europe/Madrid
TZ=America/Mexico_City

Lista completa de zonas horarias

JWT_SECRET

Clave secreta usada para firmar tokens JWT. Si no se proporciona, se genera una clave aleatoria al iniciar.

# Opcional pero recomendado para sesiones persistentes
JWT_SECRET=tu-cadena-aleatoria-muy-larga-aqui

INFO

Si no está configurado, se genera un nuevo secreto cada vez que el panel reinicia, invalidando todas las sesiones existentes.

MODTALE_API_KEY

API key para la integración con el repositorio de mods Modtale.

MODTALE_API_KEY=tu-modtale-api-key

Cuando está configurado, habilita:

• Exploración de mods en el panel
• Instalación de mods con un click
• Verificación de actualizaciones

Ejemplo de Archivo .env

# ===================
# Configuración del Servidor
# ===================
JAVA_XMS=4G
JAVA_XMX=8G
BIND_PORT=5520
AUTO_DOWNLOAD=true
SERVER_EXTRA_ARGS=--mods mods
TZ=America/Santiago

# ===================
# Configuración del Panel
# ===================
PANEL_USER=miadmin
PANEL_PASS=contraseñasupersegura123
PANEL_PORT=3000
JWT_SECRET=cambia-esto-a-una-cadena-aleatoria

# ===================
# Integraciones Opcionales
# ===================
MODTALE_API_KEY=tu-api-key