Quick Start Guide
Everything you need to get started with tModLoader in under 5 minutes.
What is tModLoader?
tModLoader is a free, open-source modding framework and client for Terraria. It allows you to install, manage, and create mods with a comprehensive C# API. Originally created as a modification, tModLoader has grown into the official modding platform for Terraria, with direct support from Re-Logic and integration with Steam Workshop.
Key Features
- • 10,000+ mods available
- • Steam Workshop integration
- • Cross-platform support
- • Automatic mod updates
- • Full multiplayer support
Safe & Trusted
- • 100% free and open-source
- • Officially supported by Re-Logic
- • Community-verified mods
- • 5M+ downloads worldwide
- • Active developer community
System Requirements
Minimum Requirements
- OS: Windows 7+ / macOS 10.12+ / Linux
- RAM: 2GB
- Storage: 1GB free space
- Required: Terraria installed
- Windows: .NET Framework 4.7.2+
- Mac/Linux: Mono Framework
Recommended
- RAM: 4GB or more
- Storage: 2GB+ for mod collections
- Internet: For downloading mods
- Platform: Steam (for Workshop)
Quick Start: 3 Simple Steps
Download & Install
Get tModLoader for free from Steam (recommended) or GitHub. Steam version includes automatic updates and Workshop integration.
Browse & Install Mods
Open the in-game Mod Browser, search for mods you want, and click Download. Enable them in the Mods menu and reload.
Learn how to use modsPlay & Enjoy
Create a new world or load an existing one. Your mods will be active! Most mods work with vanilla saves.
Pro Tip: Start with 5-10 quality-of-life mods before adding large content mods for the best experience.
What to Expect After Installation
Understanding what happens when you first launch tModLoader.
File Structure Creation
tModLoader creates its own folder structure separate from vanilla Terraria:
Documents/My Games/Terraria/tModLoader/
├── Mods/ # Downloaded mods (.tmod files)
├── ModSources/ # Mod development source code
├── Players/ # Character saves
├── Worlds/ # World saves
├── Logs/ # Debug logs
└── ModConfigs/ # Mod configuration files
Save Compatibility
Important information about saves and mods:
- tModLoader saves are separate from vanilla Terraria
- You can copy vanilla characters/worlds to tModLoader folder
- Backup saves before installing major content mods
- Some mods require new worlds to function properly
First Launch Tips
- First launch takes 2-5 minutes to set up files
- Main menu looks similar to vanilla Terraria
- New options: "Mod Browser", "Mods", "Workshop"
- You can play without mods (vanilla experience)
Common First-Time Questions
Do I need to uninstall vanilla Terraria?
No! tModLoader is a separate installation. You can have both vanilla Terraria and tModLoader installed at the same time. They use separate save folders so your vanilla saves are safe.
Can I use my existing Terraria characters and worlds?
Yes! You can copy your vanilla saves to tModLoader:
- Navigate to vanilla Terraria saves:
Documents/My Games/Terraria/ - Copy desired characters from
Players/folder - Copy desired worlds from
Worlds/folder - Paste into corresponding tModLoader folders
Warning: Make backups before using vanilla saves with mods. Some content mods may require new worlds.
How much disk space do I need?
- • tModLoader base: ~200MB
- • Small mod pack (10-15 mods): ~100-300MB
- • Large mod pack (30-50 mods): ~500MB-1GB
- • Content mods like Calamity: ~100-200MB each
Recommend keeping 2-3GB free for comfortable modding.
Will mods affect my game performance?
Performance impact depends on several factors:
- • Number of mods: More mods = more RAM usage
- • Mod type: Content mods use more resources than QoL mods
- • Your system: 8GB+ RAM recommended for large mod packs
Tip: Start with 5-10 lightweight mods and add more gradually to gauge performance.
Is tModLoader updated regularly?
Yes! tModLoader is actively maintained:
- • Steam version auto-updates with new features and bug fixes
- • Major updates follow Terraria version releases
- • Monthly patches for stability improvements
- • Currently based on Terraria 1.4.4
Recommended Mods for Beginners
Start your modding journey with these beginner-friendly, essential mods that enhance gameplay without overwhelming complexity.
Magic Storage
Revolutionary storage system that lets you access all your items from one central location. Search functionality, auto-crafting, and unlimited storage capacity. Essential for any modded playthrough.
Recipe Browser
Browse all crafting recipes in-game with powerful search and filtering. Shows what items you can craft, what materials you need, and where to craft them. Supports all modded items automatically.
Boss Checklist
Visual checklist showing all bosses from vanilla and modded content. Displays boss progression order, summoning items, loot tables, and suggested equipment. Invaluable for tracking progress in large mod packs.
Wing Slot
Adds a dedicated equipment slot for wings, freeing up an accessory slot. Simple concept with huge quality-of-life improvement. Compatible with all wing types from vanilla and modded content.
Pro Tip: Starter Mod Pack
Install these 4 mods first for the optimal beginner experience:
These won't change game balance but will significantly improve your experience.
Understanding Mod Types
Mods fall into different categories. Understanding these helps you build balanced mod packs.
Content Mods
Add new gameplay content - bosses, biomes, items, mechanics.
Quality of Life (QoL)
Improve convenience without changing core gameplay.
Gameplay Tweaks
Modify game balance, difficulty, or mechanics.
Visual & Audio
Enhance graphics, music, UI, and sound effects.