En tant qu’administrateur de serveur Hytale, maintenir votre installation à jour est une tâche essentielle pour garantir la meilleure expérience de jeu à votre communauté.
Sommaire
Les mises à jour de serveur apportent des nouvelles fonctionnalités, des correctifs de bugs importants et des améliorations de sécurité cruciales.
Ce guide, vous expliquera comment utiliser le Hytale Downloader CLI (Command Line Interface), l’outil officiel recommandé pour les serveurs dédiés, afin de simplifier ce processus.
Prérequis Essentiels
Avant de commencer la procédure de mise à jour, assurez-vous de disposer des éléments suivants :
- Java 25 (ou version ultérieure) : Le Hytale Downloader CLI nécessite Java 25 pour fonctionner correctement. Vérifiez votre version avec
java --version. - Accès à la ligne de commande : Un terminal (Linux/macOS) ou une invite de commande (Windows) avec les connaissances de base pour naviguer et exécuter des scripts.
- Permissions : Des droits suffisants pour télécharger, exécuter des fichiers et manipuler le répertoire de votre serveur.
Étape 1 : Téléchargement et Configuration du Hytale Downloader CLI
La première étape consiste à obtenir et à configurer l’outil Hytale Downloader.
Installation Initiale
- Téléchargez le Downloader :
Obtenez la dernière version de l’outil Hytale Downloader CLI depuis le site officiel de Hytale. Le fichier sera généralement unhytale-downloader.zip. - Extrayez l’archive :
Décompressez le fichierhytale-downloader.zipdans un répertoire dédié sur votre machine ou serveur Hytale (par exemple, un dossierhytale-tools). - Accorder les permissions (Linux/macOS) :
Si vous êtes sur Linux ou macOS, rendez le fichier exécutable avec la commande suivante (adaptez le nom du fichier si nécessaire) :chmod +x hytale-downloader-linux-amd64
Authentification (OAuth 2.0)
La première utilisation du Hytale Downloader CLI requiert une authentification OAuth 2.0. Cette étape sécurise l’accès aux fichiers de serveur mis à jour en liant l’outil à votre compte Hytale.
- Lancez l’authentification : Exécutez le downloader une première fois dans votre terminal. Il affichera un message similaire à ceci :
================== DEVICE AUTHORIZATION==================Visit: https://accounts.hytale.com/deviceEnter code: ABCD-1234 Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234==================Waiting for authorization (expires in 900 seconds)... - Autorisez l’accès :
Ouvrez l’URL fournie dans votre navigateur web, connectez-vous à votre compte Hytale et saisissez le code affiché dans votre terminal (ABCD-1234). - Confirmation :
Une fois l’autorisation réussie dans votre navigateur, le terminal confirmera :
Authentication successful! Mode: OAUTH_DEVICE.
Votre downloader est maintenant prêt à l’emploi. Il mémorisera vos identifiants pour les futures mises à jour automatiques.
Étape 2 : Lancer la Mise à Jour de Votre Serveur Hytale
Avec le Downloader CLI configuré et authentifié, la mise à jour de votre serveur est simple et directe.
Télécharger les Fichiers du Serveur
- Naviguez vers le répertoire du downloader :
Placez-vous dans le dossier où vous avez extraithytale-downloader.zip. - Exécutez la commande de téléchargement :
./hytale-downloader
L’outil va automatiquement télécharger la dernière version du serveur sous forme d’une archive compressée (par exemple,2026.01.13-50e69c385.zip).
Cette archive contient les fichiers du serveur mis à jour et le fichierAssets.zip.
Extraction et Remplacement des Fichiers
Une fois le téléchargement terminé :
- Extrayez l’archive :
Décompressez le contenu de l’archive téléchargée (par exemple,2026.01.13-50e69c385.zip) directement dans votre répertoire racine de serveur Hytale. - Remplacez les fichiers existants :
Assurez-vous que l’extraction écrase les anciens dossiersServer/et le fichierAssets.zip.
C’est ainsi que l’ancien serveur est mis à jour avec les nouvelles versions.
Utilisation du Répertoire de Cache
Le Downloader Hytale est intelligent : il utilise un répertoire de cache (.cache/) pour stocker les JAR de serveur déjà téléchargés. Cela permet d’éviter les téléchargements redondants et d’accélérer le processus si vous avez déjà téléchargé une version spécifique.
Options Avancées du Downloader CLI
Le Downloader CLI offre plusieurs commandes utiles pour une gestion plus fine de vos mises à jour de serveur.
- Vérifier la Version du Serveur sans Télécharger :
./hytale-downloader -print-version
Cette commande affichera la version de mise à jour disponible sans lancer le téléchargement. - Vérifier la Mise à Jour du Downloader lui-même :
./hytale-downloader -check-update
Utilisez cette commande pour vérifier si l’outil Hytale Downloader lui-même a besoin d’être mis à jour. - Accéder aux Versions Pré-Release :
Pour les développeurs ou ceux qui souhaitent tester les versions pré-release (versions expérimentales avec des fonctionnalités à venir), utilisez le paramètre-patchline:./hytale-downloader -patchline pre-release
Gardez à l’esprit que les builds pré-release peuvent être instables et introduire des bugs.
Bonnes Pratiques et Automatisation
Pour une gestion de serveur Hytale fluide et professionnelle, il est essentiel d’adopter de bonnes pratiques, surtout en ce qui concerne les mises à jour de serveur.
L’Importance Cruciale des Sauvegardes
Avant d’appliquer toute mise à jour logicielle côté serveur, surtout pour un événement de mise à jour de serveur majeur, effectuez toujours une sauvegarde complète de votre répertoire de serveur, y compris vos mondes, configurations et plugins. Cela vous permettra de restaurer votre serveur en cas de problème.
Automatisation via Script
Pour les serveurs de production, l’automatisation de la mise à jour du serveur est fortement recommandée. Un simple script peut gérer l’arrêt gracieux du serveur, la sauvegarde, la mise à jour et le redémarrage.
Voici un exemple de script Bash :
#!/bin/bash
# Chemin vers votre répertoire de serveur Hytale
SERVER_DIR="/home/hytale/server"
DOWNLOADER_PATH="/home/hytale/hytale-tools/hytale-downloader" # Adapter si nécessaire
# --- Étape 1: Arrêter le serveur Hytale de manière gracieuse ---
echo "Arrêt du serveur Hytale..."
# Remplacez ceci par votre commande d'arrêt de serveur (par exemple, via un script systemd ou une commande de console)
# Exemple : screen -S hytale_server -p 0 -X stuff "stop^M"
# Ou si votre serveur est géré par systemd:
# sudo systemctl stop hytale_server.service
sleep 10 # Laisser le temps au serveur de s'arrêter
# --- Étape 2: Créer une Sauvegarde complète ---
echo "Création d'une sauvegarde du répertoire de serveur..."
BACKUP_DIR="/home/hytale/backups/server-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r "$SERVER_DIR" "$BACKUP_DIR"
echo "Sauvegarde terminée : $BACKUP_DIR"
# --- Étape 3: Télécharger et appliquer la mise à jour ---
echo "Lancement du Hytale Downloader pour récupérer les fichiers mis à jour..."
cd "$(dirname "$DOWNLOADER_PATH")" # Naviguer vers le répertoire du downloader
"$DOWNLOADER_PATH" # Exécuter le downloader
# Trouver la dernière archive téléchargée (ajuster le motif si nécessaire)
LATEST_ARCHIVE=$(ls -t *.zip | head -n 1)
if [ -z "$LATEST_ARCHIVE" ]; then
echo "Erreur: Aucune archive de mise à jour trouvée. Annulation."
exit 1
fi
echo "Extraction de l'archive $LATEST_ARCHIVE dans le répertoire du serveur..."
unzip -o "$LATEST_ARCHIVE" -d "$SERVER_DIR" # -o pour écraser les fichiers
echo "Mise à jour des fichiers du serveur terminée."
# --- Étape 4: Redémarrer le serveur Hytale ---
echo "Redémarrage du serveur Hytale..."
cd "$SERVER_DIR"
# Remplacez ceci par votre commande de démarrage de serveur
# Exemple : screen -dmS hytale_server java -jar HytaleServer.jar --assets Assets.zip
# Ou si votre serveur est géré par systemd:
# sudo systemctl start hytale_server.service
echo "Mise à jour et redémarrage du serveur terminés."Dépannage Courant
Rencontrer des problèmes lors d’une mise à jour est frustrant, mais plusieurs solutions existent pour les soucis les plus fréquents.
- Problèmes d’Authentification :
Si le Downloader CLI affiche des erreurs d’authentification, cela peut être dû à un jeton expiré ou à des permissions incorrectes.
Relancez le processus/auth login devicedans la console du Downloader pour obtenir un nouveau jeton.
Assurez-vous également que votre compte Hytale a les droits nécessaires. - Erreurs de Permissions (Linux/macOS) :
Si vous rencontrez des messagesPermission deniedlors de l’exécution du Downloader ou de l’accès aux fichiers, vérifiez les permissions :chmod +x hytale-downloader-linux-amd64 # Rendre le downloader exécutable sudo
chown -R $USER:$USER /chemin/vers/votre/repertoire/serveur # S'assurer que votre utilisateur possède les fichiers - Version Java Incompatible :
Le messageUnsupported class file major version 69indique que votre version de Java est incorrecte.
Le Downloader Hytale et le serveur nécessitent Java 25. Installez la version adéquate et assurez-vous qu’elle est définie comme version par défaut dans votre système.