Getting Started with tModLoader
A comprehensive guide to installing and using tModLoader for the first time
What is tModLoader?
Quick Overview
tModLoader is a free, open-source modding framework for Terraria that allows you to easily install, manage, and create mods. It's the official modding platform supported by Re-Logic.
tModLoader extends Terraria with a powerful C# API that enables mod developers to create anything from simple quality-of-life improvements to massive content overhauls. For players, it provides an easy way to discover and install thousands of community-created mods.
Key Benefits:
- Steam Workshop Integration: Browse and install mods with one click
- Automatic Updates: Mods update automatically through Steam
- Safe Modding: Sandbox environment prevents game corruption
- Cross-Platform: Works on Windows, macOS, and Linux
- Active Community: Thousands of mods and helpful community
System Requirements
Windows
- Windows 7 SP1 or later
- 2GB RAM minimum
- 1GB free disk space
- .NET Framework 4.7.2+
macOS
- macOS 10.12 or later
- 2GB RAM minimum
- 1GB free disk space
- Mono framework
Linux
- Ubuntu 16.04+ or equivalent
- 2GB RAM minimum
- 1GB free disk space
- Mono framework
Important Note
You must own a legitimate copy of Terraria to use tModLoader. tModLoader requires the base game to function.
Installation Methods
Method 1: Steam (Recommended)
The easiest and most reliable way to install tModLoader is through Steam. This method provides automatic updates and Steam Workshop integration.
- Open Steam and search for "tModLoader" in the store
- Click "Install Game" (it's completely free)
- Wait for the download to complete
- Launch tModLoader from your Steam library
- The game will create necessary mod directories on first launch
Pro Tip:
tModLoader appears as a separate game in your Steam library. You can launch it independently of vanilla Terraria.
Method 2: Manual Installation
For GOG users or those who prefer manual installation. Requires more steps but gives you full control.
- Download the latest release from GitHub Releases
- Extract the downloaded archive to your Terraria installation folder
- Run the tModLoader executable
- Follow the on-screen setup instructions
Default Terraria Locations:
- Steam:
C:\Program Files (x86)\Steam\steamapps\common\Terraria - GOG:
C:\GOG Games\Terraria
First Launch
When you launch tModLoader for the first time, it will automatically set up the necessary directories and files.
What Happens on First Launch:
-
Directory Creation:
Creates mod folders in your Documents/My Games/Terraria/tModLoader directory
-
Configuration Setup:
Initializes configuration files and settings
-
Mod Browser Access:
Enables access to the in-game mod browser
Installing Your First Mods
Using the In-Game Mod Browser
-
Launch tModLoader
Start tModLoader from Steam or your installation directory
-
Access Mod Browser
From the main menu, click "Workshop" → "Download Mods"
-
Browse Available Mods
Use search, filters, or browse by popularity
-
Download Mods
Click the download icon next to any mod you want
-
Enable Mods
Go to "Workshop" → "Manage Mods" and enable your downloaded mods
-
Reload
Click "Reload Mods" to apply changes
Recommended First Mods
Recipe Browser
Essential utility for viewing all available recipes and items
Magic Storage
Revolutionary storage system with unlimited capacity
Boss Checklist
Track your progression through bosses
Fargo's Mutant Mod
Quality of life improvements and boss summoning