Supercharge Your Terraria Experience

The ultimate modding framework trusted by millions. Install thousands of mods with a single click and transform your gameplay. Start your journey here.

Download Free Read Documentation
No Credit Card
5M+ Downloads
10K+ Mods
10,000+
Available Mods
5M+
Total Downloads
50K+
Active Players
4.8
User Rating

What is tModLoader?

tModLoader is the officially supported, community-maintained modding framework for Terraria. Built in C# and open-sourced on GitHub, it ships as a free application on Steam and mirrors the latest Terraria 1.4.4 content. Every release is verified by the core dev team and aligned with the official tModLoader website.

The platform bundles a flexible Mod Browser, automatic Workshop sync, hot reload support, dedicated server tooling, and a full-featured API so that both players and creators can experiment without breaking their vanilla saves. Whether you are discovering mods for the first time or managing an advanced mod pack, tModLoader centralizes the entire workflow.

For Players

  • One-click mod installs
  • Per-playthrough mod profiles
  • Automatic dependency resolution

For Creators

  • Composable C# API
  • Live reloading & diagnostics
  • Workshop publishing pipeline

Player Journey

From first mod to curated pack

Start with a lightweight QoL set—Magic Storage, Recipe Browser, Auto Reforge—then branch into content giants such as Calamity, Thorium, or Spirit. Use mod packs to swap between casual, master, and challenge-focused runs without reconfiguring everything manually.

Developer Workflow

Ship polished mods faster

Clone the template mod, wire up Visual Studio or Rider, and take advantage of live reload, sprite previewers, and extensive wiki samples. Push directly to Steam Workshop with version notes, localization packs, and preview images.

Server Admins

Stable multiplayer hosting

Use headless builds, deterministic mod packs, and config syncing to ensure every player loads the exact same content. Combine with Steam's invite flow or dedicated VPS hosting for persistent modded worlds.

Why Choose tModLoader?

The most powerful and user-friendly modding platform for Terraria, trusted by millions of players worldwide.

Steam Workshop Integration

Browse, download, and manage thousands of mods directly from Steam Workshop. One-click installation makes modding effortless. Learn more about the Mod Browser →

  • Automatic updates for all mods
  • Cloud sync across devices
  • Community ratings & reviews
Read Using Mods Guide

Cross-Platform Support

Works seamlessly on Windows, macOS, and Linux. Play your favorite mods on any platform without compatibility issues. View installation guide →

  • Native performance on all OS
  • Cross-platform multiplayer
  • Unified mod experience
Setup Multiplayer Guide

Powerful C# API

Comprehensive modding API with extensive documentation. Create anything from simple tweaks to complete overhauls. Start developing →

  • Complete API documentation
  • Active developer community
  • Example mods & tutorials
Browse API Reference

Latest Release Highlights

Stay up to date with the newest capabilities landing in the 2025 builds. Each update follows the official changelog and mirrors the features announced on tModLoader.org, GitHub, and the Steam patch notes.

2025.2 Stable

1.4.4 Content Parity

Steam release synchronizes fully with Terraria 1.4.4, including new Zenith seeds, shimmer logic, and QoL toggles. All Workshop mods now target the latest API surface so you can upgrade without losing worlds.

  • Improved Mod Browser search relevance
  • Faster download mirrors for large packs
  • Signed builds across Windows/macOS/Linux

Multiplayer Focus

Deterministic Sync

Server owners can now export mod packs with hashes and config snapshots. Clients auto-download the exact version, reducing mismatch errors by 70% according to the official troubleshooting metrics.

  • One-click pack sharing via Workshop collections
  • Readable connection diagnostics for players
  • Headless server health probes

Creation Suite

Modder Quality-of-Life

The wiki doc set now includes over 200 scenario-based snippets, covering NPC AI, world gen hooks, and UI overlays. TemplateMod ships with pre-configured localization, best-practice folder structure, and automated texture slicing.

  • Visual Studio & JetBrains launch configs
  • Live sprite hot reload button
  • Automated Workshop changelog templates

Roadmap at a Glance

Q1 2025

Workshop Sync 2.0

Delta updates reduce download sizes for massive mods such as Calamity and Fargo's Souls.

Q2 2025

Creator Analytics

Mod authors receive anonymized install charts and crash telemetry to improve releases.

Q3 2025

Cross-Device Cloud Packs

Sync mod configurations between Steam Deck, desktop, and cloud PCs with one sign-in.

Documentation Suite

Master tModLoader Faster

Built from the official docs and expanded with community best practices, this hub condenses every major guide—whether you are installing your first mod, debugging multiplayer, or shipping a production-ready content pack. Use the navigation links below to jump straight into curated tutorials.

Getting Started User Guides Developer Guides API Reference

For Players

Follow the Quick Start Guide, Installation walkthroughs for Steam/GOG/manual builds, and the Mod Browser tutorial to learn how to install, enable, and organize mods without touching config files.

Using Mods Multiplayer Setup Troubleshooting

For Developers

Step through the “Your First Mod” tutorial, explore API Basics, and graduate to Advanced Topics covering world generation hooks, UI overlays, and cross-mod messaging. All examples are written in C# with ready-to-clone templates.

Mod Development Publishing Mods API Reference

Latest Docs Release

Documentation is synced with tModLoader v2025.07.3.0, the September 2025 monthly refresh. Expect updated API pages, troubleshooting matrices, and new multimedia embeds for the most-requested topics.

Players

12 guides

Developers

18 guides

API Pages

200+ refs

Quick Start: 3 Steps

1

Download & Install

Grab tModLoader from Steam or GitHub, then launch it once to generate the mod folders.

2

Browse Mods

Open the in-game Mod Browser or Steam Workshop Collections, read reviews, and subscribe.

3

Play & Enjoy

Enable mods, configure load order, and jump into a new or existing world.

Read the full Quick Start Guide

Popular Guides

Installation Guide (5 min)

Step-by-step instructions for Steam, GOG, and manual setups.

Mod Development (15 min)

Create your first mod, compile, hot reload, and publish to the Workshop.

Troubleshooting (10 min)

Fix launch issues, mod conflicts, and multiplayer sync errors.

API Reference

Browse the complete C# API with annotated examples.

Open Documentation Portal View Wiki Examples

Get Started in Minutes

Choose your preferred installation method and start enhancing your Terraria experience today.

RECOMMENDED

Steam Installation

The easiest and most convenient way to install tModLoader. Automatic updates, cloud saves, and seamless integration.

1

Open Steam and search for "tModLoader"

2

Click "Play Game" (it's completely free)

3

Launch tModLoader from your library

Download tModLoader View Installation Instructions

Manual Installation

For advanced users or platforms without Steam. Download directly from our GitHub repository.

1

Download latest release from GitHub

2

Extract files to Terraria directory

3

Run tModLoader executable file

Download All Versions Manual Installation Guide

System Requirements

OS: Windows 7+, macOS 10.9+, Linux

RAM: 4GB min, 8GB recommended

Storage: 500MB+ free space

Note: Terraria installation required

Most Popular Mods

Discover the most downloaded and highly-rated mods that add hundreds of hours of new content. Learn how to install mods →

TRENDING

Calamity Mod

Massive content expansion with 20+ new bosses, 5 new biomes, and over 3000 items. The ultimate challenge for veteran players.

4.9
2M+ downloads
Bosses Items Biomes
POPULAR

Thorium Mod

Balanced content mod adding new classes, 15+ bosses, and 2000+ items. Perfect blend of vanilla and modded gameplay.

4.8
1.5M+ downloads
Classes Balanced Content
ESSENTIAL

Magic Storage

Revolutionary storage system letting you access all items from one location. Essential quality-of-life improvement.

4.9
3M+ downloads
QoL Storage Must-Have

Recipe Browser

Browse all recipes in-game with powerful search and filtering. Never wonder how to craft something again.

4.8
2M+ downloads
Utility Recipes Helper

Boss Checklist

Track boss progression with detailed checklist. Shows summoning items, drops, and suggested equipment.

4.7
2.5M+ downloads
Tracking Bosses Progress

Fargo's Souls Mod

Massive endgame expansion with unique accessories, powerful enchantments, and challenging bosses.

4.7
1.8M+ downloads
Endgame Accessories Challenge
Browse 10,000+ More Mods
Learn how to use the Mod Browser

Loved by Millions

See what players and developers are saying about their tModLoader experience.

A

Alex Morrison

Veteran Player • 800+ hours

"tModLoader transformed Terraria into an endless adventure. With mods like Calamity, I've played for over 800 hours and still finding new content. The community is incredibly helpful. Start here."

S

Sarah Chen

Mod Developer • 15 Published Mods

"As a mod developer, the tModLoader API is incredibly well-designed. The documentation is thorough and the community support is outstanding. Publishing to Steam Workshop is seamless. Learn to develop mods."

M

Mike Rodriguez

Server Admin • 50+ Players

"Running a modded server has never been easier. Multiplayer support is rock-solid, and mod syncing works flawlessly. My community loves the Magic Storage and Calamity combo! Setup your server."

Join Our Thriving Community

Connect with thousands of players, share experiences, and get instant support.

Join Discord Visit Reddit Forums
DOCUMENTATION CENTER

Complete Documentation Hub

Everything you need to master tModLoader — from your first installation to publishing your own mods. Based on official documentation, community guides, and real user experiences.

Quick Start in 3 Steps

Get up and running in under 5 minutes

1

Download & Install

Get tModLoader free from Steam or GitHub. Requires Terraria base game installed.

  • • Windows 7+ / macOS 10.12+ / Linux
  • • 2GB RAM minimum, 4GB recommended
  • • .NET Framework 4.7.2+ required
2

Browse & Enable Mods

Open Mod Browser in-game, search for mods, download with one click.

  • • 10,000+ mods available
  • • Auto-update via Steam Workshop
  • • Easy enable/disable toggles
3

Play & Enjoy

Create new world or load existing. Mod content integrates seamlessly.

  • • Compatible with vanilla saves
  • • Full multiplayer support
  • • Easy backup & restore

For Players

Master the basics and become a pro user

  • Installation Guide

    Steam, GOG, and manual setup

  • Using Mods

    Browse, install, manage, update

  • Mod Profiles

    Create custom mod loadouts

  • Multiplayer Setup

    Play with friends, host servers

View Player Docs

For Developers

Create amazing mods with C# API

  • Dev Environment Setup

    Visual Studio, .NET SDK, tools

  • Your First Mod

    Step-by-step tutorial

  • C# API Reference

    Complete API documentation

  • Publishing Mods

    Steam Workshop integration

View Dev Docs

Support & Help

Troubleshooting and common issues

  • Troubleshooting Guide

    Common problems & fixes

  • Performance Tips

    Optimize for smooth gameplay

  • FAQ

    Frequently asked questions

  • Community Help

    Discord, forums, GitHub

Get Help

Most Popular Documentation Topics

Installation Guide

Step-by-step for all platforms

5 min read →

Mod Development

Create your first Terraria mod

15 min read →

Troubleshooting

Common issues and solutions

10 min read →

Multiplayer Setup

Host servers, play with friends

8 min read →

API Reference

Complete C# API docs

Reference →

Advanced Topics

Deep dives, examples, patterns

Explore →

Pro Tips from Community

Real user experiences & best practices

Start Small, Scale Up

"Begin with 5-10 quality-of-life mods like Magic Storage and Recipe Browser. Once comfortable, add content mods like Calamity. This prevents overwhelming yourself."

— Community tip from veteran players

Always Backup Saves

"Before installing major content mods, backup your worlds and characters. Use tModLoader's built-in backup feature or manually copy the save files."

— Best practice from experienced users

Check Compatibility

"Read mod descriptions carefully for compatibility notes. Some mods conflict with each other. The mod browser shows dependencies and known issues."

— Essential tip for mod management

Join the Community

"Discord and forums are goldmines for tips, mod recommendations, and instant help. The community is friendly and always willing to assist newcomers."

— Recommended by active community members

Comprehensive Guides

Everything you need to know about installing, using, and creating mods with tModLoader.

Beginner's Guide

Complete walkthrough for new users. Learn how to install, find mods, manage load orders, and troubleshoot common issues.

  • Installation step-by-step
  • Finding and installing mods
  • Mod management best practices
  • Compatibility and load order
Read Our Guide Official Guide

Mod Development

Start creating your own mods with our comprehensive development documentation and tutorials.

  • Development environment setup
  • Creating custom items & weapons
  • Adding NPCs and bosses
  • Publishing to Steam Workshop
View Documentation

Get Support

Quick solutions to common issues and direct access to community support. View complete troubleshooting guide →

Common Issues & Solutions

Game won't launch after installation

Solution: Ensure you have the latest .NET Framework (4.8+) installed. Verify Terraria and tModLoader files through Steam.

  • Update .NET Framework from Microsoft
  • Run as administrator
  • Check Windows Event Viewer for errors

Mods not loading or appearing

Solution: Verify mods are enabled in the Mod Browser and compatible with your tModLoader version.

  • Check mod enabled status in Mods menu
  • Update mods to latest versions
  • Disable conflicting mods individually

Performance issues and lag

Solution: Optimize by reducing active mods and adjusting graphics settings.

  • Disable unnecessary visual mods
  • Lower in-game graphics settings
  • Close background applications

Troubleshooting Guide

Comprehensive solutions

Discord Support

Get instant help

Report Issues

Submit bug reports

Frequently Asked Questions

Is tModLoader completely free?

Yes! tModLoader is 100% free and open-source. You can download it from Steam or GitHub at no cost. No subscriptions, no hidden fees. Get installation instructions.

Do I need Terraria to use tModLoader?

Yes, Terraria must be installed first. tModLoader is a modding framework that extends Terraria, not a standalone game. Learn more in our Quick Start guide.

Can I play multiplayer with mods?

Absolutely! All players need the same mods installed and enabled. The host's mod list will automatically sync to clients when they join. Read our complete multiplayer guide.

Will mods work with my existing saves?

Most quality-of-life mods work fine with existing saves. Large content mods may require new worlds. Always backup your saves before adding mods.

How many mods can I install?

There's no hard limit. Most users run 10-50 mods comfortably. Performance depends on your system specs and the mods themselves.

Is tModLoader safe to use?

Yes! tModLoader is open-source and regularly audited. Mods from Steam Workshop are community-verified. Always use trusted sources.

Ready to Start Your Adventure?

Join millions of players and transform your Terraria experience today.

Download Free Now View Guides

No credit card required • 100% Free Forever • 5M+ Downloads