Comment installer des mods sur un serveur Hytale

Ce guide explique comment installer et gérer des mods sur votre 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 bien plus.

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 grâce à notre panneau de contrôle.

Étape 1 : arrêter votre serveur

Connectez-vous à votre panneau de contrôle Survival Servers
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) :

Dans votre panneau de contrôle, cliquez sur Gestionnaire de fichiers
Accédez au dossier mods
Cliquez sur Upload et sélectionnez vos fichiers de mods

Via FTP :

Connectez-vous à votre serveur avec un client FTP (comme FileZilla)
Vos identifiants FTP se trouvent dans votre panneau de contrôle sous Accès FTP
Accédez au dossier mods
Téléversez vos fichiers de mod (.zip ou .jar)

Étape 3 : démarrez votre serveur

Revenez à votre panneau de contrôle
Cliquez sur Démarrer pour lancer votre serveur
Le serveur chargera automatiquement tous les mods présents dans le dossier mods

Astuce : vérifiez la sortie de la console pour confirmer que vos mods se sont bien chargés.

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

Si vous hébergez Hytale sur votre propre ordinateur ou serveur dédié, suivez ces étapes.

É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

Mods côté serveur et mods côté client

Type de mod	Où installer	Exemples d’utilisation
Côté serveur uniquement	Serveur uniquement - les joueurs n’ont besoin de rien	Outils d’administration, utilitaires serveur, optimisations de performances
Côté client uniquement	Jeu du joueur uniquement	Améliorations visuelles, modifications de l’interface
Les deux requis	Le serveur ET le jeu de chaque joueur	Nouveaux objets, créatures, mécaniques de jeu

Consultez la description du mod pour connaître son type avant de l’installer.

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

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

Voir aussi