Guide d'installation des mods Barotrauma
Ce guide explique comment installer, gérer et mettre à jour les mods du Steam Workshop sur votre serveur dédié Barotrauma hébergé chez Legion Hosting. Les mods peuvent ajouter des sous-marins, créatures, objets et modifications de gameplay personnalisés à votre serveur.
Table des matières
- Fonctionnement des mods sur les serveurs dédiés
- Installation des mods du Workshop
- Configuration des mods dans serversettings.xml
- Maintenir les mods à jour
- Compatibilité des mods
- Suppression des mods
Fonctionnement des mods sur les serveurs dédiés
Barotrauma prend en charge les mods du Steam Workshop pour du contenu personnalisé incluant des sous-marins, créatures, objets et refontes de gameplay. Sur un serveur dédié, les mods ne sont pas téléchargés automatiquement depuis le Workshop. Vous devez transférer manuellement les fichiers de mods sur votre serveur.
Installation des mods du Workshop
L'approche recommandée pour installer des mods sur votre serveur hébergé est de les télécharger d'abord sur votre PC local, puis de transférer les fichiers sur le serveur.
Installation étape par étape
- Sur votre propre PC, abonnez-vous au mod sur le Steam Workshop et lancez Barotrauma une fois pour le télécharger.
- Localisez le dossier du mod téléchargé sur votre PC. Les mods du Workshop sont généralement stockés dans :
Steam\steamapps\workshop\content\602960\<ModID>\Le
<ModID>est l'identifiant numérique provenant de l'URL du mod sur le Workshop. - Connectez-vous à votre serveur via SFTP ou ouvrez le gestionnaire de fichiers dans GPanel.
- Naviguez vers le répertoire
LocalMods/dans le dossier de votre serveur Barotrauma. Si le répertoire n'existe pas, créez-le. - Téléversez l'intégralité du dossier du mod (celui nommé avec l'identifiant numérique du mod) dans
LocalMods/. - Configurez le mod dans
serversettings.xmlcomme décrit dans la section suivante. - Redémarrez le serveur pour que les modifications prennent effet.
filelist.xml qui identifie le mod. Si ce fichier est manquant, le mod ne sera pas détecté par le serveur.
Configuration des mods dans serversettings.xml
Après avoir téléversé les fichiers de mods, vous devez les enregistrer dans la configuration de votre serveur. Ouvrez serversettings.xml et ajoutez le mod à la liste des paquets de contenu installés.
serversettings.xml. Le serveur écrase ce fichier lors de l'arrêt, donc toute modification effectuée pendant que le serveur est en cours d'exécution sera perdue.
Référez-vous au fichier filelist.xml du mod pour le nom interne correct. Le format exact de configuration dépend de votre version de Barotrauma, mais généralement les mods apparaissent dans les entrées ContentPackage au sein de serversettings.xml.
Vérification du chargement des mods
Après avoir redémarré le serveur avec le mod configuré :
- Ouvrez la console du serveur dans GPanel.
- Recherchez les lignes de log mentionnant le nom ou l'identifiant du mod. Les mods chargés avec succès apparaîtront pendant la séquence de démarrage.
- Si vous voyez des lignes
[ERROR]mentionnant le mod, vérifiez que tous les fichiers ont été téléversés correctement et que le mod est compatible avec la version de votre serveur.
Maintenir les mods à jour
Le serveur ne récupère pas automatiquement les mises à jour du Workshop. Lorsqu'un auteur de mod publie une mise à jour, vous devez manuellement re-télécharger et re-téléverser les fichiers mis à jour.
Processus de mise à jour
- Sur votre PC local, assurez-vous que votre client Steam a téléchargé la dernière version du mod (désabonnez-vous et réabonnez-vous si nécessaire pour forcer un nouveau téléchargement).
- Connectez-vous à votre serveur via SFTP.
- Arrêtez le serveur depuis GPanel.
- Naviguez vers
LocalMods/<ModID>/et remplacez le contenu par les fichiers nouvellement téléchargés. - Démarrez le serveur.
Compatibilité des mods
Les conflits de mods sont l'une des causes les plus courantes de problèmes de serveur. Gardez ces recommandations à l'esprit :
| Problème | Cause | Solution |
|---|---|---|
| Le serveur plante au démarrage | Deux mods modifiant le même contenu de jeu (objets, créatures, etc.) | Désactivez tous les mods, puis réactivez-les un par un pour trouver le conflit |
| Joueurs déconnectés à la connexion | Différence de version de mod entre client et serveur | Assurez-vous que tous les joueurs et le serveur ont les mêmes versions de mods |
| Erreurs de contenu dans le log du serveur | Dépendance manquante ou mod obsolète | Vérifiez la page Workshop du mod pour les dépendances requises et mettez à jour |
| Le mod fonctionne en solo mais pas sur le serveur | Mod uniquement côté client | Vérifiez la description du mod sur le Workshop ; certains mods sont réservés au client et ne doivent pas être installés sur le serveur |
Suppression des mods
- Arrêtez votre serveur depuis GPanel.
- Ouvrez
serversettings.xmlet supprimez l'entrée du paquet de contenu du mod. - Supprimez le dossier du mod depuis
LocalMods/via SFTP ou le gestionnaire de fichiers de GPanel. - Démarrez le serveur.
Articles connexes
- Guide de configuration du serveur dédié Barotrauma
- Guide de dépannage Barotrauma
- Comment transférer des fichiers via SFTP
