Terraria mods: how to install tModLoader and get started

What tModLoader is

tModLoader is the mod loader for Terraria. It is not a mod itself — it is the separate application that loads mods, and it has its own Steam entry.

The important structural point is that tModLoader is its own thing. You do not patch Terraria, and you do not lose your vanilla install by adding it.

Installing it

1. Install tModLoader from Steam. It appears in your library as a separate entry from Terraria.
2. Launch tModLoader instead of Terraria. Mods do not load when you launch the base game.
3. Open the mod browser from the tModLoader menu. This is where you browse and subscribe to mods, and it is built into the app rather than being a website you visit.
4. Subscribe and enable. Subscribing downloads a mod; you still have to enable it for the current session.
5. Reload when prompted. Most mods need the game to reload before they take effect.

Keep your vanilla worlds and modded worlds separate. Introducing mods into a long-running vanilla world is the fastest way to make it unloadable without the mods present.

Which version mods target

This is the part most mod guides get wrong, because the mod loader and the game are on different versions.

The consequence is a version gap you have to plan around. Terraria itself is on 1.4.5.8 on PC, but the mod ecosystem is still built on the older branch. A guide written for 1.4.5 features may describe things that mods cannot yet touch, and vice versa.

Before installing anything, check which game version the mod states it needs. That single check explains most “the mod does not appear” problems.

Starting mods

For a first install, the low-risk category is quality-of-life mods — mods that add convenience without changing the game’s balance or content. These are the ones that are least likely to conflict with each other or to make a world dependent on them.

• Magic Storage is the widely used example: a storage system that replaces rows of chests with a searchable interface. It is a convenience mod rather than a content overhaul.
• Interface and information mods generally sit in the same low-risk category.
• Content mods — new bosses, biomes and progression — change the game substantially and are better attempted after you are comfortable with how the loader behaves.

Start with one mod, confirm the game still runs, then add the next. Installing a large batch at once makes it impossible to tell which one broke something.

Cautions

• Mods are unofficial and unsupported. If a modded install misbehaves, that is a mod issue, not a Terraria bug to report to Re-Logic.
• Back up worlds before adding mods. The save recovery page shows where the files live.
• Do not report modded crashes to Re-Logic. Reproduce the problem without mods first, then decide where it belongs.
• This site does not cover large content mods. It focuses on the official game and on mods that are only convenience tools.
• Do not move modded worlds between branches casually. A world created under one mod set may not load under another.

If a modded install starts crashing after an update, the most likely cause is the loader or a mod not yet updated for the new branch — not the game. Check the tModLoader branch status above before troubleshooting Terraria itself.