A lightweight modding framework for Terraria 1.4.5. No tModLoader required.
Get the latest release from Nexus Mods, or follow build instructions below. Extract to your Terraria folder and run TerrariaInjector.exe.
TerrariaModder is built to be modder-friendly. Everything you need to get started:
- Wiki & Guides — Installation, first mod tutorial, Harmony basics, API reference, and walkthroughs of every included mod
- Starter Template — Ready-to-build mod template so you can have a working mod in minutes
- Example Mods — Every mod in this repo is open source with full source code. Use them as reference for real-world patterns
- Built-in UI Library — Panels, buttons, sliders, text fields, scrollable lists, tabs, and automatic colorblind support
- Automatic Config UI — Define config fields and the mod menu generates the settings UI for you
A GUI mod manager app is coming soon.
| Mod | Description | Default Key | Download |
|---|---|---|---|
| ModMenu | In-game mod configuration | F6 | Included in Core |
| SkipIntro | Skips the ReLogic splash screen | (auto) | Nexus |
| QuickKeys | Auto-torch, recall, quick-stack, ruler, extended hotbar (opt-in) | Tilde, Home, End, K | Nexus |
| ItemSpawner | In-game item spawner | Insert | Nexus |
| AutoBuffs | Automatically applies furniture buffs | (auto) | Nexus |
| PetChests | Use pets as portable piggy banks | (right-click) | Nexus |
| StorageHub | Unified storage with crafting, recipes, shimmer decraft, mysterious chest, relay network | F5 | Nexus |
| AdminPanel | God mode, movement speed, teleports, time controls, respawn | Backslash, F9 | Nexus |
| WhipStacking | Restores pre-1.4.5 whip tag stacking | (auto) | Nexus |
| SeedLab | Toggle secret seed features for world gen (WIP) | F10 | Nexus |
| FpsUnlocked | Unlock frame rate with smooth interpolation | (auto) | Nexus |
| BiomeSpread | Visualize and control evil biome spread | (auto) | Nexus |
| Randomizer | Modular randomizer with seed system — shuffle chests, drops, recipes, shops, and more | Numpad / | Nexus |
Optional (for mod developers):
| Mod | Description | Default Key | Download |
|---|---|---|---|
| DebugTools | Debug HTTP server, in-game console, virtual input, window management | Ctrl+` | Nexus (optional file) |
TerrariaModder has full multiplayer support:
- Host & Play — host from your game client, automatic admin for the host
- Dedicated Server — headless server with HTTP management API and console commands
- Admin System — promote/demote players, per-mod access grants, ban/kick
- Server Console —
/op,/kick,/ban,/grant,/time,/config, and more - Config Scoping —
[Server]properties sync across all players,[Client]stays local
Each mod's page notes its multiplayer compatibility (required, optional, or client-only). Mods with custom items are automatically required for all connected clients.
Requires .NET SDK and the .NET Framework 4.8 Developer Pack. Both are included with Visual Studio 2022.
# Build all mods
dotnet build src/Core/TerrariaModder.Core.csproj -c Release
dotnet build src/SkipIntro/SkipIntro.csproj -c Release
# ... etc for each mod in src/Each mod builds to a single DLL. Place them in Terraria/TerrariaModder/mods/<mod-id>/ alongside their manifest.json.
See the Wiki for guides and reference, or browse the docs directly:
- Installation Guide
- Making Your First Mod
- Core API Reference
- Harmony Basics
- Tested Patterns
- Troubleshooting
Special thanks to ConfuzzedCat for TerrariaInjector, the injector that makes this entire project possible. Included in releases with their permission; check out the source at their repo.
Built with Harmony (runtime patching) and Mono.Cecil (assembly inspection), both MIT licensed.
MIT License