Terraria Mod Menu

A desktop Mod Menu for Terraria Vanilla and tModLoader.

Install the complete runtime once, then enable, disable, and configure supported features from the in-game ImGui menu without repatching for every change.

---

Application

The desktop app keeps Vanilla and tModLoader independent. Each target has its own game path, backup, patched assembly, runtime directory, configuration, repair flow, and original-file restoration.

Game Targets

Terraria Vanilla	tModLoader
Patches Terraria.exe and installs TerrariaModMenu/.	Patches tModLoader.dll and installs tModLoaderModMenu/.

Both targets install the same official feature set. Their implementation remains separate so a tModLoader update cannot overwrite or contaminate the Vanilla runtime, and vice versa.

Features

Terraria Mod Menu currently bundles 63 official modules across the in-game interface. Highlights include:

• Player and combat: God Mode, movement and survival tuning, class damage, critical chance, armor penetration, attack speed, Aim Assist, Homing Bullets, Projectile Wall Hack, Infinite Ammo, One Hit Kill, minions, and turrets.
• Movement and travel: infinite flight and cloud jumps, no-clip, map and cursor teleportation, saved positions, Pylons Everywhere, and Journey Everywhere.
• Items and crafting: searchable item spawning, replication, prefixes, infinite consumables, functional banks, creative crafting, crafting range, Journey research controls, and complete boss-bag drops.
• World and NPCs: time, weather, events, plant growth, Hardmode and boss progression, searchable boss and NPC selectors, Bestiary controls, shops, and fishing tools.
• Visibility and ESP: Full Bright, flashlight, camera zoom, NPC/item/chest/ore overlays, tracers, off-screen indicators, distance labels, boss HUD, loot heatmap, movable radar, and configurable sprite highlighting.
• Runtime experience: searchable selectors, translated controls, contextual tooltips, persistent settings, diagnostics, and dated runtime logs.

The complete feature catalog is available in the application's Changelog.

Multiplayer Scope

Features are labeled according to who controls the affected game state:

Scope	Meaning
Local / Character	Runs locally or changes your own character. The server may still validate character actions.
Host only	Requires you to host the world because the host owns world, NPC, event, tile, and progression state.
External server	Only local presentation features are expected to work reliably. Third-party servers are unsupported.

Terraria Mod Menu does not include a server-side component. Using it on a third-party server is entirely at your own risk, may violate that server's rules, and can result in moderation or a ban. The project does not provide support for third-party server use.

Platform Support

Capability	Windows	Linux	macOS
Desktop application	Validated	Validated	Not validated
Vanilla installation and runtime	Validated	Validated	Not validated
tModLoader installation and runtime	Validated	Validated	Not validated
Packaged auto-updates	Available	Available	Not validated

macOS status: macOS has not been validated yet. The app may install or open there, but patching and runtime behavior may not work properly until they are tested on real macOS Terraria installations.

Supported game targets for version 1.0.0:

• Terraria Vanilla 1.4.5.6
• tModLoader v2026.3.3.0, running Terraria 1.4.4.9

Newer detected versions are presented as untested and require explicit user confirmation before patching.

Desktop Experience

• English and Brazilian Portuguese with first-launch language detection
• Light, dark, and system themes
• First-run onboarding and restartable guided tour
• Responsive layout and toast feedback for application actions
• Automatic and manual game-path detection on each target page
• Clean backup, original-file restore, and runtime repair workflows
• Profile import/export and an opt-in advanced runtime JSON editor
• Packaged update checks and background update installation

The JSON editor is intended for advanced users and is hidden by default. Runtime state files are not exposed for editing. The removed legacy plugin workflow is not part of the current product.

Architecture

React renderer
  -> typed Electron preload API
     -> Electron main process
        -> self-contained .NET 10 bridge over JSON-RPC
           -> Mono.Cecil patches the selected game assembly
              -> target-specific in-game runtime and shared contracts

The distributed bridge is self-contained. End users do not need to install a system-wide .NET Runtime or SDK. See docs/mod-menu-architecture.md for the detailed installation and runtime contracts.

Technology

Layer	Technology
Desktop runtime	Electron
Interface	React 19 and TypeScript
Components	shadcn/ui with Base UI
Styling	Tailwind CSS v4
Build tooling	electron-vite and Vite
Internationalization	i18next and react-i18next
Persistence	electron-store
Auto-updates	electron-updater
Patching bridge	Self-contained .NET 10 C# subprocess
IL manipulation	Mono.Cecil

Development

Requirements

• A current Node.js LTS release
• pnpm
• .NET 10 SDK when compiling the C# bridge from source

The .NET SDK is a contributor requirement because pnpm dev rebuilds the bridge. It is not an end-user prerequisite.

Setup

git clone https://github.com/loadsec/Terraria-Mod-Menu-PC.git
cd Terraria-Mod-Menu-PC
pnpm install
pnpm dev

Validation

pnpm run check
pnpm run build:renderer

pnpm run check runs ESLint, TypeScript validation, automated tests, and the shared Vanilla/tModLoader runtime contract verification.

Distribution Builds

pnpm build:win
pnpm build:linux
pnpm build:mac

The macOS build target exists for development purposes but remains unvalidated.

Project Structure

src/
  main/                         Electron main process and C# patching bridge
  preload/                      Typed renderer-to-main API
  renderer/src/                 React desktop interface and translations
  mod-menu-runtime-shared/      Contracts and runtime code shared by both targets
  mod-menu-runtime/             Terraria Vanilla runtime
  tmodloader-mod-menu-runtime/  tModLoader runtime
resources/
  patcher-bridge/               Self-contained bridge binaries
  mod-menu-runtime/             Built Vanilla runtime assets
  tmodloader-mod-menu-runtime/  Built tModLoader runtime assets
docs/
  mod-menu-architecture.md       Installation, hook, and runtime contracts
  LOCAL-ARTIFACTS.md             Policy for generated and local-only files
version.json                    Product and tested-target manifest

Inspiration and Credits

This project is heavily inspired by the original Terraria Patcher by Doug Benham. His work established the Mono.Cecil-based Terraria patching foundation that this project evolved into a separate Mod Menu platform for Vanilla and tModLoader.

Contributing

Pull requests are welcome. Shared features and runtime changes must be implemented and verified for both Terraria Vanilla and tModLoader unless they are explicitly target-specific.

Contributors with access to a real macOS Terraria installation can help validate the currently untested macOS path.

License

Released under the MIT License.