What mods are and where to get them

Mods are files that change how Terraria plays — they add new items, enemies, bosses, or entire biomes. Unlike the base game, mods come from the community, not from Re-Logic (the company that makes Terraria). The most common place to find them is tModLoader, which is a tool that lets Terraria read and run mods at all.

tModLoader is free and works on Windows, Mac, and Linux. It acts as a middleman between your game and the mod files. Without it, Terraria cannot load mods. You install tModLoader first, then use it to read and manage the actual mods you want to play with.

The second place you will need is the tModLoader browser — a website built into tModLoader where modders upload their work. Once tModLoader is running, you can browse mods directly from the game without leaving it. You can also visit the website tmodloader.github.io to see what is available before you install anything.

Key Takeaways

  • tModLoader is a free tool you read from Steam or GitHub that lets Terraria run mods at all.
  • You launch tModLoader instead of Terraria itself, and it opens a modded version of the game.
  • Most mods are downloaded and installed directly through tModLoader's browser window — you do not need to manually move files.
  • Mods can conflict with each other, so if the game crashes after adding mods, disable the newest one first to find the problem.
  • Your original Terraria world and character files are separate from your modded ones, so mods do not affect your vanilla game.

Installing tModLoader on Windows

The easiest route is through Steam. Open Steam, search for "tModLoader", and click the blue "Subscribe" button. Steam will read it automatically and add it to your library. You will then see "tModLoader" as a separate game in your library — launch it from there, not from regular Terraria.

If you do not use Steam, you can read tModLoader from GitHub (github.com/tModLoader/tModLoader). Click the "Releases" tab, find the latest version, and read the file that says "tModLoader.exe". Run the installer and follow the prompts. It will ask where your Terraria folder is — if you bought Terraria on Steam, the installer usually finds it automatically.

After installation, launch tModLoader. The first time you run it, it will unpack files and may take a minute or two. You will see a window that looks like Terraria's main menu but with extra buttons at the top. This is normal. Do not close it during this first setup.

Installing tModLoader on Mac and Linux

Mac users should read tModLoader from the GitHub releases page (github.com/tModLoader/tModLoader). Look for the file labeled "tModLoader.dmg" and double-click it. Drag the tModLoader icon into your Applications folder. Then open Applications, find tModLoader, and launch it. The first run will unpack files, just like on Windows.

Linux users also read from GitHub, but look for the file that says "tModLoader" without an extension. You will need to open a terminal, navigate to where you downloaded it, and run a command to make it executable. If you are not comfortable with terminal commands, the tModLoader GitHub page has detailed Linux setup instructions in its README file.

Both Mac and Linux versions may ask you to locate your Terraria installation folder. If you installed Terraria through Steam, it is usually in a hidden folder. The installer will guide you through finding it, or you can search online for "Terraria Steam folder Mac" or "Terraria Steam folder Linux" for your specific system.

Downloading and installing mods through tModLoader

Once tModLoader is running, click the "Mods" button at the top of the menu. You will see a list of mods that other players have made. Each mod has a blue "read" button next to its name. Click it, and tModLoader will fetch the mod and install it automatically — you do not need to move files or unzip anything yourself.

After you read a mod, a checkbox will appear next to its name. Check the box to turn the mod on. Unchecking it turns it off without uninstalling it. When you are done selecting mods, click "Reload Mods" at the bottom. tModLoader will restart and load your game with the mods you chose.

The first time you load mods, it may take longer than usual — tModLoader is building the modded game. Wait for it to finish. If the game crashes during this step, it usually means two mods are fighting each other. Close the game, uncheck the most recently added mod, and try again.

Fixing crashes and conflicts between mods

If your game crashes after you add mods, the problem is almost always that two mods do not work together. Start by unchecking the last mod you downloaded. Click "Reload Mods" and try again. If the game starts, that mod was the problem. You can either remove it or search the mod's page for known conflicts.

Some mods require other mods to work. If a mod's page says it needs "Calamity" or "Spirit Mod" or another mod, you must read those first. tModLoader will sometimes tell you this when you try to load — look for a red error message that names the missing mod.

If you have many mods and cannot figure out which one is causing the crash, disable half of them, reload, and test. If it works, the problem is in the disabled half — re-enable them one at a time until it crashes again. If it still crashes with half disabled, the problem is in the enabled half. This method narrows it down quickly.

Understanding modded worlds and characters

When you load mods and start a new world, Terraria creates a separate world file that only works with those mods. You cannot load a modded world in vanilla Terraria (the game without mods), and you cannot load a vanilla world in modded Terraria — they are incompatible.

Your original Terraria worlds and characters are untouched. They sit in a different folder and are not affected by mods at all. If you want to play vanilla Terraria again, just launch regular Terraria from your library instead of tModLoader. Your old worlds will be there.

If you disable all mods in tModLoader and reload, you can play vanilla worlds again from within tModLoader. But if you have mods enabled and try to load a vanilla world, the game will refuse to open it. Always check which mods are enabled before you load a world.

Updating mods and tModLoader itself

tModLoader updates regularly, and mods update even more often. When you open the Mods menu, any mod with an update will show an orange "Update" button instead of "read". Click it to fetch the newest version. tModLoader will replace the old version automatically.

When tModLoader itself updates, Steam will read the update for you if you have it installed through Steam. If you downloaded it from GitHub, you will need to read the new version manually and run the installer again. Check the GitHub releases page every few weeks if you want to stay current.

After updating mods or tModLoader, reload mods before you play. Sometimes an update fixes a conflict that was crashing your game, or it introduces a new one. Reloading lets you catch problems before you load a world and lose progress.

Frequently Asked Questions

Can I use mods on console versions of Terraria?

No. tModLoader only works on PC — Windows, Mac, and Linux. Console versions (PlayStation, Xbox, Nintendo Switch) do not support mods. If you want to play modded Terraria, you need the PC version.

Will mods ruin my vanilla worlds?

No. Vanilla worlds are stored separately and are not touched by mods. You can play vanilla Terraria anytime by launching the regular game instead of tModLoader. Your old worlds will be exactly as you left them.

What do I do if a mod will not read?

Check your internet connection first. If it is working, the mod's server might be down temporarily. Wait a few minutes and try again. If it still fails, check the mod's page on GitHub or the tModLoader browser to see if other players are reporting the same problem. Some mods are removed or abandoned, and those will not read.

Can I play multiplayer with mods?

Yes, but everyone on the server must have the exact same mods enabled. If one player has a mod that another does not, the game will not let them connect. This is why modded multiplayer is usually played with friends who coordinate their mod lists beforehand.

How much space do mods take up?

Most mods are small — between 5 and 50 megabytes each. Even if you read 20 mods, they will use less than 1 gigabyte of space. Large mods like Calamity or Thorium are bigger, but still under 200 megabytes. Check your hard drive's free space if you are running low, but mods are generally not a storage problem.