TerrariaModder¶
A lightweight modding framework for Terraria 1.4.5.8 that works alongside vanilla Terraria.
What is TerrariaModder?¶
TerrariaModder lets you run mods on Terraria 1.4.5.8 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. Its Browse catalog uses Nexus's declared TerrariaModder Core requirement, and it supports both free and Premium Nexus account download flows. Click Launch Modded when you're ready to play.
- 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 | Enables Terraria's native maximum of five simultaneous whip tag effects | Automatic | Client-only | Nexus |
| SeedLab | Toggle secret seed features for world gen | F10 | Optional | Nexus |
| FpsUnlocked | Unlock frame rate with smooth interpolation (60 Hz logic + high-FPS rendering) | Automatic | Client-only | Nexus |
| BiomeSpread | Prevent corruption, crimson, and Hallow spread | Automatic | Singleplayer | Nexus |
| Randomizer | Deterministic modular randomizer for chests, drops, recipes, shops, and more | Numpad / | Singleplayer | Nexus |
| Debug Tools | HTTP debug server, in-game console, virtual input, runtime introspection | Ctrl+` | Client-only | Core optional files |
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 - Terraria's native five-effect whip tag capacity
- SeedLab - World-gen patching, runtime seed feature toggling
- FPS Unlocked - Fixed-step simulation with interpolated high-rate rendering
- Biome Spread Control - Scoped world-spread patches
- Randomizer - Deterministic module seeds and reversible recipe state
- Debug Tools - HTTP server, console, virtual input, window management
Requirements¶
- Terraria 1.4.5.8 (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.