tModLoader Server Guide

Last updated: 05/05/20
written by  Nodecraft Staff

Installing tModLoader (Server)

Firstly, ensure that you have installed the base Terraria game using SteamCMD. This can be done from our panel at the File Manager -> One Click Installer. From there, use the One Click Installer to install tModLoader on the server.

Make sure you use the merge method when installing tModLoader.

Adding Mods to your Server

Mods can generally be found on the Terraria forums. Once you've found a set of mods that you want to use, you'll need to upload these to the /.local/share/Terraria/ModLoader/Mods folder on your server. These should be in .tmod format.

Enabling Mods

After uploading the mods, you'll need to enable them for use on the server. This is accomplished by using a enabled.json file.

If the folder that contains the mods does not have an 'enabled.json' file in it when the server is started for the first time, TmodLoader will create the file and add every mod that it can load into the file.

Below are instructions on how to manually create the 'enabled.json' file or to edit the file if you wish to add more mods at a later time

  • Navigate to the following directory on your server: /.local/share/Terraria/ModLoader/Mods

  • Once in the mods folder, click the "create file" button above the file manager window. If you simply with to edit an existing file, select "enabled.json" and click the "edit" button in the file manager.

  • The information in the file needs to be in the format of a JSON array, of the names of the mods that you want to use. The file must begin and end in square brackets. Each mod should have its name in quotes, and if you have more than one line in the file, it must have a comma at the end of each line (except for the last line). When editing a .json format file, the dashboard will alert you if what you have typed does not match the proper syntax. Correct the file until the red alerts disappear.

Below is an example .json file for "enabled.json":

  • These mod names should reflect the name of the .tmod files that you uploaded. Linux is case sensitive, so make sure the file name matches exactly (ie, "tremor" is not the same as "Tremor" in linux)

  • When you are finished editing the file, you must give it a title in the blue box directly above the file manager window (if creating a new file). In this case, you'll want to use enabled.json.

Installing tModLoader (Client)

Download the Tmodloader zip from either the forum post, or the releases page of its GitHub repository .

Once the download is finished, you will have a zip folder. Unzip this folder and copy the contents to where the game is installed. The main terraria.exe will be overwritten by the tModLoader version of the executable (they will both be named "terraria.exe"). If you want to save the vanilla version of the executable, we suggest renaming it or backing up that file. There are more detailed instructions in a README file included in the zipped folder.

Using tModLoader

When Terraria is run for the first time after tModLoader is installed, new options will appear in the main menu.

Use "Mod Browser" to find a list of available mods. There may be a brief delay while a list of mods is generated. Select and install your desired mods. When finished installing mods return to the main menu and select "Mods" option, and select "enable" on each mod you have installed. If you do not enable the mods, they will not take effect when you load the game.

tModLoader will create new folders for both players and worlds, so these folders will both be blank at start. If there were existing players or worlds in the game installation, they will still exist in the original "player" and "worlds" folders and can be copied into the new player and worlds folders created by tModLoader . Players created in the stock version of Terraria will still retain all items and can be used in the modded version. If players used in a modded game are moved to a non-modded version of the game, all the modded content will be removed from their inventories.

Joining Modded Terraria

Players trying to connect to a modded Terraria game will need to have tModLoader installed and select and enable the same mods being used on the server on their own Terraria installations on their home computers.

Can't find answers to your questions?

Feel free to contact our support team for personal and professional help.

Write Articles, Get FREE Servers!

More information coming soon.

Chat blocked!

Nodecraft is an ad-free website! Disable adblock if you have any questions.