tModLoader : installer des mods et Calamity

tModLoader est la plateforme de mods de Terraria : Calamity, Thorium et des milliers de mods du Workshop Steam. C'est une application distincte, gratuite sur Steam pour les possesseurs de Terraria. Sur un serveur tModLoader, chaque joueur doit lancer tModLoader (et non Terraria) avec les mêmes mods que le serveur.

TShock et tModLoader ne se combinent pas

Un serveur tModLoader n'accepte pas les plugins TShock, et un serveur TShock ne charge pas les mods tModLoader. Si votre serveur tourne en vanilla ou en TShock, le passage à tModLoader s'installe via le panel ou sur demande à notre support sur Discord. Faites une sauvegarde avant de changer de mode.

Quelle offre pour un serveur moddé ?

La RAM est le critère principal : chaque mod chargé en consomme.

Contenu	Offre conseillée
Quelques mods légers (qualité de vie, objets)	Hellstone (4 Go)
Calamity, Thorium ou un gros mod de contenu	Hallowed (6 Go)
Gros modpack (plusieurs mods de contenu cumulés)	Zenith (8 Go)

Voir le détail des offres dans Premiers pas.

Comment fonctionnent les mods sur le serveur

Un mod tModLoader est un fichier .tmod. Le serveur charge les mods présents dans son dossier Mods et activés dans le fichier enabled.json de ce même dossier :

Mods/
├── enabled.json
├── CalamityMod.tmod
└── AutreMod.tmod

enabled.json contient la liste des noms internes des mods à activer, qui correspondent en général au nom du fichier .tmod sans l'extension :

[
  "CalamityMod",
  "AutreMod"
]

Où est le dossier Mods ?

Selon l'installation, le dossier Mods se trouve à la racine du serveur ou dans le dossier de données de tModLoader (par exemple .local/share/Terraria/tModLoader/Mods/). Le dossier .local est masqué : activez l'affichage des fichiers cachés dans le gestionnaire de fichiers. Repérez le dossier qui contient déjà enabled.json, ou vérifiez les paramètres de l'onglet Startup.

Installer un mod

1. Récupérer les fichiers .tmod sur votre PC

Le plus simple est de préparer votre liste de mods dans tModLoader sur votre PC :

1. Lancez tModLoader, ouvrez Workshop → Télécharger des mods (Download Mods) et abonnez-vous aux mods voulus
2. Activez-les dans Workshop → Gérer les mods (Manage Mods), puis rechargez les mods et vérifiez que tout fonctionne en solo
3. Récupérez les fichiers .tmod : les mods du Workshop sont téléchargés dans le dossier Workshop de Steam, sous steamapps/workshop/content/1281930/<ID du mod>/ (parfois dans un sous-dossier par version de tModLoader). 1281930 est l'identifiant Steam de tModLoader.
4. Récupérez aussi votre enabled.json, dans le dossier Mods de tModLoader sur votre PC (sous Windows : Documents\My Games\Terraria\tModLoader\Mods\)

2. Les envoyer sur le serveur

1. Arrêtez le serveur depuis la Console du panel
2. Déposez les fichiers .tmod dans le dossier Mods du serveur, via l'onglet Files ou en SFTP (identifiants dans Paramètres → Détails SFTP)
3. Ajoutez le nom de chaque mod dans le enabled.json du serveur (ou remplacez-le par celui de votre PC)
4. Démarrez le serveur et suivez la console : chaque mod chargé y apparaît, ainsi que les éventuelles erreurs

Si l'onglet Startup propose des mods Workshop

Si l'onglet Startup de votre serveur propose un réglage pour installer des mods du Workshop par leur identifiant, vous pouvez l'utiliser à la place de l'envoi manuel. Sinon, ou en cas de doute, utilisez la méthode ci-dessus ou demandez à notre support.

Dépendances

Certains mods ont besoin d'autres mods (bibliothèques) pour fonctionner. S'il en manque un, le serveur refuse de charger le mod et la console indique le nom de la dépendance manquante : installez-la et activez-la de la même façon.

Désactiver ou retirer un mod

Arrêtez le serveur, retirez le nom du mod de enabled.json (et supprimez son .tmod si vous ne voulez plus le garder), puis redémarrez. Retirer un mod de contenu d'un monde existant peut faire disparaître ses objets, blocs et PNJ : sauvegardez avant.

Installer Calamity

Calamity est l'un des mods de contenu les plus populaires : nouveaux boss, biomes, objets et modes de difficulté.

1. Vérifiez que votre offre dispose d'assez de RAM : Hallowed (6 Go) est conseillée
2. Récupérez CalamityMod.tmod comme expliqué ci-dessus et ajoutez CalamityMod dans enabled.json
3. Les mods de musique de Calamity (par exemple Calamity Mod Music) sont facultatifs : ils ajoutent les musiques du mod mais sont volumineux
4. Si Calamity demande d'autres mods, installez-les aussi (la console le signale)

Créez un nouveau monde pour Calamity

Une partie du contenu de Calamity (biomes, structures) est ajoutée à la génération du monde. Pour profiter de tout le mod, démarrez sur un monde neuf créé avec Calamity actif : changez le nom du fichier dans la ligne world de serverconfig.txt (voir Configurer serverconfig.txt).

Synchroniser les mods avec les joueurs

Pour rejoindre un serveur tModLoader, chaque joueur doit avoir :

• tModLoader installé, dans une version compatible avec celle du serveur (même branche : la version stable de Steam, sauf si le serveur utilise une version bêta)
• les mêmes mods, dans les mêmes versions que le serveur, pour tous les mods qui agissent des deux côtés

En pratique :

1. Chaque joueur lance tModLoader, puis Multijoueur → Rejoindre via IP, avec l'IP et le port affichés dans le panel
2. S'il lui manque des mods, tModLoader propose généralement de les télécharger à la connexion, puis de recharger les mods
3. En cas d'échec, le joueur s'abonne aux mêmes mods sur le Workshop, les active et relance la connexion

Mises à jour des mods

Côté joueurs, Steam met à jour automatiquement les mods du Workshop. Côté serveur, les fichiers .tmod restent dans la version que vous avez envoyée. Après une mise à jour d'un mod (surtout Calamity), mettez aussi à jour le .tmod du serveur, sinon la connexion est refusée pour version différente. Sauvegardez le monde avant.

Les mods uniquement côté client (interface, cartes, textures, musique…) n'ont pas besoin d'être installés sur le serveur : chaque joueur peut les ajouter librement. La page Workshop du mod l'indique en général.

Mondes tModLoader

Un monde tModLoader est composé de deux fichiers : le .wld (le monde) et le .twld (les données des mods). Gardez-les toujours ensemble, pour les sauvegardes comme pour un import : voir Importer un monde et sauvegardes.

Voir aussi

• Configurer serverconfig.txt
• Importer un monde et sauvegardes
• Dépannage