Comment installer des mods sur un serveur Hytale

Les mods sont des extensions qui modifient ou enrichissent votre serveur avec de nouvelles fonctionnalités, mécaniques de jeu, objets, créatures et plus encore.

Option n°1 : installer des mods sur un serveur Hytale Survival Servers

Si vous louez un serveur Hytale chez Survival Servers, ajouter des mods est facile avec le Command Center.

Pour les mods CurseForge, le plus rapide est Mods sous TOOLS : ajoutez, mettez à jour ou retirez un mod, et il est pris en compte au prochain démarrage de votre serveur.

Étape 1 : arrêter votre serveur

Connectez-vous au Survival Servers Command Center
Cliquez sur le bouton Arrêter pour arrêter votre serveur

Étape 2 : accéder aux fichiers de votre serveur

Vous pouvez téléverser des mods via FTP ou le gestionnaire de fichiers :

Avec le gestionnaire de fichiers (le plus simple) :

Sur la page de votre serveur, sous TOOLS, cliquez sur File Manager
Ouvrez le dossier mods
Cliquez sur Upload > Upload files et sélectionnez vos fichiers de mod

File Manager avec le menu Upload ouvert, proposant Upload files et Upload folder, et le bouton Upload entouré en or.

Upload ouvre un menu avec Upload files et Upload folder.

Via FTP :

Connectez-vous à votre serveur avec un client FTP (comme FileZilla)
Vos identifiants FTP se trouvent sur la page de votre serveur sous FTP Details
Accédez au dossier mods
Téléversez vos fichiers de mod (.zip ou .jar)

Étape 3 : démarrez votre serveur

Revenez sur la page de votre serveur
Cliquez sur Démarrer pour lancer votre serveur
Le serveur chargera automatiquement tous les mods présents dans le dossier mods

Astuce : Ouvrez la Visionneuse de journaux pour vérifier que vos mods se sont chargés. Un mod chargé affiche une ligne comme Loaded pack: BlameJared:ThoriumChests from Thorium-Chests-1.0.4.zip ou Enabled plugin Buuz135:AdvancedItemInfo.

Option n° 2 : installer des mods sur votre propre serveur Hytale

Étape 1 : trouver des mods à télécharger

Téléchargez les mods depuis des sources fiables :

CurseForge - Site d’hébergement de mods populaire
Discord officiel de Hytale - Ressources communautaires et partage de mods

Étape 2 : arrêter votre serveur

Avant d’installer des mods, arrêtez toujours votre serveur au préalable :

Saisissez stop dans la console du serveur, ou
Appuyez sur Ctrl+C dans la fenêtre du terminal

Étape 3 : ajouter les mods dans le dossier Mods

Localisez le dossier mods/ de votre serveur
- Ce dossier se trouve dans le répertoire principal de votre serveur, à côté de HytaleServer.jar
Copiez les fichiers de mods téléchargés dans le dossier mods/
- Les mods sont généralement des fichiers .zip ou .jar
N’extrayez et ne décompressez pas les fichiers de mods : placez-les tels quels

La structure de vos dossiers doit ressembler à ceci :

HytaleServer/
├── HytaleServer.jar
├── Assets.zip
├── config.json
├── mods/
│   ├── CoolMod.jar
│   └── AnotherMod.zip
└── ...

Étape 4 : démarrez votre serveur

Démarrez votre serveur normalement. Il détectera et chargera automatiquement tous les mods présents dans le dossier mods/.

Vérifiez dans la console la présence de :

La confirmation que les mods se sont chargés correctement
Les éventuels messages d’erreur si un mod n’a pas pu se charger

Supprimer des mods

Pour retirer un mod de votre serveur :

Arrêtez votre serveur
Supprimez le fichier du mod du dossier mods/ (via FTP, le gestionnaire de fichiers ou directement)
Démarrez votre serveur

Remarque : certains mods ajoutent des données à votre monde. Retirer le mod peut causer des problèmes si votre monde dépend du contenu de ce mod. Sauvegardez toujours votre monde avant de retirer des mods.

Mise à jour des mods

Pour mettre à jour un mod vers une version plus récente :

Arrêtez votre serveur
Supprimez l’ancien fichier du mod dans mods/
Ajoutez la nouvelle version du mod dans mods/
Démarrez votre serveur

Astuce : Consultez le journal des modifications du mod avant de le mettre à jour pour voir ce qui a changé et s’il existe des instructions de mise à niveau particulières.

Comprendre les types de mods

Plugins et packs d’assets

Type de mod	Fichier	Effet
Plugin	`.jar`	Code Java qui ajoute ou modifie le fonctionnement du jeu
Pack d’assets	`.zip`	Ajoute du contenu comme des blocs, des objets et des modèles

Certains mods sont les deux à la fois. Un .jar peut contenir ses propres assets.

Le navigateur de mods

La mise à jour 6 a ajouté un navigateur de mods au menu principal de Hytale, où vous pouvez parcourir, installer et mettre à jour des mods. Pour ajouter un mod à un serveur, téléversez le fichier du mod dans le dossier mods du serveur comme indiqué ci-dessus.

Compatibilité des versions

Les mods doivent être compatibles avec la version Hytale de votre serveur
Quand Hytale se met à jour, les mods peuvent aussi nécessiter une mise à jour
Vérifiez toujours la compatibilité des versions sur les pages des mods avant de télécharger

Un plugin conçu pour une version plus ancienne de Hytale enregistre un avertissement de ce type au démarrage du serveur :

Plugin 'EineNT:VeinMining' targets server version range '>=0.6.0 <0.7.0' which does not match the running server version '0.7.0'. You may encounter issues, please check for plugin update

La mise à jour 7 (Chapter I: Out of the Breach) a changé la façon dont les plugins gèrent les blocs et les chunks, de nombreux plugins ont donc besoin d’une nouvelle version. Sauvegardez votre monde avant la mise à jour. Voir Comment mettre à jour un serveur Hytale.

Plugins serveur recommandés

Ces plugins sont développés par des partenaires d’hébergement professionnels et ajoutent des fonctionnalités utiles :

Plugin	Effet
Nitrado:WebServer	Ajoute la prise en charge des applications web et de l’API à votre serveur
Nitrado:Query	Affiche l’état du serveur et le nombre de joueurs via HTTP (utile pour les sites web)
Nitrado:PerformanceSaver	Ajuste automatiquement la distance d’affichage en fonction des performances du serveur
ApexHosting:PrometheusExporter	Fournit des métriques détaillées sur le serveur et les performances

Dépannage

Le serveur ne démarre pas après l’ajout d’un mod

Consultez les journaux - Cherchez les messages d’erreur dans le dossier logs/
Retirez le mod - Enlevez le nouveau mod et réessayez de démarrer
Incompatibilité de version - Le mod n’est peut-être pas compatible avec votre version de Hytale
Dépendances manquantes – certains mods ont besoin d’autres mods pour fonctionner

Le mod ne se charge pas

Mauvais emplacement du fichier – vérifiez que le mod se trouve directement dans mods/, et non dans un sous-dossier
Téléchargement corrompu - Retéléchargez le fichier du mod
Mauvais type de fichier – assurez-vous qu’il s’agit d’un fichier .zip ou .jar
Avertissement de version – Le journal indique que le plugin « targets server version range » pour une autre version. Installez la nouvelle version du mod

Voir aussi