Rien n’est plus frustrant pour des joueurs que de perdre des heures de construction ou de progression suite à un crash, une corruption de fichier ou une erreur de manipulation. C’est pourquoi la mise en place d’une stratégie de sauvegarde (backup) robuste est la première responsabilité de tout administrateur.
Dans l’écosystème Hytale, la persistance des données s’articule autour de deux axes principaux : l’automatisation via les arguments de lancement du serveur et les commandes manuelles en jeu pour forcer l’écriture des données sur le disque.
Configuration des sauvegardes automatiques
La méthode la plus fiable pour sécuriser votre serveur consiste à utiliser les outils natifs fournis directement dans le processus de démarrage du serveur (le fichier .jar). Ces options permettent de créer des copies de sécurité sans intervention humaine.
Lors du lancement de votre serveur vous pouvez ajouter des arguments spécifiques pour activer ce système. Le système de fichiers d’Hytale, et particulièrement le dossier universe/ qui contient toutes les données des mondes et des joueurs, sera alors copié périodiquement.
Voici les arguments clés à connaître :
--backup: C’est l’argument principal. S’il est présent, le système de sauvegarde automatique est activé.--backup-directory <Chemin>: Par défaut, les sauvegardes se placent dans un dossier relatif au serveur. Cet argument vous permet de spécifier un emplacement différent (par exemple, un disque dur externe ou un dossier synchronisé dans le cloud).--backup-frequency <Entier>: Définit l’intervalle en minutes entre deux sauvegardes automatiques. La valeur par défaut est généralement de 30 minutes, mais cela peut être ajusté selon l’activité de votre serveur.
Une fois configuré, le serveur générera des archives de vos données, vous permettant de revenir en arrière en cas de problème majeur (griefing massif, corruption de chunk, etc.).
La commande /backup
Cette commande permet de déclencher manuellement le processus de backup, idéal avant d’appliquer une mise à jour ou d’installer un nouveau plugin. Pour fonctionner, votre serveur doit avoir été démarré avec --backup-dir.

📋 Fiche Technique
- Description : Déclenche le système de sauvegarde du serveur pour archiver l’état actuel de l’univers.
- Permissions :
hytale.system.command.backup
🛠️ Syntaxe et Utilisation
| Action | Syntaxe | Description | Exemple |
|---|---|---|---|
| Lancer une sauvegarde | /backup | Force le démarrage immédiat d’une procédure de sauvegarde des données mondiales. | /backup |
La commande /world
En tant qu’administrateur connecté au jeu, vous avez également la possibilité d’interagir directement avec l’état de sauvegarde du monde en temps réel. Bien que cela ne crée pas un fichier « archive » compressé comme le système automatique ci-dessus, cette commande est cruciale pour forcer l’écriture des données de la mémoire vive (RAM) vers le disque dur avant une maintenance ou un arrêt.

📋 Fiche Technique
- Description : Permet de gérer, charger, décharger et sauvegarder les mondes du serveur.
- Permissions :
hytale.universe.command.world
🛠️ Syntaxe et Utilisation
| Action | Syntaxe | Description | Exemple |
|---|---|---|---|
| Sauvegarder un monde | /world save [--options] | Force la sauvegarde immédiate de tous les mondes ou d’un monde spécifique sur le disque. | /world save |
| Lister les mondes | /world list | Affiche la liste de tous les mondes actuellement chargés sur le serveur. | /world list |
| Charger un monde | /world load <nom> | Charge manuellement un monde existant depuis les fichiers du serveur. | /world load mon_monde_creatif |
| Définir le monde par défaut | /world setdefault <nom> | Change le monde principal sur lequel les joueurs apparaissent par défaut. | /world setdefault lobby |
Restauration des données
Avoir des sauvegardes est inutile si l’on ne sait pas comment les restaurer. La procédure sur Hytale est standardisée et nécessite d’accéder aux fichiers du serveur.
Si vous devez restaurer une sauvegarde suite à un incident :
- Arrêtez impérativement le serveur. Ne tentez jamais de remplacer des fichiers pendant que le processus Java est en cours, sous peine de corruption irréversible.
- Accédez au dossier racine de votre serveur.
- Localisez le dossier
universe. C’est ici que résident les données actives. - Renommez ce dossier (par exemple
universe_old) par mesure de sécurité. - Récupérez votre archive de sauvegarde (créée via l’argument
--backup), extrayez-la et placez le dossieruniverseextrait à la racine du serveur. - Relancez le serveur.
Il est recommandé de tester régulièrement vos procédures de restauration sur un serveur local pour vous assurer que vos archives sont intègres et fonctionnelles.
