How To Install And Configure Mods On Your tModLoader Server

Playing Terraria with mods using tModLoader is an entirely new experience! Whether you are adding massive content overhauls like Calamity or just a few quality-of-life tweaks, getting them onto your server is a breeze once you know how the file system works.

The safest and most reliable way to add mods to your server is to download them on your own computer first, and then transfer those files directly to your MintServers host. Let us get your mods synced up!

Step 1: Install Mods Locally

Before putting mods on the server, we want to generate the mod files on your own game client.

1. Launch tModLoader on your computer.
2. Click on Workshop, then Download Mods.
3. Search for and download all the mods you want to use on your server.
4. Go back and click on Manage Mods. Click Enable All (or manually enable the specific ones you want), then click Reload Mods.
5. Optional but recommended: Go to Settings > Mod Configuration and adjust any specific rules or difficulties for your mods now. Doing this locally generates the config files we need!
6. Close the game completely.

Step 2: Upload Mods to Your Server

Now we need to grab the files your game just generated and upload them to the panel.

1. Log into your MintServers panel and click the Stop button to safely shut down your tModLoader server.
2. Navigate to the Files tab on the left-hand sidebar.
3. Locate the mods folder on your server. It is located right in your main directory. Follow this path:
📁 server (or your main server directory)
📁 mods (Open this folder)
📄 CalamityMod.tmod (Upload your .tmod files here)
4. On your personal computer, open your File Explorer and go to your local tModLoader folder.
   (Windows default: Documents\My Games\Terraria\tModLoader\Mods)
5. Select all the .tmod files for your mods.
6. Upload all of these files directly into the mods folder on your server using the panel's Upload button.

Step 3: Enable Your Mods (enabled.json)

Uploading the mods isn't enough; we have to tell the server to actually turn them on! You can do this by editing a specific file.

1. While still inside your server's mods folder, look for a file called enabled.json. If it isn't there, you can create it using the New File button.
2. Open the file and list the exact names of your mods (without the .tmod part at the end) inside the brackets.
3. Make sure each mod is wrapped in quotation marks and separated by a comma! Here is an example of what it should look like:

[
  "CalamityMod",
  "MagicStorage"
]

4. Click Save Content at the top right of the editor.

Step 4: Uploading Mod Configurations

If you made changes to how the mods behave in Step 1, we need to upload those settings too so your server matches your single-player rules.

1. On your MintServers panel, navigate back to your main server directory and follow this path to find the config folder:
📁 server (or your main server directory)
📁 saves
📁 ModConfigs (Open this folder)
📄 YourModConfig.json (Upload your config files here)
2. On your personal computer, go to your local ModConfigs folder.
   (Windows default: Documents\My Games\Terraria\tModLoader\ModConfigs)
3. Upload any .json files inside your local folder into the server's ModConfigs folder.

Step 5: Start the Server

With all your .tmod files uploaded, your enabled.json updated, and your config files successfully transferred, you are ready to play!

1. Navigate back to the Console tab.
2. Click Start. You will see the console loading up all of your custom content.