How To Add Mods To Your Terraria Server (Using tModLoader)

If you've played Terraria before, mods are a great way to change up the game experience and add cool new features that can help you enjoy the game even longer. tModLoader is our recommended Terraria-modding software since it works for both your client and server, which makes getting started simpler and faster.

# Installing tModLoader on Your Computer

While tModLoader is a software designed for Terraria, it installs to your computer as a separate game. This means it will appear separately from Terraria in your Steam library.

1. Navigate to tModLoader's Steam Store page.
2. Download tModLoader onto your computer through Steam, following the prompts.

Once tModLoader is installed, you will need to open Terraria through tModLoader to play modded Terraria.

# Installing Mods via tModLoader

Compared to many other games, modding Terraria has fewer steps. You can install mods directly through the in-game mod browser, rather than downloading external files.

1. Launch tModLoader from your Steam library.
2. Under Workshop in the main menu, select Download Mods.
3. Either browse through the mods or search for specific mods using the search bar in the top-right.
4. When you have located a mod you wish to use, select the Download With Dependencies option. This ensures the mod downloads its required files.
5. Install additional mods as you see fit. Once you are done selecting mods, return to the Workshop Hub and select Manage Mods.
6. Enable All of your mods.
7. Restart tModLoader.

We strongly recommend creating a new single-player world with your new mods before moving to the next stage to ensure your mods work together. If a single-player world doesn't load with these mods, you will need to disable them to determine which mod(s) are causing the problem.

# Installing tModLoader onto Your Server

Just as your computer needs to have tModLoader to run Terraria mods, so does your server. Luckily, installing tModLoader on our servers is as easy as the click of a button!

1. Access your Control Panel and Stop the server.
2. Click on your current server type at the top of the control panel.

If you wish to create a new instance, you can follow this guide.

3. In the Server Type menu, select tModLoader and click Next Step.
4. Select the latest version and click Next Step.
5. Click on Save Changes and Start your server. Let your server fully boot once to ensure the correct files are generated. Once done, press Stop again before proceeding.

# Adding Mods to Your Server

1. Return to the Workshop Hub in tModLoader and select Manage Mods.
2. Scroll through your mod list and write down all of the mod names in a Notepad file.
3. Open a new tab and search for your mods' tModLoader Workshop pages. Copy their mod IDs and paste them next to their corresponding names in the Notepad file.
4. Access your Control Panel and navigate to the Config tab.
5. Locate the Workshop Mod IDs setting and enter your mods' IDs. Once you are done, click Save.

To add a new ID, simply click on Add +.

6. On your desktop - Navigate to \Documents\My Games\Terraria\tModLoader\Mods, this folder should contain a file named enabled.json.
7. Navigate to the Files tab on your Terraria server and upload the enabled.json file to the /mods folder.
8. Start your server.

Depending on the mods you uploaded to your server, you may need a new world to get the most out of them. If you haven't done this before, we have covered it for you with our guide on How to Reset Your Terraria Server World.