From Terraria Wiki
Jump to navigation Jump to search
Desktop versionLegacy tModLoader version
Desktop/Legacy tModLoader-Only Content: This information applies only to the Desktop and Legacy tModLoader versions of Terraria.

tModLoader (TML) is a free program which allows playing Terraria with mods. The built-in Mod Browser facilitates downloading and updating mods, as well as uploading one's own mods. tModLoader is developed by the TML Team and is released by them as a standalone program, although it is also available on Steam as Terraria DLC. The official wiki, with information about creating mods and using tModLoader, can be found on GitHub.

The normal, "vanilla" Terraria and tModLoader are entirely separate, as the base game is included in tModLoader and is tweaked to allow modding. tModLoader's version of Terraria is therefore updated separately from the vanilla game. Due to the enormous number of changes in the (Journey's End) update, which required fundamental alterations of the tweaked base game, there are two "variants" of tModLoader: One that is based on Terraria ("1.3-legacy") and one that is based on Terraria ("1.4-stable"). Mods that are available in one variant may not be available in the other.

On this wiki, the variant is referred to as Legacy tModLoader version Legacy tModLoader version, while the variant is considered to be part of the Desktop version Desktop version.

Although 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

  • Right click on tModLoader in Steam.
  • Select "Properties..."
  • Select "BETAS".
  • Select "1.3-legacy" in the drop-down menu on top.
  • Close the window.


  • Install tModLoader
  • Fresh install of Terraria game files:
    • Steam: Delete the Terraria folder in C:/Program Files (x86)/Steam/steamapps/common.
    • Non-Windows computer or have Steam installed elsewhere: type .findinstall in botworld to get to the tModLoader folder, then just go back one folder to end up in the common folder mentioned earlier.
    • Uninstall, then reinstall Terraria in Steam.
  • Fresh tModLoader files:
    • Steam: Delete the tModLoader folder in C:/Program Files (x86)/Steam/steamapps/common.
      • To find your install directory on Steam - right click tModLoader in the library, then hover over Manage and click on Browse local files.
    • Non-Windows computer: type .findinstall in botworld to get to this folder.
    • Uninstall, then reinstall tModLoader in Steam.
  • Note: Your player and world saves are stored in a completely separate folder than the ones mentioned above. If you delete any other folders, the developer is not responsible for you losing any of your saves.

1.4 launch errors

Windows 64 bit Users
If you are for whatever reason finding dotnet is not installing, such as internet problems/blocks, download the dotnet runtime.
Place this .zip in the 'dotnet' folder, in your install location.
Extract it, don't change the name - we want 6.0.0.
Steam Linux Users
Game isn't Launching? Read about the bug and workaround in comments here:
The directX package from Microsoft for d3dcompiler_47 is missing 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
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 "Clear current search query, filters, and sorts" button and then searching for a key word).

Useful links

File locations

Here are some useful default paths.

  • Saves
    • Windows: %UserProfile%\Documents\My Games\Terraria\tModLoader (This is typically found in C:\Documents\)
      • 1.3: %UserProfile%\Documents\My Games\Terraria\ModLoader
    • Linux: ~/.local/share/Terraria/tModLoader/ or $XDG_DATA_HOME/Terraria/tModLoader/
    • Mac: ~/Library/Application support/Terraria/tModLoader/
  • Installs
    • Windows: C:\Program Files (x86)\Steam\steamapps\common\tModLoader
    • Linux: ~/.local/share/Steam/steamapps/common/tModLoader or ~/.steam/steam/steamapps/common/tModLoader
    • Mac: Library/Application Support/Steam/steamapps/common/tModLoader/
  • Mod Path: Your manually installed mods are stored in a subfolder of the Saves folder called /Mods.
  • Workshop mods are stored in C:\Program Files (x86)\Steam\steamapps\workshop\content\1281930, but you shouldn't touch the folder and instead unsubscribe in steam.
  • Logs Path: The Logs are found in a subfolder of the Install folder called /tModLoader-Logs.


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

  • The Unloaded Item.png / Unloaded Item (1.3-Legacy).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. It can only be crafted during April Fools Day, where it displays as Terrarian...? and can be crafted for 1 Dirt Block.
  • The Starting Bag.png / Starting Bag (1.3-Legacy).png Starting Bag, which is used to store excess starter items that would not fit in the player's inventory.
  • Various tModLoader developer items.