tModLoader Server GuideLast updated: 05/05/20
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
mergemethod 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
After uploading the mods, you'll need to enable them for use on the server. This is accomplished by using a
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:
Once in the
modsfolder, 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":
[ "CalamityMod", "chadsfurn" ]
These mod names should reflect the name of the
.tmodfiles 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
Installing tModLoader (Client)
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.
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.