Comment créer un serveur tModLoader

Ce qu'est tModLoader, et le piège de la version

tModLoader est la façon standard de jouer à Terraria avec des mods sur PC : une application gratuite et séparée sur Steam qui lance Terraria avec des mods issus de son propre Steam Workshop. Un serveur tModLoader, c'est la même idée côté serveur — il charge les mods, et chaque joueur se connecte lui aussi avec tModLoader.

Deux points piègent souvent :

• En multijoueur, c'est un autre jeu. Les joueurs tModLoader ne peuvent pas rejoindre un serveur vanilla, et les joueurs vanilla ne peuvent pas rejoindre un serveur tModLoader. Tout le groupe utilise tModLoader.
• Il tourne sur un Terraria plus ancien. Terraria vanilla est en 1.4.5 (la mise à jour « Bigger and Boulder » de janvier 2026). tModLoader repose encore sur la 1.4.4, et il n'existe pas encore de version 1.4.5 de tModLoader. Un monde joué en 1.4.5 ne peut pas être ouvert dans tModLoader. L'inverse fonctionne : un monde tModLoader peut être ouvert en vanilla 1.4.5, et il est alors mis à niveau.

Donc, si vous voulez une partie moddée, commencez le monde dans tModLoader. N'y emmenez pas votre monde vanilla 1.4.5.

Monter un serveur tModLoader chez soi

La méthode rapide : héberger depuis le jeu

Installez tModLoader depuis Steam (il est gratuit, mais vous devez posséder Terraria sur Steam), activez vos mods, puis choisissez Multiplayer > Host & Play. Vos amis rejoignent via Steam. Le monde tourne sur votre PC et s'arrête quand vous quittez.

Un serveur dédié sous Windows ou macOS

1. Réglez d'abord votre liste de mods dans le jeu. Abonnez-vous aux mods sur le Workshop et activez-les dans tModLoader. Allez ensuite dans Workshop > Mod Packs, choisissez Save Enabled as New Mod Pack puis Open Mod Pack Folder. Vous avez maintenant install.txt (les ID du Workshop) et enabled.json (les mods activés).
2. Lancez le serveur. Dans le dossier d'installation de tModLoader (dans Steam : clic droit sur tModLoader > Manage > Browse local files), exécutez start-tModLoaderServer.bat sous Windows ou start-tModLoaderServer.sh sous macOS.
3. Répondez aux questions : utiliser Steam ou non, quel monde (ou en créer un), nombre maximal de joueurs, le port (7777 par défaut), la redirection de port et un mot de passe.
4. Ouvrez le port. Redirigez TCP 7777 sur votre box vers le PC, et vos amis rejoignent avec votre IP publique via Join via IP.

Les mods et les mondes se trouvent dans Documents/My Games/Terraria/tModLoader/ — Mods/ contient les fichiers .tmod et enabled.json, Worlds/ contient chaque monde sous forme d'un .wld plus un fichier .twld avec les données moddées. Gardez toujours les deux fichiers d'un monde ensemble.

Sous Linux

tModLoader fournit ses propres outils pour cela, appelés DedicatedServerUtils. Leur documentation recommande de faire tourner le serveur dans Docker ; l'alternative est manage-tModLoaderServer.sh, qui installe tModLoader (install-tml --github), télécharge les mods du Workshop listés dans votre install.txt (install-mods) et démarre le serveur (start). Placez d'abord install.txt et enabled.json dans tModLoader/Mods/ et votre monde dans tModLoader/Worlds/.

Pour la partie vanilla — la console, serverconfig.txt, la redirection de port —, voir comment créer un serveur Terraria ; tModLoader accepte les mêmes réglages.

Hébergement de serveur tModLoader chez HytHost

1. Choisissez tModLoader à la commande. Sur l'hébergement Terraria, choisissez une offre et sélectionnez tModLoader comme logiciel serveur. Pour Calamity ou Thorium, partez sur Gold (6 GB).
2. Envoyez vos mods. Dans le gestionnaire de fichiers du GamePanel (ou en sFTP), placez les fichiers .tmod dans le dossier mods/. Sur votre PC, ils se trouvent dans steamapps/workshop/content/1281930/, un dossier par élément du Workshop.
3. Envoyez enabled.json dans le même dossier. C'est une simple liste de noms de mods, par exemple ["CalamityMod","CalamityModMusic"] ; chaque mod à activer doit y figurer.
4. Redémarrez le serveur et lisez la console : elle liste chaque mod au chargement et nomme celui qui échoue, le cas échéant.
5. Rejoignez. Vos amis ouvrent tModLoader, choisissent Join via IP et saisissent l'adresse et le port de votre panel. Les mods manquants se téléchargent depuis le serveur à la connexion.

Vous avez déjà un monde moddé ? Envoyez le .wld et son .twld dans le dossier des mondes du serveur, ou transmettez-les-nous et nous les migrons gratuitement. Rien n'est préinstallé à part tModLoader lui-même, donc les versions des mods sont toujours celles que vous avez choisies.

Configurations de mods populaires et RAM nécessaire

Ce sont surtout les mods qui déterminent la mémoire d'un serveur tModLoader. Les mods de contenu ajoutent des objets, des ennemis, des boss et de la génération de monde, et tout cela reste en mémoire, que quelqu'un l'utilise ou non. Ni tModLoader ni les gros mods ne publient de chiffre officiel côté serveur ; le tableau ci-dessous est donc notre recommandation, avec un peu de marge :

Deux autres facteurs augmentent la mémoire : la taille du monde (un grand monde prend environ deux fois plus de mémoire qu'un petit avant même qu'un joueur se connecte) et les joueurs dispersés sur la carte. À titre de comparaison, un serveur vanilla reste bien en dessous de 1 GB au repos sur un petit monde.

Pour voir lesquels de vos mods sont lourds, activez Show Mod Memory Estimates dans les réglages de tModLoader. Si le serveur plante avec OutOfMemoryException, il lui faut plus de RAM ou moins de gros mods — aucun réglage ne règle le problème.

Comment vos amis récupèrent les mods

Vos amis n'ont pas à rassembler la liste de mods à la main. Quand un client tModLoader se connecte, il compare ses mods à ceux du serveur — nom, version et fichier — et télécharge tout ce qui manque ou diffère directement depuis le serveur, puis recharge et se connecte. Les mods que le client possède mais pas le serveur sont désactivés pour la session. Les mods marqués comme côté serveur uniquement ne sont jamais envoyés.

Ce dont chaque joueur a besoin :

• tModLoader lui-même, depuis Steam, dans la même version que le serveur.
• « Download Mods From Servers » laissé activé dans les réglages de tModLoader. C'est activé par défaut ; si c'est désactivé, le client refuse et liste les mods dont il aurait besoin.
• Confiance dans le serveur. tModLoader prévient que les mods peuvent contenir du code et ne doivent être téléchargés que depuis un hôte de confiance. Sur votre propre serveur, c'est vous.

Erreurs courantes sur un serveur tModLoader

"You are not using the same version as this server"

Les versions de tModLoader diffèrent — elles doivent correspondre exactement. Steam met à jour tModLoader automatiquement chez les joueurs ; après une nouvelle version de tModLoader, mettez donc aussi le serveur à jour. Le même message apparaît si vous vous connectez par erreur à un serveur vanilla sur le même port.

Un mod manque ou ne se charge pas

Vérifiez que le mod figure dans enabled.json sous son nom interne (pas son nom affiché), que ses dépendances sont elles aussi envoyées et activées, et que le fichier .tmod est la version qu'ont vos amis. Le journal du serveur nomme le mod en échec.

Mémoire insuffisante

OutOfMemoryException dans le journal signifie que le serveur a manqué de RAM en chargeant ou en faisant tourner les mods. Retirez un gros mod, utilisez un monde plus petit ou passez à une offre supérieure.

Le monde ne s'ouvre pas

C'est généralement un monde joué en vanilla 1.4.5 — tModLoader ne peut pas l'ouvrir. Il peut aussi s'agir d'un fichier .twld manquant à côté du .wld, ou d'un mod dont dépend le monde et qui n'est plus activé.

Le jeu ne démarre plus après l'installation d'un mod « 64 bit »

L'ancien élément du Workshop "tModLoader 64 bit" est obsolète — tModLoader est déjà en 64 bits — et l'installer empêche le jeu de se lancer. Désabonnez-vous-en.