TerrariaModder¶
A lightweight modding framework for Terraria 1.4.5 that works alongside vanilla Terraria.
What is TerrariaModder?¶
TerrariaModder lets you run mods on Terraria 1.4.5 without waiting for tModLoader. It's designed for quality-of-life mods, utilities, automation, and custom content (new items with custom textures, recipes, shops, and drops via the Custom Assets system).
Key Features: - In-game mod menu (F6) for configuration and keybind rebinding - Widget Library for building mod UIs (panels, buttons, sliders, scroll, text input) - Lifecycle hooks for deterministic mod initialization (OnGameReady, OnContentLoaded, etc.) - Automatic Harmony patch application: attribute patches work without boilerplate - Hot reload support for config changes (no restart needed) - Keybind persistence across game restarts - Per-mod configuration with JSON schemas - Colorblind-friendly theme support (normal, red-green, blue-yellow, high-contrast)
For Players¶
Want to install and use mods?
The easiest way is the TerrariaModder Vault — the official mod manager. Install it once, then click to add or update any mod. Hit Run Modded to launch.
- Installation Guide - Get up and running (Vault or manual)
- Troubleshooting - Fix common issues
- Available Mods - What's available
Available Mods¶
Download Core and any mods you want from Nexus Mods, or install them all through the Vault in one place. Each mod is a separate download.
| Mod | Description | Keybind | Multiplayer | Download |
|---|---|---|---|---|
| ModMenu | In-game configuration UI for all mods (built into Core) | F6 | All modes | Included in Core |
| SkipIntro | Skips the ReLogic splash screen on startup | Automatic | Client-only | Nexus |
| QuickKeys | Auto-torch, recall hotkey, quick-stack, ruler, extended hotbar (opt-in) | Tilde, Home, End, K | Client-only | Nexus |
| AutoBuffs | Automatically applies nearby furniture buffs | Automatic | Client-only | Nexus |
| PetChests | Right-click any cosmetic pet to access piggy bank | Right-click | Client-only | Nexus |
| ItemSpawner | Spawn any item (admin or granted players in MP) | Insert | Optional | Nexus |
| StorageHub | Unified storage with crafting, recipes, shimmer, mysterious chest, relay network | F5 | Required | Nexus |
| AdminPanel | God mode, movement speed, teleports, time controls, respawn settings | Backslash, F9 | Optional | Nexus |
| WhipStacking | Restores pre-1.4.5 whip tag stacking | Automatic | Client-only | Nexus |
| SeedLab | Toggle secret seed features for world gen | F10 | Optional | Nexus |
| FpsUnlocked | Unlock frame rate with smooth interpolation (60hz logic + high-FPS rendering) | Automatic | Client-only | Nexus |
| BiomeSpread | Toggle evil biome spread on or off | Automatic | Client-only | Nexus |
| Randomizer | Modular randomizer with seed system — shuffle chests, drops, recipes, shops | Numpad / | Optional | Nexus |
| DebugTools | HTTP debug server (70+ endpoints), in-game console, virtual input, runtime introspection | Ctrl+` | Client-only | — |
Press F6 in-game to configure mods and rebind keys. Changes are saved automatically and keybinds persist across game restarts.
For Modders¶
Want to create mods?
- Making Your First Mod - Step-by-step tutorial
- Harmony Basics - Runtime patching guide
- Tested Patterns - Proven techniques from real mods
- Core API Reference - Framework APIs
- The Vault - Making your mod installable via the official mod manager
- Publishing Your Mod - Distribution guide
Mod Walkthroughs¶
Learn by studying real, working mods:
- SkipIntro - Harmony patch with lifecycle hooks
- AutoBuffs - Tile scanning and buff application
- QuickKeys - Complex input handling and reflection
- PetChests - Projectile interaction
- ItemSpawner - Full UI implementation
- StorageHub - Multi-tab storage, crafting, shimmer, mysterious chest, relay network
- AdminPanel - UI sliders, Harmony patches, boss detection
- WhipStacking - Harmony prefixes, restoring removed mechanics
- DebugTools - HTTP server, console, virtual input, window management
- SeedLab - World-gen patching, runtime seed feature toggling
Requirements¶
- Terraria 1.4.5 (Steam version)
- Windows
Quick Links¶
- Nexus Mods
- GitHub Repository (source code)
- Report Issues
Credits¶
Author: Inidar
Built on TerrariaInjector by ConfuzzedCat. Uses Harmony by pardeike and Mono.Cecil by jbevain.