TModLoader

tModLoader (tML) is a free modding tool that is developed by the tML team and released by them as a standalone program, and can also be obtained on Steam as Terraria DLC. It can be used to download mods from their database, called the Mod Browser, receive updates to mods if there are any, or upload one's own mods to the Mod Browser. The official wiki, with information about creating mods and using tModLoader, can be found on GitHub.

TModLoader supports Terraria, however it may take some time for the mods to update. It is recommended to use tML with the latest Terraria version installed.

TML has a discord server at https://discord.gg/tmodloader.

While tModLoader is endorsed by Re-Logic, none of the mods downloadable via it are officially endorsed, and thus should be treated the same as any other third-party software.

Running 1.3
This is version 0.11.8.9, based on Terraria 1.3.5.3. Many mods are still using this version.


 * Right click on  in your Steam library.
 * Select
 * Select.
 * Select  in the drop-down menu on top.
 * Close the window.

Installing the latest tModLoader

 * Install tModLoader
 * Steam version of Terraria: install tML from https://store.steampowered.com/app/1281930/tModLoader/.
 * GOG version of Terraria, or if Steam Family Share is not working: (see here for more info)
 * Go to the releases page and download the tML release.
 * Unzip the contents of the zip to a folder named  either next to or nested inside the Terraria install folder.
 * If the folder contains a  folder, bring the contents up one level.
 * GoG users will need to install Steam (the Mod Browser uses some of the Steam install files to facilitate accessing the Steam Workshop). You should not need an account/be logged in for this to work.
 * Fresh install of Terraria game files:
 * Steam: Delete the  folder in.
 * Non-Windows or have Steam installed elsewhere: Get to the  folder (see here for the default directory), then just go back one folder to end up in the common folder mentioned earlier. Delete the   folder.
 * Uninstall, then reinstall Terraria in Steam.
 * Fresh install of tModLoader files:
 * Steam: Delete the  folder in.
 * To find your install directory on Steam - right click  in the library, then hover over   and click on.
 * Non-Windows computer: Delete the  folder (see here for the default directory).
 * Uninstall, then reinstall tModLoader in Steam.


 * Note: Your player and world saves are stored in a completely separate folder than the ones mentioned above (see below).

1.4 launch errors

 * Windows 64 bit Users
 * If you are for whatever reason finding  is not installing, such as internet problems/blocks, download the   runtime.
 * Place this .zip in the  folder, in your install location.
 * Extract it, don't change the name - we want.


 * Steam Linux Users
 * Game isn't Launching? Read about the bug and workaround in comments here: https://github.com/tModLoader/tModLoader/issues/2140


 * The directX package from Microsoft for d3dcompiler_47 is missing
 * https://support.microsoft.com/en-us/topic/update-for-the-d3dcompiler-47-dll-component-on-windows-server-2012-windows-7-and-windows-server-2008-r2-769c6690-ed30-4dee-8bf8-dfa30e2f8088. You could also update to the latest windows 10 if that's easier.


 * Current 1.4 alpha bugs and issues are can be found on the tModLoader GitHub website
 * https://github.com/tModLoader/tModLoader/issues?q=is%3Aissue+is%3Aopen+label%3A%221.4+alpha+bug%22+sort%3Areactions-%2B1-desc
 * If you are experiencing an issue, please check the listing to see if the issue or bug is already documented. If it is, reacting to the issue with the 👍 reaction will let us know that you are affected by it. If you have more relevant information to add, please add a comment as well. (The listing might be incomplete, as it only shows issues with a specific label, you should also search all issues by clicking  button and then searching for a key word).

Manual Installation
For those not using the Steam version, or who wish to install an older version of tModLoader (this will replace the version currently installed).


 * Go to the releases page and download the tML release you want (for 1.3, the latest is v0.11.8.9).
 * Unzip the contents of the zip to a folder named  (e.g. tModLoader1.3) either next to or nested inside the Terraria install folder.
 * 1.4: If the folder contains a  folder, you will need to remove this intermediate folder and bring the contents up one level.
 * GOG on linux: the nested option inside  is preferred.
 * Mac:
 * 1.3:
 * GOG version of Terraria:
 * Delete the Steam file from the folder you just extracted tModLoader into (these files might already be deleted from the zip you downloaded):
 * Windows:
 * Linux:  and
 * Mac:
 * Steam version of Terraria:
 * If the Steam files are missing from the zip, copy them from your Terraria install to the tModLoader install:
 * Windows:  and
 * Linux:,  ,  , and
 * Mac:  and
 * 1.4 GoG users will need to install Steam (the Mod Browser uses some of the Steam install files to facilitate accessing the Steam Workshop). You should not need an account/be logged in for this to work.
 * 1.4 GoG users will need to install Steam (the Mod Browser uses some of the Steam install files to facilitate accessing the Steam Workshop). You should not need an account/be logged in for this to work.

Installing multiple versions of tModLoader
The Steam version of Terraria and tModLoader allow for downgrading tModLoader (see Running 1.3). There may be times when you wish to have more than one version of tML installed, particularly if you find yourself switching back and forth often between the latest and an earlier version. The following instructions are for those running the Steam version wishing to install an earlier version of tML - other platforms have not been tested. These instructions assume that you have already followed the steps in Installing the latest tModLoader.


 * 1.3:
 * First follow the steps in Running 1.3.
 * Copy all the files from  into   (e.g. tModLoader1.3).
 * In Steam, switch back to the default beta branch on tModLoader.
 * Other tML versions (and manual 1.3 install):
 * Go to the releases page and download the earlier tML release.
 * Unzip the contents of the zip to the folder  (e.g. tModLoader1.3) either next to or nested inside the Terraria install folder.
 * Click on the  menu and click.
 * Click ... and navigate to the   folder.
 * Click on, click  , then click.
 * Finally, right click on the 2nd tModLoader entry in your library and click, then change "tModLoader" to "tModLoader 1.3" and close the window.
 * It may be possible to use these steps on other platforms (needs testing):
 * Go to the releases page and download the earlier tML release.
 * Unzip the contents of the zip to a folder named  (e.g. tModLoader1.3) either next to or nested inside the Terraria install folder.
 * Make a desktop shortcut  for   found in the   directory.

File locations
Here are some useful default paths.

Saves

 * Windows:  (This is typically found in C:\Documents\)
 * 1.3:
 * Linux:
 * Mac:

Installs

 * Steam:
 * GOG:
 * Linux:  or
 * Mac:

Others

 * Mod Path: Your manually installed mods are stored in a subfolder of the  folder called.
 * Workshop mods are stored in, but you shouldn't touch the folder and instead unsubscribe in Steam.
 * Logs Path: The Logs are found in a subfolder of the  folder called.

Useful links

 * How to switch back to 1.3 Legacy tModLoader: https://gfycat.com/ConsiderateClutteredBorer
 * Downgrade to older 1.4: https://github.com/tModLoader/tModLoader/wiki/tModLoader-guide-for-players#downgrade-tmodloader
 * Migrate mods: https://github.com/tModLoader/tModLoader/wiki/tModLoader-guide-for-players#migrate-everything-from-13-to-14
 * Dual install 1.3 and 1.4: https://github.com/tModLoader/tModLoader/wiki/tModLoader-guide-for-players#dual-install---have-13-and-14-tmodloader-installed-at-the-same-time
 * If you accidentally loaded a cloud player or world on 1.4 and can't load it on 1.3 anymore: https://github.com/tModLoader/tModLoader/wiki/Basic-tModLoader-Usage-Guide#world-and-player-backups
 * Old Versions of tModLoader: Note Some Mods may stop working as they update. https://github.com/tModLoader/tModLoader/releases

Items
tModLoader adds some assorted items, though none of them particularly impact the game.


 * The Unloaded Item.png / Unloaded Item (1.4 Alpha).png Unloaded Item, which is used to store data for modded items that no longer have their mod present or have since been removed from their respective mods.
 * The Terrarian.png April Fools Joke, which appears to be a Terrarian but actually can be used to inflict the Wet, Lovestruck, Stinky and Slime debuffs upon the player.
 * The Starting Bag.png Starting Bag, which is used to store excess starter items that would not fit in the player's inventory.
 * Various tModLoader developer items.