Hytale fornisce un server dedicato ufficiale come HytaleServer.jar (Java 25, almeno 4 GB di memoria, UDP 5520 su QUIC) da autenticare con un account Hytale. Essendo il gioco in accesso anticipato, consulta il manuale ufficiale del supporto Hytale; i dettagli qui sotto incrociano supporto e guide di host.
Installazione passo dopo passo
Verifica la macchina: Java 25 (x64/arm64), 4 GB RAM min..
Ottieni i file del server: la cartella Server (con HytaleServer.jar) e Assets.zip dall'installazione del gioco, oppure con l'Hytale Downloader ufficiale (login con codice).
Installa Java 25 e verifica con java -version.
Esegui java -jar HytaleServer.jar --assets Assets.zip; config.json, logs/ e universe/ vengono creati al primo avvio.
Nella console esegui /auth login device, approva il codice su accounts.hytale.com/device, poi /auth persistence Encrypted.
Modifica config.json a server fermo (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius).
Apri le porte 5520/UDP nel firewall e sul router.
Entra con l'indirizzo mostrato in cima alla console (IP:5520); i record DNS SRV non sono ancora supportati, usa un record A.
Configura l'avvio automatico (attività pianificata o servizio systemd).
Pianifica i backup di universe/ e gli aggiornamenti.
Requisiti
- Java 25 (x64 o arm64); almeno 4 GB di memoria, la distanza di visuale (MaxViewRadius, max 12 chunk consigliati) è il principale consumo
- Un account Hytale che possiede il gioco; una licenza è limitata a 500 server
- Client e server devono usare la stessa versione di protocollo
Installazione locale (Windows)
Crea una cartella (es. C:\HytaleServer), copia la cartella Server e Assets.zip da %appdata%\Hytale\install\release\package\game\latest ed esegui il comando. Un server sullo stesso PC del gioco richiede almeno 16 GB di RAM in totale.
cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zipInstallazione su VPS / server dedicato Linux
Su Ubuntu/Debian: utente non root, Java 25 (ad es. Eclipse Temurin 25), poi l'Hytale Downloader per ottenere il server (login con codice, token salvato in .hytale-downloader-credentials.json; elimina il file in caso di errori di autenticazione). Le opzioni esatte del downloader non sono dettagliate qui: leggi la sua guida.
sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zipPorte da aprire
- 5520/UDP: porta di gioco predefinita (QUIC), modificabile con --bind; nessun TCP
Firewall Linux (ufw)
Su Ubuntu/Debian consenti prima SSH per non restare chiuso fuori, poi le porte del gioco.
sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw statusFirewall di Windows (netsh)
In PowerShell come amministratore (o «cmd» amministratore):
netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520Firewall del provider e port forwarding (NAT)
Se il server è presso un provider (OVH, Hetzner, Scaleway…), apri le stesse porte nel suo firewall di rete («security group»). In casa, inoltra le porte (NAT) dal router all'IP locale fisso della macchina. Testa dall'esterno (rete mobile o un amico): un test dalla tua rete non prova nulla.
Avvio automatico e supervisione
Crea /etc/systemd/system/<nome>.service ed esegui: sudo systemctl daemon-reload && sudo systemctl enable --now <nome>. Log: journalctl -u <nome> -f.
[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target
[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetAvvio automatico su Windows (attività pianificata)
Crea un'attività pianificata «All'avvio» che esegua lo script di avvio, con i privilegi più elevati e «Esegui indipendentemente dalla connessione dell'utente».
Aggiornamenti, backup e riavvii
Ferma il server, riesegui Hytale Downloader e riavvia. Fai il backup di universe/ prima di aggiornamenti importanti. Il server controlla una nuova versione a ogni avvio: di solito basta riavviare. Fai un backup prima di cambiare patchline (release/pre-release): i mondi di una pre-release potrebbero non aprirsi su build più vecchie.
# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/Pubblicare e trovare il tuo server
Quando il server è pubblico, aggiungilo su https://game-rank.com/jeux/hytale (sito del proprietario di questo strumento) così i giocatori possono trovarlo, seguirlo e votarlo.
Risoluzione dei problemi
- Irraggiungibile dall'esterno ma ok in localhost: manca la regola del firewall di sistema, del provider o l'inoltro NAT, oppure il protocollo (UDP/TCP) è sbagliato. Controlla ogni livello.
- Connessione rifiutata dopo un aggiornamento del gioco: client e server devono avere la stessa versione. Riesegui l'aggiornamento del server e riavvialo.
- Il server si chiude subito: avvialo da una console per leggere l'errore e controlla RAM libera, disco e requisiti software.
- «Autenticazione richiesta» o login perso al riavvio: ripeti /auth login device e controlla /auth persistence (Memory = si perde al riavvio; scegli Encrypted).
- Memoria insufficiente o lag: riduci MaxViewRadius (/maxviewradius <raggio>) prima di aggiungere RAM.
Domande frequenti
- Hytale ha un server dedicato ufficiale?
- Sì: HytaleServer.jar, documentato dal supporto Hytale. Il gioco è in accesso anticipato, quindi opzioni e formati (config.json…) possono cambiare.
- Perché nessun generatore di config.json?
- Solo pochi campi (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius, backup) sono documentati da terzi, senza schema ufficiale: non lo inventiamo. Modifica il file generato a server fermo.
- Cosa devo salvare?
- La cartella universe/ (mondi e dati giocatori), più config.json e permissions.json.
- Si può avviare senza account (modalità offline)?
- Alcune guide citano --auth-mode offline per lo sviluppo; non è la via normale per un server pubblico. Verifica con --help.