Mettre à jour son serveur Hytale vers Chapter I (Update 7) sans perdre son monde

Depuis la sortie de Chapter I (Update 7) le 12 octobre 2026, les clients Hytale se sont mis à jour tout seuls, mais pas votre serveur : tant qu'il reste sur l'Update 6, plus aucun joueur ne peut s'y connecter. Cette mise à jour est aussi la plus délicate depuis le début de l'accès anticipé, car elle convertit votre monde sans retour possible et casse une grande partie des mods. Voici la marche à suivre, vérifiée sur la version 0.7.2, pour mettre à jour un serveur existant sans rien perdre.

Ce que Chapter I change pour un serveur existant

Si vous partez de zéro, notre guide pour créer un serveur Hytale couvre l'installation complète. Ici, on part d'un serveur qui tourne déjà sur l'Update 6. Voici ce qui le concerne directement d'après les notes de version officielles d'Hypixel Studios :

Changement	Conséquence pour vous
Nouvelle version du protocole réseau	Un client à jour ne peut pas rejoindre un serveur resté en Update 6, et inversement.
Nouveau format de stockage des sections de blocs	Le monde est converti au premier chargement. Il prend moins de place sur le disque, mais ne peut plus être ouvert par une version plus ancienne.
Nombreuses méthodes de l'API de modding supprimées ou remplacées	Les mods en .jar compilés pour l'Update 6 peuvent empêcher le serveur de démarrer.
Assets renommés, nouveau format pour certains champs audio	Les packs de contenu qui s'appuient sur les anciens noms peuvent ne plus se charger.
Vérification du dossier d'installation du launcher	Le serveur s'arrête avec le code 11 si son dossier de travail, son monde ou ses sauvegardes se trouvent dans le dossier du launcher.
MaxViewRadius limité à 32	Une valeur hors de l'intervalle 1 à 32 est ramenée dans ces bornes avec un avertissement, sans bloquer le démarrage.
Commandes renommées	/fragment devient /portal, /leave devient /portal leave et /cursethis devient /ephemeral.

Quelle version installer : 0.7.2 au minimum

Ne vous arrêtez pas à la version de sortie 0.7.0. Deux correctifs ont suivi, et ils visent justement les serveurs :

• 0.7.1 (13 octobre) : les connexions à un monde hébergé sous Windows n'expirent plus au bout de 30 secondes, et un joueur dont l'adresse IP change en cours de partie peut se reconnecter sans être refusé comme « déjà connecté ».
• 0.7.2 (14 octobre) : correction d'un crash qui déconnectait tous les joueurs d'un monde quand un chunk de grotte chargeait une ancienne balise d'apparition de gobelins créée sous l'Update 6. Ce cas touche précisément les mondes convertis. La 0.7.2 corrige aussi un crash sous Linux dans les mondes qui utilisent le stockage de chunks RocksDB.

À la date de rédaction, la 0.7.2 est le dernier correctif publié pour Chapter I. Avant de commencer, vérifiez la version disponible avec /update check ou ./hytale-downloader -print-version.

Étape 1 : préparer la maintenance

Prévenez vos joueurs et prévoyez une fenêtre d'une heure, le temps de la sauvegarde, du premier démarrage et des tests. Dans la console, notez ensuite votre version actuelle :

/update status

Faites enfin l'inventaire du dossier mods/ : nom de chaque fichier, version, et existence ou non d'une version compatible Chapter I sur la page de son auteur. Cette liste vous servira à l'étape 3 et pour remettre les mods en place ensuite.

Étape 2 : sauvegarder le monde, la seule vraie assurance

Le dossier universe/ contient vos mondes et les données des joueurs. Comme la conversion est à sens unique, une copie faite avant le premier démarrage en 0.7.x est votre seul moyen de revenir en arrière. Arrêtez proprement le serveur avec /stop, puis archivez le monde, les fichiers de configuration et les mods, de préférence hors du dossier du serveur :

# Linux, depuis le dossier Server/
tar -czf ~/hytale-update6-$(date +%F).tar.gz universe mods config.json permissions.json whitelist.json bans.json

# Windows (PowerShell), depuis le dossier Server\
Compress-Archive -Path universe, mods, config.json, permissions.json, whitelist.json, bans.json -DestinationPath ..\hytale-update6.zip

Vérifiez que l'archive n'est pas vide et que sa taille correspond à peu près à celle du dossier universe/. Si un fichier de la liste n'existe pas chez vous, retirez-le simplement de la commande.

Le système de mise à jour intégré sait aussi faire une sauvegarde complète avant d'appliquer une version, grâce à l'option RunBackupBeforeUpdate, mais seulement si un dossier de sauvegarde est configuré (--backup-dir). Considérez-la comme un filet supplémentaire, pas comme votre unique copie.

Étape 3 : mettre les mods de côté

Chapter I a supprimé ou remplacé une longue liste de méthodes utilisées par les mods qui touchent aux chunks, aux blocs et aux mondes. Un mod qui appelle une méthode disparue peut faire échouer le chargement, voire le démarrage complet du serveur. Pour une mise à jour sans surprise, démarrez la nouvelle version sans aucun mod :

mkdir mods-update6
mv mods/* mods-update6/

Sous Windows, déplacez simplement le contenu de mods dans un dossier mods-update6 avec l'explorateur.

Attention aux mods qui ajoutent des blocs ou des objets. Si vous démarrez votre vrai monde sans eux, les blocs concernés risquent de disparaître ou d'être remplacés. Dans ce cas, faites le premier démarrage sans mods sur une copie du monde, et n'ouvrez le monde principal qu'une fois les versions compatibles Chapter I de ces mods installées.

Étape 4 : installer la nouvelle version

Méthode 1 : la commande /update intégrée

C'est la méthode officielle si votre serveur suit la disposition prévue par Hypixel : un dossier parent qui contient Assets.zip et le script start.sh ou start.bat, et le serveur lancé depuis le sous-dossier Server/. Sans cette disposition, le système de mise à jour se désactive. Le serveur doit aussi être authentifié avec /auth login device.

/update check            # recherche une nouvelle version
/update download         # télécharge dans updater/staging/
/update apply --confirm  # sauvegarde, puis arrête le serveur (code 8)

Le serveur ne redémarre pas tout seul : il s'arrête avec le code de sortie 8, et c'est le script start.sh ou start.bat qui détecte ce code, copie les nouveaux fichiers (HytaleServer.jar, Assets.zip et les scripts) en conservant votre configuration, vos mondes et vos mods, puis relance le serveur. Si vous lancez java directement ou via un service qui n'utilise pas ces scripts, la mise à jour s'arrête là. Vous avez copié vos fichiers à la main et n'avez pas les scripts ? La commande /update setup les génère dans le dossier parent.

Si vous changez d'avis avant d'appliquer, /update cancel supprime la version téléchargée.

Méthode 2 : Hytale Downloader

Sur un VPS, l'outil officiel en ligne de commande reste la méthode la plus prévisible. Mettez d'abord l'outil lui-même à jour, puis téléchargez la nouvelle version dans un dossier temporaire :

./hytale-downloader -check-update            # met à jour l'outil si besoin
./hytale-downloader -print-version           # affiche la version disponible
./hytale-downloader -download-path hytale-0.7.2.zip
unzip hytale-0.7.2.zip -d nouvelle-version

Copiez ensuite uniquement les fichiers du jeu à leur place : Server/HytaleServer.jar (et HytaleServer.aot s'il est présent), Assets.zip, ainsi que start.sh et start.bat. Ne remplacez jamais config.json, universe/ ni mods/ par ceux de l'archive.

Méthode 3 : chez un hébergeur

Sur un panel d'hébergement, la mise à jour se fait en général par une réinstallation de la version ou un bouton dédié. Faites quand même votre sauvegarde de l'étape 2 et téléchargez-la sur votre ordinateur avant de lancer l'opération.

Étape 5 : premier démarrage et conversion du monde

Lancez le serveur et suivez la console. Au premier chargement, chaque monde est converti au nouveau format, ce qui peut rallonger le démarrage sur un gros monde : ne l'interrompez pas. Vérifiez ensuite :

• que /update status affiche bien la nouvelle version ;
• l'absence d'erreur dans le dossier logs/ ;
• un éventuel avertissement sur MaxViewRadius : corrigez alors la valeur dans config.json, serveur arrêté, pour qu'elle ne dépasse pas 32 ;
• la connexion d'un premier joueur, dont le jeu est à jour, avant de rouvrir le serveur à tout le monde.

Si le serveur s'arrête aussitôt avec le code 11, ses données se trouvent dans le dossier d'installation du launcher : déplacez le dossier du serveur ailleurs. L'option --allow-install-dir permet de forcer le démarrage, mais Hypixel prévient qu'elle expose à des pertes de données.

Pensez aussi à mettre à jour vos tâches planifiées et scripts d'administration qui utiliseraient /fragment, /leave ou /cursethis.

Étape 6 : remettre les mods un par un

Pour chaque mod de votre inventaire, récupérez la version annoncée compatible Chapter I, déposez-la dans mods/, redémarrez et lisez les journaux. Un seul mod à la fois : si le serveur refuse de démarrer, vous savez immédiatement lequel est en cause. Un mod sans version compatible reste dans mods-update6/ en attendant que son auteur le mette à jour.

Les erreurs les plus fréquentes après la mise à jour

Symptôme	Cause	Solution
Tous les joueurs sont refusés à la connexion, avec un message de version incompatible	Le serveur est encore en Update 6	Mettre à jour le serveur et le redémarrer
Un seul joueur est refusé	Son jeu n'est pas à jour, ou il utilise un autre canal (pré-version)	Relancer le launcher, vérifier le canal release
Le serveur s'arrête avec le code 8	Comportement normal d'une mise à jour	Lancer le serveur avec start.sh ou start.bat
Le serveur s'arrête avec le code 11	Données dans le dossier du launcher	Déplacer le serveur dans un dossier séparé
Erreur au chargement d'un mod	Mod compilé pour l'Update 6	Le retirer et attendre une version Chapter I
Tout le monde est déconnecté en explorant des grottes	Ancienne balise d'apparition de gobelins (corrigé en 0.7.2)	Installer la 0.7.2
Crash d'un monde sous Linux	Stockage RocksDB (corrigé en 0.7.2)	Installer la 0.7.2
Connexion qui expire après 30 secondes sur un serveur Windows	Bug corrigé en 0.7.1	Installer la 0.7.2
/leave ne fonctionne plus	Commande renommée	Utiliser /portal leave

Revenir en arrière si la mise à jour tourne mal

Après une mise à jour par /update, les anciens fichiers du serveur sont conservés dans updater/backup/. Le script officiel indique la marche à suivre : supprimer Server/ et Assets.zip, puis remettre en place ceux du dossier de sauvegarde. Ces fichiers ne contiennent pas l'ancien monde : comme il a été converti, vous devez aussi remplacer universe/ par la copie faite à l'étape 2.

Gardez une chose en tête : un serveur revenu à l'Update 6 n'acceptera pas les joueurs dont le jeu est déjà en Chapter I. Le retour arrière sert surtout à récupérer un monde intact, pas à continuer de jouer sur l'ancienne version. Dans la plupart des cas, la bonne solution est de repartir de la sauvegarde, de retirer le mod fautif et de refaire la mise à jour.

Automatiser les prochaines mises à jour

Tant que le client et le serveur doivent avoir exactement la même version du protocole, chaque nouvelle version vous oblige à mettre à jour sans tarder. Hypixel a annoncé une tolérance de deux versions d'écart entre client et serveur, mais elle n'est pas encore disponible. En attendant, la section Update de config.json peut faire le travail pour vous :

"Update": {
  "Enabled": true,
  "CheckIntervalSeconds": 3600,
  "RunBackupBeforeUpdate": true,
  "BackupConfigBeforeUpdate": true,
  "AutoApplyMode": "WhenEmpty",
  "AutoApplyDelayMinutes": 30
}

Avec WhenEmpty, la mise à jour s'applique dès que plus personne n'est connecté. Scheduled l'applique après le délai indiqué, même avec des joueurs en ligne, en les prévenant. La valeur par défaut, Disabled, attend votre /update apply --confirm. Sur un serveur très moddé, gardez ce mode manuel : une mise à jour automatique pourrait relancer le serveur avec des mods devenus incompatibles. Pour couper complètement le système, définissez la variable d'environnement HYTALE_DISABLE_UPDATES.

Des mises à jour sans stress chez un hébergeur

Chez OuiHeberg, chaque offre OuiBox compatible Hytale inclut des sauvegardes à faire avant une mise à jour : 5 avec l'OuiBox 8G à 9,98 € par mois, 10 avec l'OuiBox 12G à 16,79 € par mois et 15 avec l'OuiBox 16G à 21,59 € par mois. Vous lancez une sauvegarde depuis le panel, vous mettez à jour, et vous la restaurez en cas de problème, sans ligne de commande.

Questions fréquentes

Vais-je perdre mon monde en passant à Chapter I ?

Non, le monde est converti automatiquement et conserve vos constructions. En revanche, cette conversion est définitive : sans copie faite avant la mise à jour, il est impossible de revenir à l'Update 6.

Pourquoi mes amis ne peuvent plus rejoindre mon serveur depuis le 12 octobre ?

Leur jeu est passé en Chapter I et votre serveur est resté en Update 6. Les deux doivent avoir exactement la même version du protocole : mettez le serveur à jour.

Mes mods fonctionnent-ils encore avec l'Update 7 ?

Pas forcément. Une grande partie de l'API utilisée par les mods a changé. Seuls les mods recompilés par leur auteur pour Chapter I sont sûrs.

Faut-il refaire l'authentification après la mise à jour ?

En principe non, car les fichiers d'authentification restent dans le dossier Server/. Si le serveur vous le demande, relancez /auth login device : depuis Chapter I, la commande fonctionne même quand une session est déjà active.

Comment connaître la version de mon serveur ?

Tapez /update status dans la console. Pour la dernière version disponible, utilisez /update check ou ./hytale-downloader -print-version.