Ce guide couvre l'installation et la gestion des mods sur votre serveur Terraria à l'aide de tModLoader, y compris le passage à tModLoader, le téléversement de fichiers .tmod et la configuration de votre liste de mods. Pour la configuration de base du serveur et la connexion, consultez le Guide de configuration du serveur Terraria.
Qu'est-ce que tModLoader ?
tModLoader est une plateforme de modding qui fonctionne comme un exécutable séparé aux côtés de (ou à la place de) Terraria vanilla. Legion Hosting prend en charge tModLoader en tant que version de serveur sélectionnable. Lorsque tModLoader est actif, vous installez et exécutez les mods depuis le répertoire mods/.
Passer à tModLoader
- Connectez-vous à GPanel.
- Arrêtez votre serveur.
- Accédez à la section Démarrage ou Configuration.
- Changez la version du serveur ou l'exécutable pour tModLoader.
- Enregistrez le paramètre et redémarrez le serveur.
.wld), mais les mondes tModLoader peuvent contenir du contenu moddé intégré. Charger un monde tModLoader dans Terraria vanilla (ou inversement) peut entraîner une perte ou une corruption de données. Conservez des fichiers de monde séparés pour chacun.
Revenir à la version Vanilla
Pour revenir à Terraria vanilla, répétez les étapes ci-dessus et sélectionnez la version standard du serveur Terraria. Aucun fichier de monde n'est supprimé lors du changement, mais assurez-vous que serverconfig.txt pointe vers un monde compatible avec la version vanilla.
Installation des mods
Les mods pour tModLoader utilisent le format de fichier .tmod et sont placés dans le répertoire mods/ de votre serveur. Le serveur doit exécuter tModLoader pour que les mods se chargent.
Méthode 1 : Téléverser directement les fichiers .tmod
- Téléchargez le fichier
.tmoddu mod depuis le Steam Workshop ou le navigateur tModLoader. - Connectez-vous à votre serveur via SFTP — consultez Comment téléverser des fichiers via SFTP.
- Téléversez le fichier
.tmoddans le répertoiremods/. - Redémarrez le serveur. tModLoader chargera tous les fichiers
.tmodtrouvés dans le répertoiremods/au démarrage.
Méthode 2 : Mods du Workshop (enabled.json)
tModLoader prend également en charge un fichier enabled.json dans le répertoire mods/ qui liste les mods devant être actifs. Ce fichier est géré automatiquement lors de l'utilisation du navigateur de mods intégré de tModLoader, mais vous pouvez aussi le modifier manuellement.
{
"EnabledMods": [
"ModName1",
"ModName2"
]
}
enabled.json correspond au nom interne du mod, pas au nom d'affichage. Vérifiez la page du mod ou le nom de fichier .tmod pour connaître le nom interne exact.
Vérifier que les mods sont chargés
Après le redémarrage, consultez le journal de la console de votre serveur dans GPanel. tModLoader liste chaque mod chargé lors du démarrage. Si un mod ne parvient pas à se charger, un message d'erreur apparaîtra dans le journal indiquant la cause (incompatibilité de version, dépendance manquante, etc.).
Supprimer ou désactiver des mods
Pour supprimer complètement un mod, supprimez son fichier .tmod du répertoire mods/ via SFTP ou le gestionnaire de fichiers de GPanel, puis redémarrez le serveur.
Pour désactiver un mod sans le supprimer, modifiez mods/enabled.json et retirez le nom interne du mod du tableau EnabledMods. Le fichier .tmod restera sur le disque mais ne sera pas chargé au prochain redémarrage.
Référence des fichiers
| Chemin | Contenu |
|---|---|
mods/ |
Fichiers de mods tModLoader (format .tmod) |
mods/enabled.json |
Liste des noms internes des mods activés |
Articles associés
- Guide de configuration du serveur Terraria — Configuration du serveur, création du monde et connexion
- Dépannage Terraria — Problèmes courants et solutions
- Comment téléverser des fichiers via SFTP
