Servidor de Hytale en un VPS Linux: requisitos e instalación
Esta guía instala un servidor de Hytale en un VPS Linux con Debian o Ubuntu, empezando por sus requisitos. Pasa por Java 25, la herramienta de descarga oficial y un servicio systemd. Después te enseña a vincular el servidor con tu cuenta de Hytale, actualizarlo y hacer copias de seguridad.
Comprobar los requisitos
Según Hypixel Studios, un servidor necesita al menos 4 GB de RAM, Java 25 y un único puerto, el 5520 en UDP. Hytale usa el protocolo QUIC, así que solo UDP. Cuenta con 8 GB de RAM para ir holgado, y más si esperas muchos jugadores. En Hytale, la velocidad de cada núcleo importa más que su número.
El servidor tiene dos partes. El archivo HytaleServer.jar ejecuta el juego. El archivo Assets.zip, de varios gigabytes, contiene sus recursos. Empieza por actualizar el sistema.
sudo apt update && sudo apt upgrade -y
Instalar Java 25
Debian 13 y Ubuntu 24.04 traen Java 25 en sus repositorios. Para un servidor basta con una versión sin interfaz gráfica.
sudo apt install -y openjdk-25-jre-headless unzip
java --version
La primera línea debe empezar por openjdk 25.
Con Temurin, en Debian 12 o Ubuntu 22.04
Estas versiones más antiguas no tienen Java 25 en sus repositorios. Instala Temurin desde el repositorio de Adoptium.
# Dependencias
sudo apt install -y wget apt-transport-https gnupg lsb-release unzip
# Clave GPG de Adoptium
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc
# Repositorio de Adoptium
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
# Instalar Java 25
sudo apt update
sudo apt install -y temurin-25-jdk
java --version
Crear el usuario hytale y sus carpetas
No ejecutes nunca un servidor de juegos como root. Crea una cuenta de sistema solo para el servidor y después sus carpetas.
sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale
# Carpetas del servidor y de las copias
sudo mkdir -p /opt/hytale/server
sudo mkdir -p /opt/hytale/backups
sudo chown -R hytale:hytale /opt/hytale
Descargar los archivos del servidor
La herramienta oficial hytale-downloader descarga la última versión de los archivos del servidor. Ejecútala con la cuenta hytale.
# Pasar a la cuenta hytale
sudo su - hytale
cd /opt/hytale/server
# Descargar y extraer la herramienta
wget -q https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x hytale-downloader-linux-amd64
# Descargar los archivos del servidor en game.zip
./hytale-downloader-linux-amd64 -download-path game.zip
La primera vez, la herramienta muestra una dirección y un código. Abre la dirección en tu navegador y confirma con tu cuenta de Hytale. Después la herramienta descarga el archivo del juego. Extráelo y comprueba su contenido.
unzip -o game.zip
ls -lh /opt/hytale/server/
La carpeta debe contener una subcarpeta Server/, con HytaleServer.jar, y el archivo Assets.zip. El comando ./hytale-downloader-linux-amd64 -h lista las opciones de la herramienta, como -print-version para ver la versión disponible. Escribe exit para volver a tu cuenta.
Abrir el puerto 5520 en UDP
El área de cliente no tiene cortafuegos de red para los VPS. El puerto se abre en el sistema, con UFW. Permite SSH antes de activar UFW y después el puerto de Hytale, solo en UDP.
# Primero SSH
sudo ufw allow 22/tcp
# Puerto de Hytale, solo UDP
sudo ufw allow 5520/udp
# Activar y comprobar
sudo ufw enable
sudo ufw reload
sudo ufw status verbose
La lista debe incluir la línea 5520/udp ALLOW IN Anywhere. No abras este puerto en TCP, Hytale no lo usa. La guía Cómo configurar el firewall UFW en Ubuntu y Debian explica estas reglas.
Configurar el arranque del servidor
El script de arranque
sudo -u hytale nano /opt/hytale/server/start.sh
Pega este contenido. Las opciones -Xms y -Xmx fijan la memoria que recibe Java.
#!/bin/bash
#
# Script de arranque del servidor Hytale
#
cd /opt/hytale/server
# Ajustes de la JVM
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"
# Arrancar el servidor
java $JAVA_OPTS -jar Server/HytaleServer.jar --assets Assets.zip
El servidor escucha por defecto en el puerto 5520. El comando java -jar Server/HytaleServer.jar --help lista sus opciones. Haz el script ejecutable.
sudo chmod +x /opt/hytale/server/start.sh
sudo chown hytale:hytale /opt/hytale/server/start.sh
Ajusta la memoria al tamaño del VPS y al número de jugadores. Deja siempre 1 a 2 GB al sistema. Estos valores son puntos de partida.
| Jugadores | RAM del VPS | Opciones de la JVM |
|---|---|---|
| 5 a 10 | 6 GB | -Xms3G -Xmx5G -XX:+UseG1GC |
| 10 a 20 | 8 GB | -Xms4G -Xmx6G -XX:+UseG1GC -XX:MaxGCPauseMillis=200 |
| 20 a 40 | 16 GB | -Xms8G -Xmx12G -XX:+UseG1GC -XX:MaxGCPauseMillis=200 |
| 50 o más | 32 GB | -Xms16G -Xmx24G -XX:+UseZGC |
El archivo config.json
El servidor crea /opt/hytale/server/config.json en el primer arranque. Detenlo antes de modificar este archivo. Aquí tienes un ejemplo.
{
"Version": 3,
"ServerName": "My Hytale Server",
"MOTD": "Welcome to our server!",
"Password": "",
"MaxPlayers": 20,
"MaxViewRadius": 16,
"LocalCompressionEnabled": false,
"Defaults": {
"World": "default",
"GameMode": "Adventure"
},
"ConnectionTimeouts": {
"JoinTimeouts": {}
},
"RateLimit": {},
"Modules": {},
"LogLevels": {},
"Mods": {},
"DisplayTmpTagsInStrings": false,
"PlayerStorage": {
"Type": "Hytale"
}
}
| Parámetro | Función |
|---|---|
ServerName | Nombre que aparece en la lista de servidores |
MaxPlayers | Número máximo de jugadores conectados a la vez |
MaxViewRadius | Distancia de visión. 32 es alto y costoso, 16 aligera bastante la RAM y el procesador. |
Password | Vacío, el servidor está abierto. Si no, los jugadores deben escribir esta contraseña. |
GameMode | Modo de juego por defecto, por ejemplo Adventure o Creative |
El servicio systemd
Un servicio systemd arranca el servidor con el VPS y lo reinicia si se cae.
sudo nano /etc/systemd/system/hytale.service
[Unit]
Description=Hytale Server
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
sudo systemctl daemon-reload
sudo systemctl enable hytale
No arranques todavía el servicio. Primero hay que autenticar el servidor.
Autenticar el servidor y recibir a los jugadores
Los jugadores solo pueden entrar en el servidor cuando está vinculado a tu cuenta de Hytale. Arráncalo a mano la primera vez, para tener su consola delante.
sudo systemctl stop hytale
sudo -u hytale /opt/hytale/server/start.sh
Cuando la consola esté lista, escribe este comando.
/auth login device
La consola muestra una dirección y un código. Abre la dirección en tu navegador, escribe el código y confirma con tu cuenta de Hytale. Hazlo enseguida, porque el código solo vale un tiempo. Guarda después la autenticación en el disco para que sobreviva a los reinicios.
/auth persistence Encrypted
/auth status
Detén el servidor con Ctrl+C, arranca el servicio y sigue su registro.
sudo systemctl start hytale
sudo journalctl -u hytale -f
Los jugadores se conectan con la IP del VPS y el puerto, por ejemplo 203.0.113.10:5520, o con un nombre de dominio que apunte a esa IP, como play.example.com:5520. La guía Cómo unirse a un servidor de Hytale muestra el lado del jugador.
Actualizar, hacer copias y vigilar
Gestionar el servicio
sudo systemctl start hytale
sudo systemctl stop hytale
sudo systemctl restart hytale
sudo systemctl status hytale
# Registro en directo y completo
sudo journalctl -u hytale -f
sudo journalctl -u hytale --no-pager
Actualizar el servidor
Detén siempre el servidor antes de actualizarlo, si no el mundo puede dañarse. Haz también una copia de seguridad.
# Detener el servidor y copiarlo
sudo systemctl stop hytale
sudo -u hytale cp -r /opt/hytale/server /opt/hytale/backups/server-$(date +%Y%m%d)
# Descargar y extraer la última versión
sudo su - hytale
cd /opt/hytale/server
./hytale-downloader-linux-amd64 -download-path game.zip
unzip -o game.zip
exit
# Volver a arrancar
sudo systemctl start hytale
Hacer copias automáticas
Crea el script /opt/hytale/backup.sh. Archiva la configuración, el mundo (carpeta universe/) y los mods, y borra los archivos de más de siete días.
#!/bin/bash
#
# Copia de seguridad del servidor Hytale
#
BACKUP_DIR="/opt/hytale/backups"
SERVER_DIR="/opt/hytale/server"
DATE=$(date +%Y%m%d-%H%M%S)
RETENTION_DAYS=7
# Crear el archivo
tar -czf "$BACKUP_DIR/hytale-$DATE.tar.gz" \
--exclude='*.log' \
-C "$SERVER_DIR" \
config.json \
universe/ \
mods/
# Borrar los archivos antiguos
find "$BACKUP_DIR" -name "hytale-*.tar.gz" -mtime +$RETENTION_DAYS -delete
echo "Backup complete: hytale-$DATE.tar.gz"
Hazlo ejecutable y prográmalo cada noche a las 4.
sudo chmod +x /opt/hytale/backup.sh
sudo chown hytale:hytale /opt/hytale/backup.sh
echo "0 4 * * * hytale /opt/hytale/backup.sh" | sudo tee /etc/cron.d/hytale-backup
Estas copias se quedan en el disco del VPS. Guárdalas también en otro sitio. Para copiar el VPS entero, el área de cliente ofrece una opción de pago, descrita en la guía Cómo activar las copias de seguridad automáticas de tu VPS.
Restaurar una copia
# Detener el servidor
sudo systemctl stop hytale
# Restaurar el archivo elegido
cd /opt/hytale/server
sudo -u hytale tar -xzf /opt/hytale/backups/hytale-YYYYMMDD-HHMMSS.tar.gz
# Volver a arrancar
sudo systemctl start hytale
Vigilar los recursos
# Memoria del proceso Java
ps aux | grep HytaleServer
# Procesador y memoria en directo
htop -p $(pgrep -f HytaleServer)
# Espacio en disco
df -h /opt/hytale
Resolver los problemas frecuentes
El servidor no arranca por la versión de Java. Comprueba con
java --versionque es Java 25.No se encuentra
Assets.zip. El archivo debe estar en/opt/hytale/server/, la carpeta de trabajo del servicio.El puerto 5520 ya está en uso, o aparece
Unable to bind to address. Hay otra instancia en marcha. Búscala conssy detenla.OutOfMemoryErroroGC overhead limit exceeded. Falta memoria. Sube-Xmx, por ejemplo de6Ga8G, o bajaMaxViewRadius.Los jugadores no pueden conectarse, o aparece
Authentication required. Revisa la regla de UFW del puerto 5520 en UDP y vuelve a lanzar/auth login deviceen la consola.
# ¿Escucha el servidor?
sudo ss -ulnp | grep 5520
# Liberar el puerto ocupado por otro proceso
sudo fuser -k 5520/udp
# Errores de la última hora
sudo journalctl -u hytale --since "1 hour ago" | grep -i error
# Probar el puerto UDP desde otra máquina (resultado solo orientativo)
nc -vzu 203.0.113.10 5520
# Versión de Java y permisos de los archivos
java --version
ls -la /opt/hytale/server/
El manual oficial del servidor de Hytale describe todas las opciones. La web de Hytale anuncia las nuevas versiones.
¿Necesitas ayuda?
Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha del VPS. En el campo Servicio afectado, elige el VPS para que el equipo gane tiempo. También puedes preguntar en el Discord de OuiHeberg.
Acceso root, la distribución que elijas y gestión desde el área de cliente de OuiHeberg.
Ver ofertas →