Retour à tous les guides
Terrariamodstmodloadersteam-workshopcalamity

Comment installer des mods sur un serveur Terraria (tModLoader)

Passez votre serveur Terraria sous tModLoader et ajoutez des mods du Steam Workshop comme Calamity : le serveur les télécharge, les met à jour et les active à chaque redémarrage.

Comment installer des mods sur un serveur Terraria (tModLoader)

Les mods Terraria tournent sur tModLoader, le chargeur de mods officiel de Terraria. Il est gratuit sur Steam pour tous ceux qui possèdent Terraria, et presque tous les mods — Calamity, Thorium, Magic Storage et des milliers d'autres — sont publiés sur son Steam Workshop.

Sur un serveur Lobby Maker, vous n'avez aucun fichier de mod à envoyer. Vous passez le serveur sous tModLoader une fois, vous listez les mods voulus dans un fichier et vous redémarrez : le serveur télécharge chaque mod depuis le Steam Workshop, les tient à jour et les active tout seul.

Faites d'abord une sauvegarde (onglet Backups). Changer le type de serveur réinstalle ses fichiers, et une sauvegarde se restaure en quelques secondes.

1. Passer le serveur sous tModLoader

  1. Ouvrez votre serveur dans le panneau (Mes serveurs de jeu → Panneau du serveur).
  2. Allez dans l'onglet Startup et choisissez tModLoader dans Server Type.
  3. Confirmez la réinstallation et attendez qu'elle se termine.
  4. Démarrez le serveur depuis l'onglet Console.

Vos réglages restent : tModLoader garde le nom du monde, sa taille, sa difficulté, le mot de passe et la limite de joueurs de l'onglet Startup, et enregistre la partie moddée d'un monde dans un fichier .twld à côté.

tModLoader tourne sur Terraria 1.4.4, une mise à jour derrière Terraria Vanilla (1.4.5), et ne peut pas ouvrir un monde enregistré par la 1.4.5. Si votre monde est dans ce cas, le serveur n'y touche pas et lance un monde moddé à part, du même nom avec -tmodloader à la fin (world-tmodloader). Repassez sous Terraria Vanilla et votre ancien monde est toujours là.

2. Trouver les mods voulus

Parcourez le Steam Workshop de tModLoader. L'adresse de chaque mod se termine par son Workshop ID : dans https://steamcommunity.com/sharedfiles/filedetails/?id=2824688072 (Calamity Mod), c'est 2824688072.

Sur la page de chaque mod, vérifiez deux choses :

  • Required items — les autres mods dont il a besoin. Ajoutez-les aussi.
  • L'étiquette Both, Server ou Client — où le mod tourne. Les mods étiquetés Client ne changent que ce que voit un joueur (un autre curseur, une retouche d'interface) : chaque joueur les installe lui-même, le serveur n'en a pas besoin.

3. Ajouter les mods

  1. Allez dans l'onglet Files et ouvrez mods/install.txt, ou cliquez sur Open mod list dans l'onglet Mods.
  2. Ajoutez un mod par ligne — son Workshop ID ou le lien Workshop complet :
2824688072
https://steamcommunity.com/sharedfiles/filedetails/?id=2563309347
  1. Cliquez sur Save Content, puis sur Restart dans l'onglet Console.

Vous pouvez modifier la liste pendant que le serveur tourne : il ne la lit qu'au démarrage. Au démarrage, la console montre chaque étape : le téléchargement des mods depuis le Steam Workshop, Enabled CalamityMod (Workshop 2824688072) pour chaque nouveau mod et la liste des mods actifs. Le premier démarrage avec un gros mod prend quelques minutes — Calamity seul pèse environ 400 Mo.

Tout ce qui suit un # est un commentaire. Servez-vous-en pour noter à quoi correspond chaque ID : 2824688072 # Calamity.

4. Rejoindre le serveur

Chaque joueur a besoin de tModLoader depuis Steam, sur la branche par défaut (stable). Les joueurs lancent tModLoader au lieu de Terraria et se connectent via Multiplayer → Join via IP, comme décrit dans Comment rejoindre un serveur Terraria.

S'il manque un mod à un joueur, tModLoader propose de télécharger les mods du serveur à la connexion. Si ce n'est pas le cas, vérifiez que Download Mods From Servers est activé dans les Settings de tModLoader, ou abonnez-vous aux mods sur le Workshop.

Retirer, désactiver et mettre à jour des mods

  • Retirer ou désactiver un mod : supprimez sa ligne de mods/install.txt, ou mettez un # devant, et redémarrez. Le serveur désactive le mod et supprime son téléchargement ; si vous remettez la ligne, il est téléchargé à nouveau.
  • La liste fait office d'interrupteur : chaque mod de mods/install.txt est activé à chaque démarrage, même si tModLoader l'a désactivé après une erreur. Inutile de modifier mods/enabled.json pour les mods du Workshop.
  • Mises à jour : chaque redémarrage met les mods à jour vers leur dernière version sur le Workshop. tModLoader lui-même se met aussi à jour au redémarrage, tant que tModLoader Version dans l'onglet Startup vaut latest — le serveur reste ainsi sur la même version que les joueurs qui reçoivent tModLoader par Steam.

Vous pouvez aussi envoyer vos propres fichiers .tmod dans le dossier mods. Ajoutez le nom du fichier sans .tmod dans mods/enabled.json pour l'activer.

Problèmes courants

« Workshop item … has no tModLoader mod in it » dans la console. L'ID correspond à autre chose, ou le téléchargement a échoué. Vérifiez l'ID sur la page du Workshop et redémarrez.

« Missing mod: SerousCommonLib required by MagicStorage » dans la console. Un de vos mods a besoin d'un autre, donc tModLoader l'a désactivé et a démarré sans lui. Trouvez le mod manquant dans Required items sur la page Workshop du mod, ajoutez son ID dans mods/install.txt et redémarrez.

Les joueurs ne peuvent pas se connecter : « version mismatch » ou une liste de mods différents. Redémarrez le serveur pour qu'il mette à jour tModLoader et les mods, et demandez aux joueurs de relancer tModLoader pour que Steam mette le leur à jour. Les deux côtés doivent avoir les mêmes versions.

Le serveur est lent ou manque de mémoire. Les gros mods demandent de la RAM : prévoyez au moins 4 Go pour Calamity ou une grosse liste de mods, et davantage pour un grand monde avec beaucoup de joueurs.

Foire aux questions

Puis-je revenir à Terraria sans mods ? Oui : choisissez Terraria Vanilla dans Server Type de l'onglet Startup. Un monde joué avec tModLoader se chargera sans les parties moddées, alors faites une sauvegarde avant de changer. Un monde vanilla que tModLoader n'a pas pu ouvrir est toujours là, intact.

Le serveur a-t-il besoin d'un compte Steam ? Non. Le serveur télécharge les mods du Workshop de façon anonyme.

Puis-je utiliser des mods de CurseForge ? Téléchargez le fichier .tmod, envoyez-le dans le dossier mods et ajoutez son nom dans mods/enabled.json. Les mods du Workshop sont plus simples : ils se mettent à jour tout seuls.

Pas encore de serveur ? Louez un serveur Terraria sur Lobby Maker — il est prêt en une minute environ et passe sous tModLoader en deux clics.