If you’ve sunk dozens of hours into Terraria, beaten every boss from the Eye of Cthulhu to the Moon Lord, and explored every hidden biome on your map, you’re probably craving fresh content to shake up your playthrough. Mods are the easiest way to add hundreds of new items, bosses, biomes, and quality-of-life features to the game, and learning how to put mods on Terraria is far simpler than most new players think. We’ve tested hundreds of mod setups over the years, so we’ve put together this guide to help you avoid common pitfalls like corrupted saves, crash loops, and compatibility errors. You don’t need any advanced tech skills to follow along, either.
Prep Work You Need to Do Before Installing Any Terraria Mods
Before you download any mods, there are two critical steps to take to protect your existing game progress. First, back up your local save files first — even the most well-made mod can occasionally conflict with your existing worlds or characters, and having a backup means you won’t lose hundreds of hours of playtime if something goes wrong. Saves are usually stored in your Documents folder under the Terraria subfolder on Windows, or in the Library/Application Support/Terraria folder on Mac.
Second, make sure your base Terraria game is updated to the latest official version. Almost all modern Terraria mods are built to work with tModLoader, a free, official mod management tool developed by the community in partnership with Re-Logic. If you own Terraria on Steam, tModLoader is available as a separate free download that automatically links to your existing game install. Note that mod support is extremely limited on console and mobile versions of Terraria, so you’ll get the best experience modding on PC.
How to Put Mods on Terraria Using tModLoader (Step-by-Step)
Once you have tModLoader installed, the process of adding mods is straightforward for most players. Start by launching tModLoader from your Steam library, then navigate to the “Mod Browser” tab on the main menu. You can search for mods by name, sort them by popularity or recent updates, or filter by category like content, quality of life, or visual overhauls.
Always check mod compatibility notes before hitting download. Some mods only work with specific versions of tModLoader, and others will explicitly state that they conflict with popular mods like Calamity or Thorium. When you find a mod you want, click the download button, and it will automatically install to your mod folder.
Once you’ve downloaded all the mods you want to try, head to the “Mods” tab on the main menu. You can toggle individual mods on or off from this screen, and rearrange their load order if needed. When you’re happy with your selection, click “Reload Mods” to apply the changes, then start a new world or load an existing one to play with your mods active. If you’re running more than 5 large content mods, allocate at least 4GB of RAM to tModLoader in the settings menu to prevent lag or crashes during gameplay.
Common Modding Mistakes to Avoid at All Costs
Even with a simple tool like tModLoader, it’s easy to make small mistakes that break your entire mod setup. The biggest mistake new modders make is downloading mods from random third-party sites instead of the official tModLoader Mod Browser. Unvetted sites often host outdated mod versions or files infected with malware, so stick to the in-game browser to stay safe.
Never mix mod versions from random unvetted sources, as this is the number one cause of endless crash loops. Another common mistake is installing 20+ mods at once on your first try. If you add too many mods at the same time, it’s almost impossible to figure out which one is causing issues if your game breaks. Start with 2 to 3 mods first, test them for a few hours, then add more gradually.
If you run into issues with your mod setup, look for these common warning signs to diagnose the problem fast:
- The game crashes immediately when you try to launch it after enabling new mods
- You see bright pink or black missing texture blocks when loading an existing world
- Your character inventory has glitched, unremovable items that don’t exist in the base game
- Multiplayer servers won’t let you join even if you think you have the same mod list as the host
If you spot any of these issues, disable mods one by one and reload the game after each change to find the conflicting file. You don’t need to delete all your mods and start over in most cases, so take it slow and test each mod individually.
How to Customize Your Modded Terraria Experience for Maximum Fun
Once you’ve got the basics of mod installation down, you can mix and match mod types to build a playthrough that fits your preferences. If you want more core content, try popular large mods like Calamity, Thorium, or Spirit Mod, each of which adds dozens of new bosses, hundreds of new items, and entirely new biomes to explore. If you don’t want to change the core game loop, try quality of life mods like Recipe Browser, Boss Checklist, or Magic Storage to make routine tasks faster and less tedious.
If you want to play modded multiplayer, every player needs the exact same mod list and versions — even a small difference like an outdated QoL mod will prevent you from connecting to a server. You can export your mod list as a shareable pack from the Mods menu in tModLoader, so you can send a single file to your friends instead of making them hunt down each mod individually.
From my own experience, it’s best to start with one large content mod and 3 to 4 QoL mods for your first modded playthrough. Trying to run 3 large content mods at once will overwhelm you with new content and make it hard to tell what features come from which mod. You can always add more mods later once you’re comfortable with the basics.
Now that you know how to put mods on Terraria, you can unlock hundreds of extra hours of gameplay without spending a cent. Don’t stress if your first mod setup crashes or has glitches — every long-time Terraria modder has had to dig through their mod list to find a conflicting file at least once. Start small, test mod combinations that fit your playstyle, and don’t be afraid to experiment with weird, niche mods that catch your eye. If you find a mod you really love, consider leaving a positive note for the creator, as most of them build content for free out of love for the game.