Official Terraria Modding API
The ultimate open-source Terraria modding framework and platform. Download free, create amazing mods with C# API, discover 5000+ community mods through Steam Workshop integration, and enjoy cross-platform support on Windows, macOS, and Linux.
The most powerful and user-friendly modding platform for Terraria, trusted by millions of players and thousands of developers worldwide
Seamlessly browse, install, and manage thousands of mods directly through Steam Workshop. Automatic updates ensure you're always playing the latest versions.
Complete C# API with in-game development workflow. Build, test, and publish mods without leaving Terraria using our hot-reload system.
Available on Windows, macOS, and Linux. Play your favorite mods anywhere Terraria runs.
Advanced dependency management ensures mods load correctly and work together without conflicts.
Full multiplayer support with synchronized mod sets. Play with friends seamlessly.
MIT licensed and community-driven. Transparent development with contributions welcome.
tModPorter automatically migrates older mods to newer API versions with intelligent assistance.
Comprehensive guides, ExampleMod, and extensive documentation to get you started quickly.
Whether you're looking to enhance your gameplay or create the next big mod, tModLoader has everything you need
Browse and install mods directly from the in-game browser
Never worry about outdated mods with Steam integration
Save and share curated collections of your favorite mods
Full access to Terraria's systems with extensive documentation
Learn from comprehensive examples covering all mod types
Test changes instantly without restarting the game
Built with modern development practices and industry standards
Regular updates aligned with Terraria 1.4.x
Safe mod execution with review processes
Optimized loading and minimal overhead
Made by modders, for modders
Download tModLoader and start exploring thousands of amazing mods
Official release - appears as separate game in library
For GOG, manual installs, and older versions
Most popular mods work with this version
Limited mod compatibility
For older mods and compatibility
System Requirements: Windows 7+, macOS 10.12+, Ubuntu 16.04+
Discover what makes tModLoader the ultimate modding platform for Terraria
TML makes it incredibly easy to install Terraria mods. Simply download the desired mod and add it to your mod list with just a few clicks.
Convenient interface for managing installed mods. Easily enable/disable mods and change their load order for optimal compatibility.
Complete tools for creating custom mods. Add new game elements, modify mechanics, and create entirely new features with our C# API.
TML automatically updates installed mods when new versions are available, ensuring you always have the latest features and bug fixes.
Large community of developers and users providing help, advice, and support for using mods and creating your own content.
Compatible with most Terraria mods without requiring special settings. Works seamlessly across different platforms and configurations.
To play together, all players must have tModLoader installed. Vanilla Terraria users cannot join tModLoader servers and vice versa. Make sure all friends have the same mods enabled for the best multiplayer experience.
Some mods can significantly change gameplay and greatly increase difficulty. Players should carefully review mod descriptions and choose mods that match their preferred play style and skill level.
If you encounter installation issues, check our troubleshooting guide. 90% of common problems have documented solutions in our comprehensive FAQ and installation guides.
Everything you need to start creating amazing Terraria mods with C# and our comprehensive API
Complete stable API reference with annotated classes, namespaces, and attributes.
Browse API DocsComprehensive how-tos, tutorials, and concepts to get you started with mod development.
Visit WikiSource code, ExampleMod, releases, issues, and pull requests. MIT licensed.
View on GitHubVisual Studio 2022, JetBrains Rider, or your preferred C# IDE. Create mod stubs in-game.
Setup GuideLearn from comprehensive examples: items, NPCs, projectiles, world gen, UI, and more.
Browse ExamplesGet your first mod up and running in minutes
Install tModLoader and launch once to create mod directories
Use in-game Workshop/Develop tools to create your mod template
Use "Build + Reload" for hot-reloading during development
Discover some of the most popular and exciting mods across different categories
216 mods
174 mods
71 mods
61 mods
40 mods
16 mods
Adds over 1,000 new items, 20+ bosses, and countless hours of post-Moon Lord content with unique mechanics.
Adds two new classes (Healer & Bard) and tons of balanced content for every stage of the game.
Revolutionary storage system with crafting integration and unlimited capacity for all your items.
Comprehensive recipe viewer and item browser with search functionality and mod integration.
Track your boss progression with an in-game checklist that works with modded bosses.
Quality of life improvements and boss summoning items with extra challenge modes.
Connect with fellow modders, get help, and share your creations