Cómo instalar un servidor Hytale en VPS Linux

1. Introducción

¿Qué es Hytale?

Hytale es un juego de tipo sandbox desarrollado por Hypixel Studios, lanzado en acceso anticipado el 13 de enero de 2026. Combina exploración, construcción, combate y creación de contenido en un rico universo procedural. El servidor dedicado permite alojar partidas multijugador persistentes.

Funcionalidades principales

• Mundos procedurales con biomas variados
• Sistema de mods y personalización avanzada
• Protocolo de red moderno QUIC sobre UDP
• Soporte para arquitecturas x64 y arm64
• Gestión de permisos y múltiples mundos
• Sistema de autenticación integrado a través de la cuenta de Hytale

Casos de uso típicos

• Servidor privado entre amigos (5-10 jugadores)
• Servidor comunitario público (20-50 jugadores)
• Servidor de minijuegos personalizados
• Servidor creativo con mods

Versión documentada

• Servidor Hytale : v1.0.0 (enero de 2026)
• Java requerido : OpenJDK 25 LTS (Temurin)

---

🚀 ¿Prefieres una solución llave en mano?

Con OuiHeberg, tu servidor Hytale está preinstalado y listo para jugar en menos de 60 segundos. Sin configuración técnica, actualizaciones automáticas, soporte 24/7 y protección anti-DDoS incluida.

➡️ Descubre nuestras ofertas de Alojamiento Hytale

---

2. Prerrequisitos

Configuración de hardware

Recurso	Mínimo	Recomendado	Rendimiento
RAM	4 GB	8 GB	16 GB
CPU	2 vCores	4 vCores	6+ vCores
Almacenamiento	10 GB SSD	20 GB SSD	50 GB NVMe
Ancho de banda	100 Mbps	1 Gbps	1 Gbps
Jugadores admitidos	5-10	10-30	50+

💡 Consejo : La velocidad de la CPU (frecuencia por núcleo) es más importante que el número de núcleos para Hytale.

Software requerido

Software	Versión	Obligatorio
Debian / Ubuntu	12+ / 22.04+	✅
Java (OpenJDK)	25 LTS	✅
unzip	Última	✅
UFW (firewall)	Última	Recomendado

Puertos de red

Puerto	Protocolo	Uso	Obligatorio
5520	UDP	Servidor Hytale (QUIC)	✅
22	TCP	SSH (administración)	✅

⚠️ Importante : Hytale utiliza exclusivamente UDP a través del protocolo QUIC. No abrir el puerto en TCP.

Archivos de servidor requeridos

Archivo	Tamaño	Descripción
HytaleServer.jar	~50 MB	Ejecutable del servidor
Assets.zip	~3.2 GB	Recursos del juego (texturas, sonidos, modelos)

---

3. Instalación paso a paso

Etapa 1: Actualización del sistema

sudo apt update && sudo apt upgrade -y

ℹ️ Esta orden actualiza la lista de paquetes e instala las últimas versiones disponibles.

Etapa 2: Instalación de Java 25

Agrega el repositorio Adoptium e instala OpenJDK 25 :

# Instalación de dependencias
sudo apt install -y wget apt-transport-https gnupg

# Agregar la clave GPG de Adoptium
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc

# Agregar el repositorio
echo "deb [signed-by=/usr/share/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# Instalación de Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

Punto de verificación :

java --version

Resultado esperado :

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)

Etapa 3: Creación de un usuario dedicado

Por razones de seguridad, crea un usuario del sistema sin privilegios de root :

sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

💡 Práctica recomendada : Nunca ejecutar un servidor de juego como root.

Etapa 4: Preparación de la estructura de directorios

# Creación de carpetas
sudo mkdir -p /opt/hytale/server
sudo mkdir -p /opt/hytale/backups

# Asignación de permisos
sudo chown -R hytale:hytale /opt/hytale

Etapa 5: Descarga de los archivos del servidor

Utiliza la herramienta oficial hytale-downloader para descargar los archivos del servidor directamente en tu VPS :

# Conexión como usuario hytale
sudo su - hytale
cd /opt/hytale/server

# Descarga de la herramienta
wget -q https://downloader.hytale.com/hytale-downloader.zip

# Extracción
unzip hytale-downloader.zip

# Asignación de permisos de ejecución
chmod +x bin/hytale-downloader

# Descarga de los archivos del servidor (HytaleServer.jar + Assets.zip)
./bin/hytale-downloader --server

ℹ️ La herramienta te pedirá autenticarte con tu cuenta de Hytale durante la primera descarga.

Punto de verificación :

ls -lh /opt/hytale/server/

Resultado esperado :

-rw-r--r-- 1 hytale hytale  50M ene 15 10:00 HytaleServer.jar
-rw-r--r-- 1 hytale hytale 3.2G ene 15 10:05 Assets.zip
drwxr-xr-x 2 hytale hytale 4.0K ene 15 10:00 bin/

Etapa 6: Configuración del firewall

# Activación de UFW si es necesario
sudo ufw enable

# Apertura del puerto SSH (si aún no está abierto)
sudo ufw allow 22/tcp

# Apertura del puerto Hytale (solo UDP)
sudo ufw allow 5520/udp

# Recarga de las reglas
sudo ufw reload

# Verificación
sudo ufw status verbose

Resultado esperado :

5520/udp                   ALLOW IN    Anywhere

---

4. Configuración

Script de inicio

Crea el archivo /opt/hytale/server/start.sh :

sudo -u hytale nano /opt/hytale/server/start.sh

Contenido del script :

#!/bin/bash
#
# Hytale Server Startup Script
# OuiHeberg - Installation Guide
#

cd /opt/hytale/server

# JVM Configuration
JAVA_OPTS="-Xms4G -Xmx6G"
JAVA_OPTS="$JAVA_OPTS -XX:+UseG1GC"
JAVA_OPTS="$JAVA_OPTS -XX:MaxGCPauseMillis=200"
JAVA_OPTS="$JAVA_OPTS -XX:+ParallelRefProcEnabled"
JAVA_OPTS="$JAVA_OPTS -XX:+UnlockExperimentalVMOptions"
JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"

# Server Startup
java $JAVA_OPTS -jar HytaleServer.jar \
    --assets Assets.zip \
    --bind 0.0.0.0:5520

Hacer el script ejecutable:

sudo chmod +x /opt/hytale/server/start.sh
sudo chown hytale:hytale /opt/hytale/server/start.sh

Optimización de JVM según la cantidad de jugadores

Jugadores	RAM VPS	Parámetros JVM
5-10	6 GB	-Xms3G -Xmx5G -XX:+UseG1GC
10-20	8 GB	-Xms4G -Xmx6G -XX:+UseG1GC -XX:MaxGCPauseMillis=200
20-40	16 GB	-Xms8G -Xmx12G -XX:+UseG1GC -XX:MaxGCPauseMillis=200
50+	32 GB	-Xms16G -Xmx24G -XX:+UseZGC

⚠️ Importante: Siempre deje 1-2 GB de RAM disponible para el sistema operativo.

Configuración del servidor (config.json)

Después del primer inicio, edite /opt/hytale/server/config.json:

{
  "Version": 3,
  "ServerName": "Mi Servidor Hytale",
  "MOTD": "¡Bienvenido a nuestro servidor!",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 16,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "DisplayTmpTagsInStrings": false,
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Parámetros importantes:

Parámetro	Valor recomendado	Descripción
ServerName	Tu nombre	Nombre mostrado en la lista de servidores
MaxPlayers	20	Número máximo de jugadores simultáneos
MaxViewRadius	16	Distancia de renderizado (32 = alto, consume mucho)
Password	""	Vacío = servidor público, de lo contrario se requiere contraseña
GameMode	Adventure	Modo por defecto: Adventure, Creative, Survival

💡 Optimización: Reducir MaxViewRadius de 32 a 16 disminuye significativamente el consumo de RAM y CPU.

Servicio systemd (inicio automático)

Cree el archivo /etc/systemd/system/hytale.service:

sudo nano /etc/systemd/system/hytale.service

Contenido:

[Unit]
Description=Servidor Dedicado Hytale
Documentation=https://support.hytale.com
After=network.target

[Service]
Type=simple
User=hytale
Group=hytale
WorkingDirectory=/opt/hytale/server
ExecStart=/opt/hytale/server/start.sh
ExecStop=/bin/kill -SIGINT $MAINPID
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=hytale

# Seguridad
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Active y inicie el servicio:

sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

---

5. Primer uso

Primer inicio

sudo systemctl start hytale

Vea los registros en tiempo real:

sudo journalctl -u hytale -f

Salida esperada:

[INFO] Starting Hytale Server v1.0.0
[INFO] Loading Assets.zip... (1-2 minutes)
[INFO] World generation complete
[WARN] Server requires authentication
[INFO] Use command: /auth login device
[INFO] Server online on port 5520

Autenticación del servidor

Acceda a la consola del servidor:

sudo -u hytale screen -S hytale

O a través de systemd:

sudo systemctl stop hytale
sudo -u hytale /opt/hytale/server/start.sh

En la consola, escriba:

/auth login device

Aparecerá un código:

===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
===================================================================

1. Visite https://accounts.hytale.com/device
2. Ingrese el código mostrado (ej: ABCD-1234)
3. Valide con su cuenta de Hytale

⚠️ Importante: El código expira después de 15 minutos. La autenticación es obligatoria para que los jugadores puedan conectarse.

Conexión de los jugadores

Los jugadores pueden conectarse a través de:

• IP directa: su-ip-publica:5520
• Dominio: play.sudominio.fr:5520

---

6. Mantenimiento

Comandos de gestión del servicio

Acción	Comando
Iniciar	sudo systemctl start hytale
Detener	sudo systemctl stop hytale
Reiniciar	sudo systemctl restart hytale
Estado	sudo systemctl status hytale
Registros en tiempo real	sudo journalctl -u hytale -f
Registros completos	sudo journalctl -u hytale --no-pager

Actualización del servidor

# Detener el servidor
sudo systemctl stop hytale

# Respaldo antes de la actualización
sudo -u hytale cp -r /opt/hytale/server /opt/hytale/backups/server-$(date +%Y%m%d)

# Descargar los nuevos archivos
sudo su - hytale
cd /opt/hytale/server
./bin/hytale-downloader --server --update

# Reiniciar
exit
sudo systemctl start hytale

Respaldo automático

Cree un script de respaldo /opt/hytale/backup.sh:

#!/bin/bash
#
# Script de respaldo Hytale
#

BACKUP_DIR="/opt/hytale/backups"
SERVER_DIR="/opt/hytale/server"
DATE=$(date +%Y%m%d-%H%M%S)
RETENTION_DAYS=7

# Creación del respaldo
tar -czf "$BACKUP_DIR/hytale-$DATE.tar.gz" \
    -C "$SERVER_DIR" \
    config.json \
    universe/ \
    mods/ \
    --exclude='*.log'

# Eliminación de respaldos antiguos
find "$BACKUP_DIR" -name "hytale-*.tar.gz" -mtime +$RETENTION_DAYS -delete

echo "Respaldo completado: hytale-$DATE.tar.gz"

Hágalo ejecutable y prográmelo:

sudo chmod +x /opt/hytale/backup.sh
sudo chown hytale:hytale /opt/hytale/backup.sh

# Agregar al cron (respaldo diario a las 4h)
echo "0 4 * * * hytale /opt/hytale/backup.sh" | sudo tee /etc/cron.d/hytale-backup

Restauración

# Detener el servidor
sudo systemctl stop hytale

# Restaurar desde una copia de seguridad
cd /opt/hytale/server
sudo -u hytale tar -xzf /opt/hytale/backups/hytale-YYYYMMDD-HHMMSS.tar.gz

# Reiniciar
sudo systemctl start hytale

Monitoreo

Supervise los recursos del servidor:

# Uso de memoria del proceso Java
ps aux | grep HytaleServer

# Uso de CPU y RAM en tiempo real
htop -p $(pgrep -f HytaleServer)

# Espacio en disco
df -h /opt/hytale

---

7. Troubleshooting

Problemas comunes

Problema	Causa	Solución
Versión incorrecta de Java	Java < 25	Instalar Java 25 a través de Adoptium
Assets.zip no encontrado	Archivo faltante	Colocar Assets.zip en /opt/hytale/server/
Puerto 5520 ya en uso	Otra instancia activa	sudo lsof -i :5520 luego kill PID
OutOfMemoryError	RAM insuficiente	Aumentar -Xmx o reducir MaxViewRadius
Los jugadores no pueden conectarse	Cortafuegos / autenticación	Verificar UFW + /auth login device

Comandos de diagnóstico

# Verificar si el servidor está escuchando
sudo ss -ulnp | grep 5520

# Verificar los registros de error
sudo journalctl -u hytale --since "1 hora antes" | grep -i error

# Probar la conectividad UDP (desde otro servidor)
nc -vzu su-ip 5520

# Verificar la versión de Java
java --version

# Verificar los permisos
ls -la /opt/hytale/server/

Errores frecuentes en los registros

Error : GC overhead limit exceeded

# Aumentar la RAM asignada
-Xmx8G en lugar de -Xmx6G

Error : No se puede enlazar a la dirección

# Verificar que ningún otro proceso esté usando el puerto
sudo fuser -k 5520/udp

Error : Se requiere autenticación

# Volver a iniciar la autenticación
/auth login device

---

8. Recursos

Documentación oficial

Recurso	URL
Manual oficial del servidor	https://support.hytale.com/hc/en-us/articles/45326769420827-Hytale-Server-Manual
Sitio oficial de Hytale	https://hytale.com
Autenticación	https://accounts.hytale.com/device
Adoptium (Java 25)	https://adoptium.net

Comunidad

Plataforma	Enlace
Discord oficial	https://discord.gg/hytale
Reddit	https://reddit.com/r/hytale
Foros oficiales	https://forums.hytale.com

---

💡 ¿La instalación te parece compleja?

Ahorra tiempo con un servidor Hytale preinstalado en OuiHeberg:

• ✅ Servidor listo en 60 segundos
• ✅ Panel de control simplificado
• ✅ Actualizaciones con 1 clic
• ✅ Copias de seguridad automáticas
• ✅ Soporte técnico 24/7
• ✅ Protección anti-DDoS incluida

➡️ Ordena tu servidor Hytale

---

Resumen de comandos

# === INSTALACIÓN COMPLETA ===

# 1. Actualizar el sistema
sudo apt update && sudo apt upgrade -y

# 2. Instalación de Java 25
sudo apt install -y wget apt-transport-https gnupg unzip
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc
echo "deb [signed-by=/usr/share/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update && sudo apt install -y temurin-25-jdk

# 3. Crear usuario
sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

# 4. Preparar carpetas
sudo mkdir -p /opt/hytale/{server,backups}
sudo chown -R hytale:hytale /opt/hytale

# 5. Cortafuegos
sudo ufw allow 5520/udp
sudo ufw reload

# 6. Descargar archivos del servidor
sudo su - hytale
cd /opt/hytale/server
wget -q https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x bin/hytale-downloader
./bin/hytale-downloader --server
exit

# 7. Crear start.sh y hytale.service (ver secciones anteriores)

# 8. Iniciar
sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

# 9. Autenticación
# En la consola: /auth login device
# Luego validar en https://accounts.hytale.com/device

---

Guía elaborada por OuiHeberg — Última actualización: 15 de enero de 2026