Two ways to add mods to a tModLoader server: uploading .tmod files to the Mods folder and enabling them, and where those files come from in the first place.
tModLoader mods are single files with a .tmod extension. Your server keeps them in a folder called Mods, and a small text file called enabled.json decides which of them actually load. Once you understand those two things, installing mods is straightforward.
Where .tmod files come from
The easiest way to collect mods is through your own tModLoader client:
- Launch tModLoader and open Workshop, then Download Mods to open the in-game Mod Browser.
- Download each mod you want on the server.
- Open the Workshop menu and use Open Mods Folder, or browse to Documents/My Games/Terraria/tModLoader/Mods on your computer, to find the .tmod files.
Each file is named after the mod's internal name, for example CalamityMod.tmod.
Upload the mods to your server
- Take a snapshot first on the Backups tab. Restoring overwrites current files, so a backup means you can undo a bad mod cleanly.
- Open the Files tab and go into the server's Mods folder. If it does not exist yet, start the server once so tModLoader creates it, or create the folder yourself.
- Upload your .tmod files into that folder. You can drag them into the Files tab, or use SFTP (a secure way to move files between your computer and your server) with the free client FileZilla. The SFTP host, port, and username are on the Settings tab.
Enable the mods
Uploading a mod does not turn it on. tModLoader only loads the mods listed in enabled.json.
- In the Mods folder on the Files tab, open enabled.json.
- It is a plain list of the mods' internal names in quotes, for example:
```
[
"CalamityMod",
"ThoriumMod"
]
```
- Add the internal name of each mod you uploaded, exactly as the .tmod file is named but without the .tmod part. Keep the commas and brackets correct.
- Save the file.
- Restart the server from the Console tab and watch the log. tModLoader lists each mod as it loads, so you can confirm they all came up.
Some GuavaHost setups expose mod options on the Startup tab instead. If yours has a field for mods there, you can set them in that field and let the server handle the download on boot, rather than uploading by hand.
Remember the golden rule
Every player has to run the same enabled mods, at the same versions, as the server. After you change the server's mods, tell your players to update and enable the matching list in their own Manage Mods menu, or they will not be able to join.
Troubleshooting
- Mod uploaded but not loading: it is probably missing from enabled.json, or the name is misspelled. The name must match the .tmod filename exactly, and it is case sensitive.
- Server crashes on boot after adding a mod: two mods may conflict, or one needs a dependency mod you did not upload. Check the Console log for the mod it names, then remove or add mods to fix it.
- Broken enabled.json: a missing comma or bracket stops the whole list loading. Compare it against the example above.
- Want to undo everything: restore the snapshot you took on the Backups tab.
Still stuck? Jump into our Discord at discord.gg/GuavaHost and the team will help you out.