Een tModLoader-server maken

Wat tModLoader is, en het addertje met de versie

tModLoader is de standaardmanier om Terraria met mods te spelen op pc: een gratis, aparte app op Steam die Terraria draait met mods uit een eigen Steam Workshop. Een tModLoader-server is hetzelfde idee aan de serverkant: hij laadt de mods, en elke speler verbindt ook met tModLoader.

Twee dingen zorgen vaak voor verwarring:

• Voor multiplayer is het een ander spel. tModLoader-spelers kunnen niet op een vanilla-server, en vanilla-spelers niet op een tModLoader-server. Iedereen in de groep gebruikt tModLoader.
• Het draait op een oudere Terraria. Vanilla Terraria zit op 1.4.5 (de update "Bigger and Boulder" van januari 2026). tModLoader is nog gebaseerd op 1.4.4, en er is nog geen 1.4.5-versie van tModLoader. Een wereld die op 1.4.5 is gespeeld, kan niet in tModLoader worden geopend. Andersom werkt het wel: een tModLoader-wereld kan in vanilla 1.4.5 worden geopend en wordt daarbij geüpgraded.

Wil je dus een gemodde run, begin de wereld dan in tModLoader. Neem je vanilla 1.4.5-wereld niet mee.

Een tModLoader-server thuis opzetten

De snelle manier: hosten vanuit het spel

Installeer tModLoader via Steam (het is gratis, maar je moet Terraria op Steam bezitten), schakel je mods in en kies Multiplayer > Host & Play. Vrienden joinen via Steam. De wereld draait op je pc en stopt zodra je afsluit.

Een dedicated server op Windows of macOS

1. Zorg eerst dat je modlijst in het spel klopt. Abonneer je op de mods in de Workshop en schakel ze in tModLoader in. Ga dan naar Workshop > Mod Packs, kies Save Enabled as New Mod Pack en Open Mod Pack Folder. Je hebt nu install.txt (de Workshop-ID's) en enabled.json (welke mods aan staan).
2. Start de server. Voer in de installatiemap van tModLoader (in Steam: rechtsklik op tModLoader > Manage > Browse local files) start-tModLoaderServer.bat uit op Windows of start-tModLoaderServer.sh op macOS.
3. Beantwoord de vragen: of je Steam wilt gebruiken, welke wereld (of een nieuwe maken), het maximale aantal spelers, de poort (standaard 7777), port forwarding en een wachtwoord.
4. Open de poort. Forward TCP 7777 op je router naar de pc, en vrienden joinen met je publieke IP via Join via IP.

Mods en werelden staan in Documents/My Games/Terraria/tModLoader/: Mods/ bevat de .tmod-bestanden en enabled.json, Worlds/ bevat elke wereld als een .wld plus een .twld-bestand met de moddata. Houd de twee bestanden van een wereld altijd bij elkaar.

Op Linux

tModLoader levert hiervoor eigen tools mee, DedicatedServerUtils genaamd. De documentatie raadt aan de server in Docker te draaien; het alternatief is manage-tModLoaderServer.sh, dat tModLoader installeert (install-tml --github), de Workshop-mods uit je install.txt downloadt (install-mods) en de server start (start). Zet eerst install.txt en enabled.json in tModLoader/Mods/ en je wereld in tModLoader/Worlds/.

Voor de vanilla-onderdelen (de console, serverconfig.txt, port forwarding) zie een Terraria-server maken; tModLoader accepteert dezelfde instellingen.

tModLoader-serverhosting bij HytHost

1. Kies tModLoader bij het bestellen. Kies op Terraria-hosting een pakket en selecteer tModLoader als serversoftware. Voor Calamity of Thorium begin je bij Gold (6 GB).
2. Upload je mods. Zet in de bestandsbeheerder van het GamePanel (of via sFTP) de .tmod-bestanden in de map mods/. Op je pc vind je ze in steamapps/workshop/content/1281930/, één map per Workshop-item.
3. Upload enabled.json naar dezelfde map. Het is een eenvoudige lijst met modnamen, bijvoorbeeld ["CalamityMod","CalamityModMusic"]; elke mod die aan moet, moet erin staan.
4. Herstart de server en lees de console: die toont elke mod terwijl hij laadt, en noemt de mod die faalt als dat gebeurt.
5. Join. Vrienden openen tModLoader, kiezen Join via IP en vullen het adres en de poort uit je panel in. Ontbrekende mods worden bij het joinen van de server gedownload.

Heb je al een gemodde wereld? Upload de .wld en de bijbehorende .twld naar de wereldenmap van de server, of stuur ze naar ons en we migreren ze gratis. Behalve tModLoader zelf is er niets voorgeïnstalleerd, dus de modversies zijn altijd degene die jij hebt gekozen.

Populaire mod-setups en hoeveel RAM ze nodig hebben

Mods bepalen vooral hoeveel geheugen een tModLoader-server nodig heeft. Contentmods voegen items, vijanden, bazen en wereldgeneratie toe, en dat zit allemaal in het geheugen, of iemand het nu gebruikt of niet. tModLoader noch de grote mods publiceren een officieel servergetal, dus de tabel hieronder is ons advies, met wat speling:

Nog twee dingen verhogen het geheugengebruik: de wereldgrootte (een grote wereld neemt ongeveer twee keer zoveel geheugen als een kleine, nog voordat iemand joint) en spelers verspreid over de kaart. Ter vergelijking: een vanilla-server blijft bij een kleine wereld in rust ruim onder 1 GB.

Om te zien welke mods zwaar zijn, zet je Show Mod Memory Estimates aan in de instellingen van tModLoader. Crasht de server met OutOfMemoryException, dan heeft hij meer RAM of minder grote mods nodig: geen enkele instelling lost dat op.

Hoe vrienden de mods krijgen

Vrienden hoeven de modlijst niet met de hand te verzamelen. Als een tModLoader-client joint, vergelijkt hij zijn mods met die van de server (naam, versie en bestand) en downloadt alles wat ontbreekt of afwijkt rechtstreeks van de server, waarna hij herlaadt en verbindt. Mods die de client wel heeft en de server niet, worden voor die sessie uitgeschakeld. Mods die als alleen-server zijn gemarkeerd, worden nooit verstuurd.

Wat elke speler nodig heeft:

• tModLoader zelf, via Steam, op dezelfde tModLoader-versie als de server.
• "Download Mods From Servers" ingeschakeld in de instellingen van tModLoader. Het staat standaard aan; staat het uit, dan weigert de client en toont hij de mods die hij nodig zou hebben.
• Vertrouwen in de server. tModLoader waarschuwt dat mods code kunnen bevatten en alleen gedownload moeten worden van een host die je vertrouwt. Op je eigen server ben jij dat.

Veelvoorkomende tModLoader-serverfouten

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

De tModLoader-versies verschillen, en ze moeten precies overeenkomen. Steam werkt tModLoader bij spelers automatisch bij, dus werk na een nieuwe tModLoader-release ook de server bij. Dezelfde melding verschijnt als je per ongeluk verbindt met een vanilla-server op dezelfde poort.

Een mod ontbreekt of laadt niet

Controleer of de mod in enabled.json staat onder zijn interne naam (niet de weergavenaam), of zijn afhankelijkheden ook geüpload en ingeschakeld zijn, en of het .tmod-bestand de versie is die je vrienden hebben. Het serverlog noemt de mod die faalde.

Geheugen vol

OutOfMemoryException in het log betekent dat de server zonder RAM kwam bij het laden of draaien van de mods. Verwijder een grote mod, gebruik een kleinere wereld of stap over op een groter pakket.

De wereld opent niet

Meestal is het een wereld die op vanilla 1.4.5 is gespeeld, en die kan tModLoader niet openen. Het kan ook een ontbrekend .twld-bestand naast de .wld zijn, of een mod waarvan de wereld afhankelijk is en die niet meer is ingeschakeld.

Het spel start niet na het installeren van een "64 bit"-mod

Het oude Workshop-item "tModLoader 64 bit" is verouderd (de huidige tModLoader is al 64-bit) en als je het installeert, start het spel niet meer. Zeg je abonnement erop op.