tModLoader Documentation
Everything you need to know about using and developing for tModLoader
What is tModLoader?
tModLoader (TML) is a free modding framework and client for Terraria that allows you to install, manage, and create mods. It provides a comprehensive C# API that gives mod developers full access to Terraria's systems while maintaining compatibility and ease of use for players.
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
Easy Mod Installation
One-click mod installation through Steam Workshop or in-game browser
Powerful C# API
Complete access to Terraria's systems with extensive documentation
Hot Reload Development
Test mod changes instantly without restarting the game
Multiplayer Support
Full multiplayer compatibility with mod synchronization
Quick Start
Get Started in 3 Steps
Download & Install
Get tModLoader from Steam or GitHub
Browse Mods
Use the in-game mod browser to find mods
Play & Enjoy
Enable mods and start your modded adventure
Popular Guides
Installation Guide
Step-by-step installation for Steam, GOG, and manual setups
5 min readMod Development
Complete guide to creating your first Terraria mod
15 min readTroubleshooting
Common issues and solutions for tModLoader
10 min readAPI Reference
Complete C# API documentation with examples
ReferenceLatest Updates
tModLoader v2025.07.3.0 Released
Latest monthly release with bug fixes and API improvements. Compatible with Terraria 1.4.4.9.