Installer tModLoader sur un serveur Terraria : mods Calamity, enabled.json et install.txt

Calamity, Thorium, Magic Storage… Les grands mods de Terraria passent tous par tModLoader, le chargeur de mods communautaire distribué gratuitement sur Steam (App ID 1281930). Pour jouer à plusieurs, il faut un serveur tModLoader, pas un serveur Vanilla ni TShock.

Ce guide suit la documentation officielle de tModLoader : installation du serveur, choix des mods avec un modpack (enabled.json et install.txt), configuration et connexion des joueurs.

Avant de commencer : tModLoader et la 1.4.5

La version stable de tModLoader cible encore Terraria 1.4.4.9, alors que Terraria est en 1.4.5.8. Le portage vers la 1.4.5 est en cours sur une branche bêta 1.4.5-dev, que l’équipe décrit comme non stable pour jouer normalement.

Ce que ça implique pour votre serveur :

• joueurs et serveur lancent tModLoader, pas Terraria ;
• le contenu 1.4.5 (nouveaux objets, crossovers…) n’est pas disponible en moddé tant que le portage n’est pas stable ;
• tModLoader utilise ses propres dossiers de sauvegarde, séparés de ceux de Terraria.

Étape 1 — Préparer la liste de mods (modpack)

Le Workshop Steam identifie les mods par un numéro, pas par leur nom. tModLoader génère donc les fichiers nécessaires à partir d’un modpack :

1. Lancez tModLoader sur votre PC et activez les mods voulus (par exemple Calamity Mod et Calamity Mod Music).
2. Menu principal → Workshop → Mod Packs.
3. Cliquez sur Save Enabled as New Mod Pack.
4. Cliquez sur Open Mod Pack Folder puis ouvrez le dossier portant le nom de votre modpack.

Vous y trouvez deux fichiers :

Exemple pour Calamity :

# install.txt
2824688072
2824688266

["CalamityMod", "CalamityModMusic"]

2824688072 est l’ID Workshop de Calamity Mod, 2824688266 celui de Calamity Mod Music. Utilisez toujours les fichiers générés par votre modpack : ils contiennent aussi les dépendances.

Important : enabled.json doit lister tous les mods à activer, y compris les mods installés manuellement (.tmod). Un mod téléchargé mais absent de enabled.json ne se charge pas.

Étape 2A — Serveur sous Windows

Le plus simple : utiliser l’installation tModLoader de Steam.

1. Dans Steam : clic droit sur tModLoader → Gérer → Parcourir les fichiers locaux.
2. Lancez start-tModLoaderServer.bat.
3. Le script demande si le support Steam doit être activé, charge les mods puis demande quel monde charger (ou en créer un).

Pour démarrer sans questions, créez un .bat à côté du script :

start-tModLoaderServer.bat -nosteam -world "C:\Users\VOUS\Documents\My Games\Terraria\tModLoader\Worlds\MonMonde.wld"

Arguments utiles :

Étape 2B — Serveur sous Linux (script officiel)

tModLoader fournit manage-tModLoaderServer.sh, un script autonome qui installe le serveur et les mods. Il s’appuie sur une structure de dossiers précise :

tModLoader/
├── Mods/
│   ├── enabled.json
│   └── install.txt
├── Worlds/
│   ├── MonMonde.wld
│   └── MonMonde.twld
├── manage-tModLoaderServer.sh
└── serverconfig.txt

Installation :

# SteamCMD doit être installé et accessible dans le PATH
mkdir -p ~/tModLoader/Mods ~/tModLoader/Worlds && cd ~/tModLoader
wget https://raw.githubusercontent.com/tModLoader/tModLoader/stable/patches/tModLoader/Terraria/release_extras/DedicatedServerUtils/manage-tModLoaderServer.sh
chmod +x manage-tModLoaderServer.sh

# Copiez install.txt et enabled.json dans Mods/, puis :
./manage-tModLoaderServer.sh install-tml --username VOTRE_COMPTE_STEAM
./manage-tModLoaderServer.sh install-mods
./manage-tModLoaderServer.sh start

• install-tml télécharge tModLoader (App 1281930) via SteamCMD. Il faut se connecter avec un compte Steam (mot de passe et code 2FA demandés). Variante sans Steam : install-tml --github.
• install-mods télécharge les mods listés dans install.txt, sans compte Steam.
• install enchaîne les deux et sert aussi à mettre à jour tModLoader et les mods.
• ./manage-tModLoaderServer.sh -h liste toutes les options.

Le script lance le serveur avec votre serverconfig.txt, le dossier Workshop téléchargé et le dossier tModLoader/ comme dossier de sauvegarde. Lancez-le dans tmux ou screen pour qu’il tourne en arrière-plan.

Une image Docker officielle existe aussi (docker-compose.yml + Dockerfile dans le dossier DedicatedServerUtils du dépôt tModLoader). L’équipe la recommande pour les serveurs publics.

Étape 3 — Configurer serverconfig.txt

Même format que le serveur Vanilla. Pour un démarrage automatique :

world=/home/terraria/tModLoader/Worlds/MonMonde.wld
autocreate=2
worldname=MonMonde
difficulty=1
maxplayers=8
port=7777
password=MotDePasseSecret
npcstream=4

• world doit pointer vers le fichier .wld (pas .twld).
• autocreate crée le monde s’il n’existe pas (1 = petit, 2 = moyen, 3 = grand).
• worldname ne sert qu’à la création : pour un monde existant, utilisez world.
• npcstream entre 2 et 6 réduit la « téléportation » des ennemis, au prix d’un peu plus de bande passante.
• modpath= et modpack= peuvent aussi être placés dans ce fichier.

Étape 4 — Connexion des joueurs

Les joueurs lancent tModLoader → Multijoueur → Rejoindre via IP.

Bonne nouvelle : tModLoader propose de télécharger automatiquement les mods du serveur qui manquent au joueur, puis recharge les mods. Deux limites :

• le téléchargement depuis le serveur est lent avec de gros mods : il vaut mieux partager votre modpack pour que chacun s’abonne aux mods sur le Workshop ;
• un joueur qui a désactivé le téléchargement automatique dans ses réglages, ou qui n’accepte que les mods signés, devra installer les mods lui-même.

Les versions des mods doivent être identiques côté serveur et côté joueurs. Après une mise à jour de Calamity, relancez install-mods (ou la mise à jour du panel) sur le serveur.

Dépannage rapide

FAQ

Faut-il racheter tModLoader ?

Non. tModLoader est gratuit sur Steam pour les possesseurs de Terraria.

Combien de RAM pour Calamity ?

Comptez 4 Go pour Calamity et quelques mods d’accompagnement. Notre offre Modded est dimensionnée pour ce cas.

Puis-je utiliser mon monde Vanilla 1.4.5 avec tModLoader ?

tModLoader stable tourne sur une base 1.4.4.9 et ses sauvegardes sont séparées de celles de Terraria. Un monde créé ou joué en 1.4.5 n’est pas prévu pour être chargé dans une version antérieure du jeu. Démarrez plutôt un monde neuf pour votre partie moddée.

Puis-je combiner tModLoader et TShock ?

Non, ce sont deux serveurs différents. TShock ne charge pas les mods tModLoader.

Comment transférer mon monde moddé solo sur le serveur ?

Copiez les deux fichiers .wld et .twld dans le dossier Worlds du serveur. Le guide transférer un monde Terraria détaille la procédure.

Pour aller plus loin

• Meilleur hébergeur Terraria 2026 : comment choisir
• Installer un serveur Terraria dédié Vanilla
• Transférer un monde Terraria sur un serveur
• Installer Calamity Mod sur un serveur Terraria
• Combien de RAM pour un serveur Terraria ?

Sources : tModLoader — DedicatedServerUtils README · tModLoader wiki — Starting a modded server · tModLoader wiki — Command Line · tModLoader — 1.4.5 Update Information · Calamity Mod sur le Workshop