Creare un server Hytale richiede pochi minuti, a patto di conoscere le trappole in cui cadono quasi tutti i principianti: la versione giusta di Java, l'autenticazione del server e una porta da aprire in UDP, non in TCP. Questa guida illustra ogni passaggio, dall'installazione al primo giocatore connesso, ed è aggiornata a Chapter I (Update 7), uscito a ottobre 2026, che ha cambiato diverse regole lato server.
Cosa sapere prima di iniziare
Hytale è in accesso anticipato dal 13 gennaio 2026. Hypixel Studios fornisce gratuitamente il server ufficiale: un programma Java chiamato HytaleServer.jar, accompagnato da un archivio Assets.zip con le risorse del gioco. La versione attuale è Chapter I “Out of the Breach”, uscita il 12 ottobre 2026 e seguita dagli hotfix 0.7.1 e 0.7.2 il 13 e 14 ottobre.
Tre aspetti distinguono Hytale da altri giochi che potrebbe aver già ospitato:
- Java 25 è obbligatorio. Le versioni precedenti non avviano il server.
- La rete usa QUIC su UDP, sulla porta
5520per impostazione predefinita. Un inoltro solo TCP non funzionerà mai. - Il server deve essere autenticato con un account Hytale prima di accettare giocatori.
Client e server devono inoltre usare esattamente la stessa versione del protocollo. A ogni aggiornamento del gioco va aggiornato anche il server, altrimenti nessuno potrà più connettersi.
Requisiti di sistema
Il server funziona su Windows, Linux e macOS, con processori x64 o arm64. La RAM è la risorsa più sollecitata, soprattutto per via della distanza visiva. Ecco le raccomandazioni più diffuse, da adattare al Suo utilizzo:
| Giocatori | RAM assegnata (-Xmx) | CPU | Spazio su disco |
|---|---|---|---|
| Da 1 a 5 | 4 GB | 2 core a 2,5 GHz | 10 GB |
| Da 5 a 10 | 6 GB | 4 core | 20 GB SSD |
| Da 10 a 20 | 8 GB | 4 core da 3 GHz in su | 20 GB SSD o NVMe |
| Oltre 20 | 12 GB o più | 6 core o più | NVMe consigliato |
Conta anche la banda in upload: circa 10 Mbps bastano per un piccolo gruppo di amici, un server pubblico ne richiede molta di più.
Dove ospitare il server
| Opzione | Vantaggi | Limiti |
|---|---|---|
| Il proprio PC | Gratuito, ideale per i test | Si spegne con il PC, serve l'inoltro delle porte, impossibile dietro CGNAT |
| VPS o server dedicato | Online 24/7, IP fisso, controllo totale | Installazione e manutenzione Linux a Suo carico |
| Hosting specializzato | Pronto in pochi minuti, pannello, backup, protezione anti-DDoS | Abbonamento mensile |
I passaggi seguenti valgono per un PC o un VPS. Con un servizio di hosting, i passaggi 1, 2 e 5 sono già fatti.
Passaggio 1: installare Java 25
La distribuzione più usata è Eclipse Temurin 25, pubblicata gratuitamente da Adoptium. Su Windows e macOS usi il programma di installazione ufficiale. Su Ubuntu o Debian, dopo aver aggiunto il repository Adoptium, basta un solo comando:
sudo apt update
sudo apt install temurin-25-jdk
java --version
L'ultimo comando deve mostrare una versione che inizia con 25. Se compare un'altra versione di Java, sarà quella a essere usata: cambi la versione predefinita oppure richiami Java 25 con il percorso completo nello script di avvio.
Passaggio 2: ottenere i file del server
Metodo rapido: copiarli dal launcher
Se il gioco è installato sulla macchina, i file si trovano nella cartella del launcher:
- Windows:
%appdata%\Hytale\install\release\package\game\latest - Linux:
$XDG_DATA_HOME/Hytale/install/release/package/game/latest - macOS:
~/Application Support/Hytale/install/release/package/game/latest
Copi la cartella Server e il file Assets.zip in una nuova cartella dedicata, ad esempio hytale-server. Copi i file, non avvii il server sul posto: da Chapter I il server si rifiuta di partire (codice di uscita 11) se la cartella di lavoro, il mondo o i backup si trovano nella cartella di installazione del launcher. L'opzione --allow-install-dir salta questo controllo, ma Hypixel avverte che può causare perdita di dati.
Metodo consigliato: Hytale Downloader
Su un VPS usi lo strumento ufficiale da riga di comando Hytale Downloader. Al primo avvio Le chiederà di accedere al Suo account Hytale da un browser per autorizzare il download.
./hytale-downloader -print-version # mostra la versione disponibile
./hytale-downloader # scarica l'ultima versione
./hytale-downloader -patchline pre-release # canale pre-release
Otterrà un archivio datato. Una volta estratto, contiene la cartella Server/ e il file Assets.zip nella struttura ufficiale attesa dal server.
Passaggio 3: avviare il server
Dalla cartella Server, il comando minimo è:
java -jar HytaleServer.jar --assets ../Assets.zip
Se il Suo archivio contiene già uno script start.sh o start.bat accanto ad Assets.zip, usi prima quello: è lo script che applica gli aggiornamenti scaricati dal server. Altrimenti crei uno script proprio, ad esempio run-hytale.sh, impostando la memoria e sfruttando la cache AOT inclusa, che velocizza l'avvio:
#!/bin/bash
cd Server
java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot \
-jar HytaleServer.jar --assets ../Assets.zip \
--bind 0.0.0.0:5520 --backup --backup-dir backups
Lo renda eseguibile con chmod +x run-hytale.sh. Su Windows, inserisca la stessa riga java in un file .bat. Regoli -Xmx in base alla tabella precedente, lasciando sempre 1 o 2 GB al sistema. L'opzione --backup attiva i backup automatici, mentre --backup-frequency ne imposta l'intervallo.
Su un VPS, avvii il server in una sessione screen o tmux, o meglio come servizio systemd, così continuerà a girare dopo la chiusura della connessione SSH.
Passaggio 4: autenticare il server
Al primo avvio il server non accetta ancora giocatori. Digiti nella console:
/auth login device
Il server mostra un indirizzo e un codice breve. Apra nel browser la pagina di attivazione dei dispositivi del sito account di Hytale, effettui l'accesso e inserisca il codice. Non perda tempo: il codice è valido solo per un tempo limitato. Da Chapter I il comando funziona anche se il server è già connesso, e un tentativo fallito conserva la sessione esistente.
Passaggio 5: aprire la porta 5520 in UDP
È qui che sbagliano quasi tutte le guide e i giocatori: Hytale usa solo UDP. Autorizzi la porta nel firewall della macchina:
# Linux con UFW
sudo ufw allow 5520/udp
# Linux con iptables
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
# Windows (PowerShell come amministratore)
New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow
A casa, aggiunga poi un inoltro delle porte nel router: protocollo UDP, porta esterna e interna 5520, verso l'IP locale del PC su cui gira il server. I Suoi amici si collegheranno usando il Suo IP pubblico.
Se il Suo provider La colloca dietro un CGNAT, cosa frequente con i router 4G e 5G e con alcuni operatori in fibra, nessun inoltro funzionerà. Le alternative sono un tunnel, un VPS o un servizio di hosting.
Passaggio 6: configurare il server
Dopo il primo avvio, la cartella Server contiene tra l'altro:
| Elemento | Funzione |
|---|---|
config.json | Configurazione principale |
universe/ | Mondi e dati dei giocatori, da salvare per primi |
mods/ | Mod in formato .jar o .zip |
permissions.json | Gruppi e permessi |
logs/ | Log, il primo posto da controllare in caso di problemi |
Arresti sempre il server prima di modificare un file: riscrive i propri file di configurazione durante il gioco e potrebbe sovrascrivere le Sue modifiche. Le impostazioni più utili di config.json:
ServerNameeMOTD: il nome e il messaggio mostrati ai giocatori.Password: vuota per un server aperto, oppure una password richiesta all'ingresso.MaxPlayers: il numero massimo di giocatori, da adeguare alla RAM.MaxViewRadius: la distanza visiva in chunk, principale fattore di consumo di RAM. Di solito si consiglia di non superare 12. Da Chapter I, ogni valore fuori dall'intervallo da 1 a 32 viene riportato entro questi limiti con un avviso.Defaults: il mondo e la modalità di gioco predefiniti.
Riservare il server agli amici
Per un server privato, aggiunga prima i giocatori autorizzati, poi attivi la whitelist dalla console:
/whitelist add <nomegiocatore>
/whitelist enable
/whitelist list
La sintassi dei comandi è già cambiata tra le versioni dell'accesso anticipato: se uno viene rifiutato, digiti /help nella console per vedere quella della Sua versione. Per assegnarsi i diritti di amministratore, consulti la nostra guida su come diventare OP su un server Hytale.
Aggiungere mod
Copi i file .jar o .zip nella cartella mods/, riavvii e verifichi in logs/ che siano stati caricati. Li scarichi solo da fonti note: la pagina ufficiale dell'autore o una piattaforma di mod affidabile. Attenzione: Chapter I ha rimosso o sostituito gran parte dell'API di modding. Una mod creata per una versione precedente deve essere ricompilata dal suo autore, altrimenti potrebbe impedire l'avvio. Provi sempre una nuova mod su una copia del mondo.
Aggiornare senza perdere il mondo
Il server integra un sistema di aggiornamento utilizzabile dalla console:
/update status # versione attuale
/update check # cerca un aggiornamento
/update download # scarica in updater/staging/
/update apply --confirm # backup, poi arresto del server
La sostituzione dei file avviene poi al riavvio tramite lo script di avvio ufficiale. Se avvia java direttamente, scarichi piuttosto la nuova versione con Hytale Downloader.
Prima di ogni aggiornamento importante, arresti il server e copi la cartella universe/ altrove. Un mondo aperto da una versione più recente viene convertito automaticamente e non può più essere aperto da una versione precedente: quella copia è l'unico modo per tornare indietro.
Risoluzione rapida dei problemi
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Il server si chiude subito con il codice 11 | Avviato nella cartella del launcher | Copiare Server e Assets.zip in una cartella separata |
| Errore all'avvio sulla versione delle classi | Java troppo vecchio | Installare Java 25 e controllare java --version |
| Nessuno riesce a connettersi dall'esterno | Porta aperta in TCP o router dietro CGNAT | Aprire 5520 in UDP, oppure passare a un VPS |
| Giocatori rifiutati dopo un aggiornamento | Versioni del protocollo diverse | Aggiornare il server alla stessa versione del client |
| Crash o lag con più giocatori | RAM insufficiente o distanza visiva troppo alta | Aumentare -Xmx e ridurre MaxViewRadius |
Per approfondire le prestazioni, la nostra guida all'ottimizzazione di un server Hytale descrive le impostazioni avanzate.
La soluzione senza installazione
Se preferisce non occuparsi di Java, porte e aggiornamenti, un servizio di hosting lo fa al posto Suo. Da OuiHeberg, le offerte OuiBox pronte per Hytale partono dalla OuiBox 8G (8 GB di RAM, 4 core, 50 GB NVMe) a 9,98 € al mese, seguita dalla OuiBox 12G (12 GB, 5 core, 80 GB NVMe) a 16,79 € al mese e dalla OuiBox 16G (16 GB, 6 core, 120 GB NVMe) a 21,59 € al mese. Il server è pronto in pochi minuti: resta solo da autenticarlo e invitare gli amici.
Domande frequenti
Creare un server Hytale è gratuito?
Sì, Hypixel Studios fornisce gratuitamente il software del server. Serve solo un account Hytale per autenticarlo. L'unico costo eventuale è la macchina che lo esegue.
Quale porta usa un server Hytale?
La porta UDP 5520 per impostazione predefinita. Può cambiarla con l'opzione --bind, purché apra la nuova porta in UDP.
Quanta RAM serve per un server Hytale?
Di solito si consigliano 4 GB da 1 a 5 giocatori, 8 GB da 10 a 20 giocatori, 12 GB o più oltre. La distanza visiva pesa quanto il numero di giocatori.
Posso giocare sul server dallo stesso PC?
Sì. Si colleghi a 127.0.0.1 dal gioco. Si assicuri di avere RAM sufficiente per far girare insieme client e server.
Perché i miei amici non riescono a entrare nel server?
Nella maggior parte dei casi la porta 5520 è aperta in TCP invece che in UDP, manca l'inoltro nel router oppure la connessione è dietro CGNAT. Verifichi anche che tutti abbiano aggiornato il gioco.