Come creare il tuo server Hytale

Questa guida spiega come installare e configurare un server dedicato Hytale sul tuo VPS o server dedicato Linux.

Ordina un Server

Per ospitare il tuo server Hytale, HostMyServers offre diverse opzioni ottimizzate per il gaming:

• VPS Performance - Ideale per piccoli server
• VPS NVMe - Ottimo rapporto qualità/prezzo
• Server Dedicati Eco - Per server con molti giocatori
• Server Dedicati Performance - Prestazioni massime

Prerequisiti

• Accesso SSH come root o utente con privilegi sudo
• Sistema Linux 64 bit (Ubuntu/Debian consigliato)
• Processore x64 o ARM64
• Minimo 4 GB di RAM (8 GB consigliati)
• Circa 10 GB di spazio disco libero (SSD consigliato)
• Porta 5520 UDP accessibile
• Un account Hytale valido

Configurazione richiesta

Componente	Minimo	Consigliato
RAM	4 GB	8-16 GB
CPU	2 core	4 core
Storage	10 GB SSD	20 GB SSD
Rete	100 Mbps	1 Gbps

Protocollo di rete

Hytale utilizza il protocollo QUIC su UDP (non TCP come Minecraft). La porta predefinita è 5520 UDP.

Aggiornamento del sistema

sudo apt update && sudo apt upgrade -y

Installazione di Java 25

Hytale richiede Java 25 come minimo. Le versioni precedenti non funzioneranno.

Installare Adoptium Temurin 25

# Aggiungere il repository Adoptium
sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# Installare Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

Verificare l'installazione

java --version

Creazione di un utente dedicato

Per motivi di sicurezza, crea un utente dedicato:

sudo adduser --disabled-password --gecos "" hytale

Configurazione del firewall

Apri la porta UDP 5520:

Con UFW

sudo ufw allow 5520/udp
sudo ufw reload

Con iptables

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Download del server Hytale

Metodo consigliato: Hytale Downloader CLI

Connettiti come utente hytale:

sudo -u hytale bash
cd ~

Crea la directory e scarica lo strumento:

mkdir -p ~/hytale-server
cd ~/hytale-server
wget https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x hytale-downloader-linux-amd64

Scaricare i file del server

./hytale-downloader-linux-amd64

Il terminale ti chiederà di andare su oauth.accounts.hytale.com per autorizzare il download. Segui le istruzioni visualizzate.

Una volta validato, otterrai un archivio (es: 2026.01.13-xxxx.zip).

Estrarre i file

unzip 2026.01.*.zip

Avrai una cartella Server/ e un file Assets.zip.

Primo avvio e autenticazione

Avviare il server

cd ~/hytale-server
java -jar Server/HytaleServer.jar --assets Assets.zip

Autenticare il server

Al primo avvio, il server mostra "No Server Token Configured". Devi collegarlo al tuo account Hytale.

1. Nella console del server, digita:

   /auth login device

2. La console mostra un codice (es: ABCD-1234) e un URL

3. Vai su https://accounts.hytale.com/device

4. Inserisci il codice visualizzato

5. Una volta validato, la console mostrerà: Autenticazione riuscita! Modalità: OAUTH_DEVICE

Nota

Ogni account Hytale può creare fino a 100 server massimo.

Configurazione del server

File config.json

Dopo il primo avvio, modifica il file di configurazione:

nano ~/hytale-server/config.json

Parametri principali

Parametro	Tipo	Descrizione
ServerName	Testo	Nome pubblico del server
MOTD	Testo	Messaggio di benvenuto
Password	Testo	Password (vuoto = pubblico)
MaxPlayers	Intero	Numero max di giocatori
MaxViewRadius	Intero	Distanza di vista in chunk (12-16 consigliato)
LocalCompressionEnabled	Booleano	Compressione dati (consigliato: true)
Defaults > World	Testo	Nome del mondo predefinito
Defaults > GameMode	Testo	Modalità di gioco (Adventure o Creative)

Ottimizzazione del lancio

Allocazione memoria

java -Xms4G -Xmx8G -jar Server/HytaleServer.jar --assets Assets.zip

Dimensione server	RAM consigliata
Piccolo (1-10 giocatori)	4 GB
Medio (10-20 giocatori)	6-8 GB
Grande (20+ giocatori)	10-16 GB

Cache AOT (Ahead-Of-Time)

Per migliorare i tempi di avvio:

java -XX:AOTCache=HytaleServer.aot -Xms4G -Xmx8G -jar Server/HytaleServer.jar --assets Assets.zip

Configurazione come servizio systemd

Creare il file di servizio

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

Contenuto del file:

[Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
Type=simple
User=hytale
Group=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot -jar /home/hytale/hytale-server/Server/HytaleServer.jar --assets /home/hytale/hytale-server/Assets.zip
Restart=on-failure
RestartSec=20

[Install]
WantedBy=multi-user.target

Attivare e avviare il servizio

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

Comandi di gestione

# Verificare lo stato
sudo systemctl status hytale.service

# Fermare il server
sudo systemctl stop hytale.service

# Riavviare il server
sudo systemctl restart hytale.service

# Vedere i log
sudo journalctl -u hytale.service -f

Comandi console

Comando	Descrizione
/auth login device	Autenticare il server
/stop	Fermare il server
/save	Salvare il mondo
/kick <giocatore>	Espellere un giocatore
/ban <giocatore>	Bannare un giocatore
/unban <giocatore>	Sbannare un giocatore
/whitelist add <giocatore>	Aggiungere alla whitelist
/whitelist remove <giocatore>	Rimuovere dalla whitelist
/op <giocatore>	Dare diritti admin
/deop <giocatore>	Rimuovere diritti admin

Backup automatico

Script di backup

sudo nano /home/hytale/backup.sh

#!/bin/bash
BACKUP_DIR="/home/hytale/backups"
SERVER_DIR="/home/hytale/hytale-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p $BACKUP_DIR

# Backup dell'universo e della config
tar -czf $BACKUP_DIR/hytale_$DATE.tar.gz -C $SERVER_DIR universe config.json bans.json whitelist.json permissions.json

# Eliminare i backup più vecchi di 7 giorni
find $BACKUP_DIR -name "hytale_*.tar.gz" -mtime +7 -delete

echo "Backup completato: hytale_$DATE.tar.gz"

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

Pianificare il backup

sudo crontab -u hytale -e

Aggiungi:

# Backup ogni 6 ore
0 */6 * * * /home/hytale/backup.sh

Connessione al server

I giocatori possono connettersi tramite:

1. Avviare Hytale
2. Andare in "Multiplayer"
3. Inserire l'indirizzo: IP_DEL_SERVER:5520
4. Se è configurata una password, inserirla

In caso di problemi

Il server non si avvia

• Controlla la versione di Java: java --version (deve essere 25+)
• Controlla i log: sudo journalctl -u hytale.service -n 100
• Verifica che i file Assets.zip e Server/ siano presenti

Errore di autenticazione

• Riesegui /auth login device nella console
• Verifica che il tuo account Hytale sia valido
• Controlla la connessione internet del server

I giocatori non riescono a connettersi

• Verifica che la porta 5520 UDP sia aperta: sudo ufw status
• Verifica che il server sia in ascolto: ss -ulnp | grep 5520
• Testa con nc -zvu IP_SERVER 5520

Problemi di prestazioni

• Aumenta la RAM allocata (-Xmx)
• Riduci MaxViewRadius in config.json
• Attiva LocalCompressionEnabled
• Pianifica riavvii regolari