Installation Guide
Complete installation instructions for all platforms and methods
10 min read
Installation
Updated Sept 2025
Direct Download
Download and install tModLoader directly on your Windows PC:
Download tModLoader Setup (MSI)
Installation Instructions
- Click the download button above to download the installer
- Once downloaded, double-click the
tmodloader_setup.msifile - Follow the installation wizard to complete the setup
- Launch tModLoader from your Start Menu or Desktop shortcut
What You Get
- Complete tModLoader installation
- Easy setup wizard for Windows
- Access to thousands of mods
- Built-in mod browser
Version Information
LATEST v2025.07.3.0
- • Terraria 1.4.4.9
- • 46.5 MB download
- • Monthly auto-release
STABLE v2025.06.3.0
- • Terraria 1.4.4.9
- • 46.3 MB download
- • Most mods compatible
LEGACY v2022.09.47.87
- • Terraria 1.4.3.6
- • 35.4 MB download
- • For older mods
Common Installation Issues
"Unable to load tModLoader" Error
This usually indicates missing dependencies or incorrect installation.
- Ensure .NET Framework 4.7.2 or later is installed (Windows)
- Install Mono framework (macOS/Linux)
- Verify Terraria is properly installed
- Run as administrator (Windows)
Mod Folder Not Found
tModLoader creates mod folders on first launch. If missing:
Windows: Documents/My Games/Terraria/tModLoader/
macOS: ~/Library/Application Support/Terraria/tModLoader/
Linux: ~/.local/share/Terraria/tModLoader/
macOS: ~/Library/Application Support/Terraria/tModLoader/
Linux: ~/.local/share/Terraria/tModLoader/
Mod Browser Won't Load
If the mod browser shows connection errors:
- Check your internet connection
- Disable antivirus/firewall temporarily
- Try using Steam version for Workshop integration
- Wait a few minutes and try again (server may be busy)