Getting Started with Terraria Modding

Terraria modding is one of the few PC modding scenes where the official answer is also the right answer: install tModLoader, the free fork-of-Terraria DLC that Re-Logic ships through Steam, and you're set up. This guide walks through the full install from scratch, your first mod install, and the handful of gotchas a new Terraria modder will hit in the first week.

If you've modded another game before, mentally drop the muscle memory for BepInEx, Forge, or SMAPI — Terraria works differently.

What tModLoader is (and isn't)

tModLoader is not a mod loader you bolt onto Terraria. It's a separate game build — a fork of Terraria with a runtime mod API baked in, distributed by the tModLoader team and adopted by Re-Logic as an official free DLC on Steam.

Practically, this means:

• You don't modify Terraria's files. tModLoader is its own executable in its own Steam install folder.
• Vanilla Terraria and tModLoader coexist on disk. Switching back to vanilla is one Steam launch away.
• tModLoader's Workshop is separate from base Terraria's Workshop. Same Steam community, different mod feed.

Step 1 — Install tModLoader

On Steam:

1. Make sure you own Terraria (tModLoader is a free DLC, but it requires the base game).
2. Right-click Terraria in your library → Properties → DLC tab.
3. Tick tModLoader. Steam will download it as a separate app.
4. Close the DLC dialog. tModLoader now appears in your Steam library as its own entry.

Launch tModLoader the same way you'd launch any other Steam game. It looks and feels exactly like Terraria — same main menu, same fonts, same music — with one extra Mods button on the title screen.

Step 2 — Subscribe to your first mod through the Workshop

The easiest path:

1. From tModLoader's main menu, click Workshop → Browse Mods.
2. Search for a mod. Good first picks if you've never modded Terraria:
   • Recipe Browser — adds a searchable recipe interface, low-impact, no balance changes.
   • Boss Checklist — UI overlay listing every boss and their drop tables.
   • Magic Storage — adds bottomless centralised storage. Quality-of-life, doesn't alter combat.
3. Click Subscribe. Steam downloads the mod into Documents/My Games/Terraria/tModLoader/Mods/.

Back at the main menu, click Mods. Your subscribed mod is in the list, disabled by default. Toggle it to enabled, click Reload Mods, and tModLoader rebuilds its mod graph (this takes a few seconds for small mods, longer if you're loading something the size of Calamity).

Step 3 — Start (or continue) a world

After reload, you can create a new world with mods enabled. Worlds and characters created in tModLoader are saved separately from vanilla:

• Documents/My Games/Terraria/tModLoader/Worlds/
• Documents/My Games/Terraria/tModLoader/Players/

This is why mod combinations matter: the character and world know which mods were active when they were created. Loading a tModLoader save with different mods enabled produces warnings about missing items, and in the worst case (for content mods that add new biomes) parts of the world may be corrupted.

Step 4 — Mod configuration (where to find it)

Many mods add an in-game config menu. From the main menu: Mods → select a mod → Config. The exact options depend on the mod, but common ones are difficulty toggles, content gates ("disable boss X"), and UI scaling.

A mod's config is stored at Documents/My Games/Terraria/tModLoader/ModConfigs/. If a config gets stuck in a bad state, deleting the corresponding .json file resets the mod to defaults.

Step 5 — Updating mods

Steam Workshop subscriptions update automatically when the mod author publishes a new version. You don't need to do anything — but you do need to reload mods after the update (or restart tModLoader). The in-game Mods menu shows which mods have pending updates.

If a mod update breaks a save, the previous version is gone from Workshop. Workshop doesn't keep version history. The mitigation: back up your Players/ and Worlds/ folders before any major mod update on a long-running playthrough.

Common gotchas

• You're on the wrong Terraria version. tModLoader's stable branch tracks the current Terraria release (1.4.4+). The legacy "tModLoader 1.3" still exists on Steam as a separate Legacy branch — old mods reference it. If a mod's last update was years ago and the README mentions "tML 1.3", you'd need the legacy branch, not current tML. Most users want current tML.
• Multiplayer with mods requires exact matches. Every client must have the same mods at the same versions. The host's mod set is authoritative; clients that don't match are kicked. Pin your mod list in Steam to avoid mid-session auto-updates.
• Big content mods don't always combine. Calamity Mod + Thorium + an arbitrary new-class mod produces ID conflicts and balance issues. Stick to one large content overhaul at a time, plus QoL mods around it.
• Mods can crash on world generation. If tModLoader hangs while creating a new world, the culprit is usually one of the largest content mods. Disable it, generate the world, then enable it again before play.
• Disabling a content mod mid-playthrough breaks saves. If you've used items or visited biomes added by a content mod, removing it deletes that state. Make a save backup before disabling.

That's the full first-week loop: install tModLoader, subscribe to a small QoL mod, learn the Mods menu, then graduate to bigger content mods once the basics feel routine.

If you're a Terraria modder thinking about publishing your own mod, the OpenMods publishing guide covers connecting a GitHub repo as your source of truth alongside Workshop releases.