Dall'uscita di Chapter I (Update 7) il 12 ottobre 2026, il gioco di tutti i giocatori si è aggiornato da solo, ma il tuo server no: finché resta sulla Update 6, nessuno può più connettersi. È anche l'aggiornamento più delicato dall'inizio dell'accesso anticipato, perché converte il mondo senza possibilità di tornare indietro e rende inutilizzabile buona parte delle mod. Ecco la procedura passo passo, verificata sulla versione 0.7.2, per aggiornare un server esistente senza perdere nulla.
Cosa cambia Chapter I per un server esistente
Se parti da zero, la nostra guida per creare un server Hytale spiega l'installazione completa. Qui partiamo da un server che gira già sulla Update 6. Secondo le note di versione ufficiali di Hypixel Studios, queste sono le modifiche che ti riguardano direttamente:
| Modifica | Conseguenza per te |
|---|---|
| Nuova versione del protocollo di rete | Un client aggiornato non può entrare in un server ancora sulla Update 6, e viceversa. |
| Nuovo formato di salvataggio delle sezioni di blocchi | Il mondo viene convertito al primo caricamento. Occupa meno spazio, ma non può più essere aperto da una versione precedente. |
| Molti metodi dell'API di modding rimossi o sostituiti | Le mod .jar compilate per la Update 6 possono impedire l'avvio del server. |
| Asset rinominati e nuovo formato per alcuni campi audio | I pacchetti di contenuti che usano i vecchi nomi potrebbero non caricarsi più. |
| Controllo della cartella di installazione del launcher | Il server si arresta con il codice 11 se la cartella di lavoro, il mondo o i backup si trovano nella cartella del launcher. |
MaxViewRadius limitato a 32 | Un valore fuori dall'intervallo da 1 a 32 viene corretto con un avviso, senza bloccare l'avvio. |
| Comandi rinominati | /fragment diventa /portal, /leave diventa /portal leave e /cursethis diventa /ephemeral. |
Quale versione installare: almeno la 0.7.2
Non fermarti alla versione di lancio 0.7.0. Sono seguiti due hotfix, ed entrambi riguardano i server:
- 0.7.1 (13 ottobre): le connessioni a un mondo ospitato su Windows non scadono più dopo 30 secondi, e un giocatore il cui indirizzo IP cambia durante la sessione può riconnettersi senza essere rifiutato come «già connesso».
- 0.7.2 (14 ottobre): corregge un crash che disconnetteva tutti i giocatori di un mondo quando un chunk di grotta caricava un vecchio segnalatore di spawn dei goblin creato con la Update 6. È proprio il caso dei mondi convertiti. La 0.7.2 corregge anche un crash su Linux nei mondi che usano il salvataggio dei chunk RocksDB.
Al momento della stesura, la 0.7.2 è l'ultimo hotfix di Chapter I. Prima di iniziare, controlla la versione disponibile con /update check o ./hytale-downloader -print-version.
Passo 1: preparare la manutenzione
Avvisa i giocatori e prevedi circa un'ora per il backup, il primo avvio e i test. Poi annota la versione attuale dalla console:
/update statusInfine fai l'inventario della cartella mods/: nome e versione di ogni mod e se il suo autore ha già pubblicato una versione per Chapter I. Questa lista ti servirà al passo 3 e quando reinstallerai le mod.
Passo 2: salvare il mondo, la tua unica vera garanzia
La cartella universe/ contiene i mondi e i dati dei giocatori. Poiché la conversione è a senso unico, una copia fatta prima del primo avvio in 0.7.x è l'unico modo per tornare indietro. Arresta il server correttamente con /stop, poi archivia il mondo, i file di configurazione e le mod, possibilmente fuori dalla cartella del server:
# Linux, dalla cartella Server/
tar -czf ~/hytale-update6-$(date +%F).tar.gz universe mods config.json permissions.json whitelist.json bans.json# Windows (PowerShell), dalla cartella Server\
Compress-Archive -Path universe, mods, config.json, permissions.json, whitelist.json, bans.json -DestinationPath ..\hytale-update6.zipVerifica che l'archivio non sia vuoto e che la sua dimensione sia simile a quella di universe/. Se uno dei file elencati non esiste sul tuo server, toglilo semplicemente dal comando.
Il sistema di aggiornamento integrato può anche eseguire un backup completo prima di applicare una versione, grazie all'opzione RunBackupBeforeUpdate, ma solo se è configurata una cartella di backup (--backup-dir). Consideralo una rete di sicurezza in più, non la tua unica copia.
Passo 3: mettere da parte le mod
Chapter I ha rimosso o sostituito una lunga lista di metodi che le mod usano per lavorare su chunk, blocchi e mondi. Una mod che chiama un metodo scomparso può non caricarsi o addirittura impedire l'avvio dell'intero server. Per un aggiornamento senza sorprese, avvia la nuova versione senza alcuna mod:
mkdir mods-update6
mv mods/* mods-update6/Su Windows basta spostare il contenuto di mods in una cartella mods-update6 con Esplora file.
Attenzione alle mod che aggiungono blocchi od oggetti. Se carichi il tuo mondo reale senza di esse, quei blocchi potrebbero sparire o essere sostituiti. In quel caso, esegui il primo avvio senza mod su una copia del mondo e apri il mondo principale solo dopo aver installato le versioni per Chapter I di quelle mod.
Passo 4: installare la nuova versione
Metodo 1: il comando /update integrato
È il metodo ufficiale se il tuo server segue la struttura prevista da Hypixel: una cartella principale con Assets.zip e lo script start.sh o start.bat, e il server avviato dalla sottocartella Server/. Senza questa struttura il sistema di aggiornamento si disattiva. Il server deve anche essere autenticato con /auth login device.
/update check # cerca una nuova versione
/update download # la scarica in updater/staging/
/update apply --confirm # esegue il backup, poi arresta il server (codice 8)Il server non si riavvia da solo. Si arresta con il codice di uscita 8, ed è lo script start.sh o start.bat a rilevare quel codice, copiare i nuovi file (HytaleServer.jar, Assets.zip e gli script) mantenendo configurazione, mondi e mod, e riavviare il server. Se avvii java direttamente o tramite un servizio che non usa questi script, l'aggiornamento si ferma lì. Hai copiato i file a mano e non hai gli script? Il comando /update setup li crea nella cartella principale.
Se cambi idea prima di applicarlo, /update cancel elimina la versione scaricata.
Metodo 2: Hytale Downloader
Su un VPS, lo strumento ufficiale da riga di comando è il metodo più prevedibile. Aggiorna prima lo strumento stesso, poi scarica la nuova versione in una cartella temporanea:
./hytale-downloader -check-update # aggiorna lo strumento se necessario
./hytale-downloader -print-version # mostra la versione disponibile
./hytale-downloader -download-path hytale-0.7.2.zip
unzip hytale-0.7.2.zip -d nuova-versioneCopia poi solo i file del gioco al loro posto: Server/HytaleServer.jar (e HytaleServer.aot se presente), Assets.zip, oltre a start.sh e start.bat. Non sovrascrivere mai config.json, universe/ o mods/ con quelli dell'archivio.
Metodo 3: presso un hosting
Su un pannello di hosting, l'aggiornamento si fa di solito reinstallando la versione o con un pulsante dedicato. Fai comunque il backup del passo 2 e scaricalo sul tuo computer prima di iniziare.
Passo 5: primo avvio e conversione del mondo
Avvia il server e segui la console. Al primo caricamento ogni mondo viene convertito nel nuovo formato, il che può allungare l'avvio su un mondo grande: non interromperlo. Poi verifica:
- che
/update statusmostri la nuova versione; - che la cartella
logs/non contenga errori; - se compare un avviso su
MaxViewRadius: in tal caso arresta il server e imposta inconfig.jsonun valore di 32 o inferiore; - che un primo giocatore con il gioco aggiornato riesca a entrare, prima di riaprire il server a tutti.
Se il server si arresta subito con il codice 11, i suoi dati si trovano nella cartella di installazione del launcher: sposta la cartella del server altrove. L'opzione --allow-install-dir forza l'avvio, ma Hypixel avverte che espone a perdite di dati.
Aggiorna anche le attività pianificate e gli script di amministrazione che usano ancora /fragment, /leave o /cursethis.
Passo 6: rimettere le mod una alla volta
Per ogni mod della tua lista, procurati la versione che il suo autore indica come compatibile con Chapter I, mettila in mods/, riavvia e leggi i log. Una mod alla volta: se il server non parte, saprai subito quale è la colpevole. Una mod senza versione compatibile resta in mods-update6/ finché il suo autore non la aggiorna.
Gli errori più comuni dopo l'aggiornamento
| Sintomo | Causa | Soluzione |
|---|---|---|
| Tutti i giocatori vengono rifiutati con un messaggio di versione incompatibile | Il server è ancora sulla Update 6 | Aggiornare il server e riavviarlo |
| Un solo giocatore viene rifiutato | Il suo gioco non è aggiornato o usa un altro canale (pre-release) | Riavviare il launcher e controllare il canale release |
| Il server si arresta con il codice 8 | Comportamento normale durante un aggiornamento | Avviare il server con start.sh o start.bat |
| Il server si arresta con il codice 11 | Dati nella cartella del launcher | Spostare il server in una cartella dedicata |
| Una mod non si carica | Mod compilata per la Update 6 | Rimuoverla e attendere una versione per Chapter I |
| Tutti vengono disconnessi esplorando le grotte | Vecchio segnalatore di spawn dei goblin (corretto nella 0.7.2) | Installare la 0.7.2 |
| Un mondo va in crash su Linux | Salvataggio RocksDB (corretto nella 0.7.2) | Installare la 0.7.2 |
| Le connessioni scadono dopo 30 secondi su un server Windows | Bug corretto nella 0.7.1 | Installare la 0.7.2 |
/leave non funziona più | Comando rinominato | Usare /portal leave |
Tornare indietro se qualcosa va storto
Dopo un aggiornamento con /update, i file precedenti del server vengono conservati in updater/backup/. Lo script ufficiale indica la procedura: eliminare Server/ e Assets.zip, poi rimettere al loro posto quelli della cartella di backup. Questi file non contengono il vecchio mondo: dato che è stato convertito, devi sostituire anche universe/ con la copia del passo 2.
Tieni presente una cosa: un server riportato alla Update 6 non accetterà i giocatori il cui gioco è già su Chapter I. Tornare indietro serve soprattutto a recuperare un mondo intatto, non a continuare a giocare sulla vecchia versione. Nella maggior parte dei casi, la soluzione giusta è ripristinare il backup, togliere la mod problematica e rifare l'aggiornamento.
Automatizzare i prossimi aggiornamenti
Finché client e server dovranno avere esattamente la stessa versione del protocollo, ogni nuova versione ti obbligherà ad aggiornare in fretta. Hypixel ha annunciato una tolleranza di due versioni di differenza tra client e server, ma non è ancora disponibile. Nel frattempo, la sezione Update di config.json può lavorare al posto tuo:
"Update": {
"Enabled": true,
"CheckIntervalSeconds": 3600,
"RunBackupBeforeUpdate": true,
"BackupConfigBeforeUpdate": true,
"AutoApplyMode": "WhenEmpty",
"AutoApplyDelayMinutes": 30
}Con WhenEmpty l'aggiornamento viene applicato appena non c'è più nessuno connesso. Scheduled lo applica dopo il ritardo indicato, anche con giocatori online, avvisandoli prima. Il valore predefinito, Disabled, aspetta il tuo /update apply --confirm. Su un server con molte mod conviene restare in modalità manuale: un aggiornamento automatico potrebbe riavviare il server con mod non più funzionanti. Per disattivare del tutto il sistema, imposta la variabile d'ambiente HYTALE_DISABLE_UPDATES.
Aggiornamenti senza stress con un hosting
Da OuiHeberg, ogni pacchetto OuiBox compatibile con Hytale include backup da creare prima di un aggiornamento: 5 con l'OuiBox 8G a 9,98 € al mese, 10 con l'OuiBox 12G a 16,79 € al mese e 15 con l'OuiBox 16G a 21,59 € al mese. Crei il backup dal pannello, aggiorni e lo ripristini se qualcosa va storto, senza riga di comando.
Domande frequenti
Perderò il mio mondo passando a Chapter I?
No. Il mondo viene convertito automaticamente e conserva le tue costruzioni. La conversione però è definitiva: senza una copia fatta prima dell'aggiornamento non c'è modo di tornare alla Update 6.
Perché i miei amici non riescono più a entrare nel mio server dal 12 ottobre?
Il loro gioco è passato a Chapter I e il tuo server è rimasto sulla Update 6. Entrambi devono usare esattamente la stessa versione del protocollo: aggiorna il server.
Le mie mod funzionano ancora con la Update 7?
Non per forza. Gran parte dell'API usata dalle mod è cambiata. Sono sicure solo le mod ricompilate dal loro autore per Chapter I.
Devo autenticare di nuovo il server dopo l'aggiornamento?
Di norma no, perché i file di autenticazione restano nella cartella Server/. Se il server lo chiede, esegui di nuovo /auth login device: da Chapter I funziona anche con una sessione già attiva.
Come faccio a conoscere la versione del mio server?
Digita /update status nella console. Per l'ultima versione disponibile usa /update check o ./hytale-downloader -print-version.