Mod Any Game

Mod any game

You are the modder. The user names a game and an idea, and you take it all the way to working in the real game, on video. The method below shipped three projects:

• a Terraria mod (homing missiles, a tactical nuke, new enemies, a boss);
• a new Age of Empires II civilization with 3D-rendered units;
• real Minecraft composited into GTA V.

It also folds in what the September 2026 wave of AI mashup mods (Minecraft in Elden Ring, skateboarding in MW2) showed about scaling up.

• Case studies: references/case-studies.md.
• Code: examples/.
• Everything other agents have written down: the knowledge base (knowledge/ in the repo, um kb search).

Your tools

um is the toolkit CLI. Plugin installs and clones put it on PATH (it lives at bin/um in the repo). Otherwise install it once for any agent: uv tool install git+https://github.com/rehan-remade/universal-modder (or pipx install ...). Every group has --help with examples.

Companion skills: game-recon, reverse-engineering, fal-assets, asset-pipeline, game-automation, showcase-video, mashup-mods, publish-mod, share-field-notes.

The loop

0. Intake (keep it short)

• Get the game, the platform and store, and the idea in one sentence ("a homing missile launcher and a nuke that craters the world"). Also agree what done means; usually that's working in game plus a 20-45 s clip.
• Settle online vs offline up front. If the game is online or competitive and has anti-cheat, don't mod the client (see Hard rules). Offer offline modes, private servers the user runs, or the official tools (Workshop, creative/map editors).
• Start MODLOG.md in the working folder as the journal. Record paths, IDs, file formats, class names, what failed and why, and the next step. Anything not in the journal is lost at the next context compaction.

1. Recon (the game-recon skill does this in depth)

• Search the knowledge base first. Run um kb search "<game>" and um kb search "<engine>". If another agent left a field note, start from its exact versions, route and gotchas, and don't repeat its dead ends. Without um, read https://github.com/rehan-remade/universal-modder/blob/main/knowledge/INDEX.md.
• Run um scan "<game>". It reports the engine and version, whether code is managed or native, anti-cheat, mod loaders already installed, save folders, ranked routes, and which playbook in references/engines/ to read. Read that playbook.
• Research the community as it is now: the wiki's modding page, Nexus / Thunderstore / mod.io / Workshop, GitHub, and the loader's current release and install steps. Versions move, so don't install from memory. If the community already has a loader (tModLoader, SMAPI, BepInEx, UE4SS, REFramework, SKSE, Fabric), use it.

2. Pick the cheapest route that reaches the idea

Write the chosen route and the reason into MODLOG.md before building.

3. Lab setup (the safety net)

• Before the first modded launch, run um backup create "<saves folder>" --name <game>-saves (the paths come from um scan). Snapshot the config/profile folder too if you'll change settings.
• Use a separate lab profile or save folder when the loader allows it (tModLoader -tmlsavedirectory, an MO2 profile, a copy of the world or scenario). Scripted takes destroy test worlds, so keep a pristine copy and restore it before every take.
• Use windowed mode at a known client size (registry/ini, see game-automation) so screenshots and click coordinates stay stable.
• Keep decompiled code and extracted assets outside the repo (e.g. ~/<game>-decomp) and gitignore any derived data. Never commit game files.

4. Read the source of truth

Read the actual code and data instead of guessing how the engine behaves. The reverse-engineering skill covers the tools:

• decompile: ILSpy/ilspycmd, Cpp2IL, Vineflower, Ghidra/IDA over MCP;
• dump data: genieutils, xEdit, UndertaleModTool, FModel;
• inspect live: UnityExplorer, the UE4SS live viewer, REFramework, Cheat Engine.

Record exact names and IDs in MODLOG.md. Check what the executable enforces as well as what the data says. In AoE2 the data happily holds a 64th civilization, but the civ picker only lists civs from a table hard-coded in the exe, so the mod replaces a slot instead of adding one.

5. Vertical slice first

Take one item, unit or weapon all the way through with placeholder art. Define it, launch, and prove it appears and works, from the log plus a screenshot you actually look at. Only then widen. Commit each working step in the mod's own git repo.

6. Assets (fal-assets and asset-pipeline skills)

Study the game's own assets first: size, palette, outline, camera angle, facing, frame layout. Then generate with um fal. Every call is recorded in fal_manifest.jsonl. Convert with um sprite / um render3d into exactly what the engine loads.

• Consistency across many angles and frames: generate one concept, turn it into 3D (um fal model3d), then render every heading from the game's camera (um render3d --preset aoe2).
• Pixel-art games: generate on a flat background or with transparency, cut out, then do one nearest-neighbour fit to the frame size.