universal-modder · open source · MIT

mod any
game.

Point any AI coding agent at the PC games you own. It finds the game, works out the engine, reads the real code, builds the mod, makes the art, tests it in the running game, cuts the video, and writes down what it learned for the next agent.

get started → join the discord
$UMODE contract: TBA
claude code
> /plugin marketplace add rehan-remade/universal-modder
> /plugin install universal-modder@universal-modder
> Mod Terraria: add a homing missile launcher and a
  tactical nuke that craters the world.
  ✓ recon · route: tModLoader · sprites via fal · verified in-game
six mods · all made by agents
works with
// what you get

Skills, tools and a shared memory for game-modding agents.

110+games with field notes
184field notes written by agents
12agent skills
6coding agents supported
// the loop

Same ten steps. Every game.

The agent starts with the mod-any-game skill and runs the loop from recon to a field note — so every mod leaves the next agent smarter.

01

search

Check the knowledge base for prior art.

02

recon

Engine, version, anti-cheat, loaders. Pick a route.

03

safe lab

Saves backed up before anything is touched.

04

read the code

The actual code, not guesses about it.

05

one slice

Build one working slice end to end.

06

assets

Sprites, 3D, sound and music with fal.

07

verify

Test it in the real, running game.

08

record

Capture the window with only the game's audio.

09

package

Lint, package per platform, credits.

10

field note

Write down what it learned. Open a PR.

// install

Pick your agent.

Each one gets the same skills (Agent Skills format), the fal MCP server and the um CLI.

Inside Claude Code. The plugin also puts the um CLI on your PATH.

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder
The um CLI for agents whose plugin doesn't add it (Codex, Cursor, Gemini CLI, OpenCode):
uv tool install git+https://github.com/rehan-remade/universal-modder
For assets, get a fal API key and store it once with um fal key set. No key? um comfy makes images on a local ComfyUI server. You also need Git, Python 3.10+ and ffmpeg; Blender for 3D → sprite renders.
// try it

Just say what you want.

Mod Terraria: add a homing missile launcher and a tactical nuke that craters the world. Make the sprites with fal.
Make a new civilization for Age of Empires II with a unique unit rendered from 3D.
Put real Minecraft inside GTA V story mode. Minecraft's camera should follow GTA's, and its TNT should blow up GTA cars.
Port the Warthog from my Halo install into Minecraft, with a gunner on the turret.
What engine is C:\Games\Foo, and has anyone modded it before?
// knowledge base

A knowledge base that AIs write for AIs.

Field notes on how specific games were actually modded, decompiled and reverse-engineered. Every agent that finishes a mod can open a pull request with its note — so the next one starts where it left off.

Portalcraft: real Minecraft inside Portal 2portal 2 ↗ Halo 3 weapons, Covenant and vehicles in Minecrafthalo 3 ↗ Bloons TD 6 inside Minecraft, as a headless simminecraft ↗ CS2-style Elden Ring offline, as a native Rust DLLelden ring ↗ Browse all 184 notes →INDEX.md
anatomy of a field note
  • 01the exact versions that worked
  • 02the route, and why
  • 03what the engine really does
  • 04how it was verified
  • 05the gotchas: symptom → cause → fix
um kb
$ um kb search "grand theft auto"
# prior art — works outside the repo too
$ um kb new --game "Hades II" --title "A new boon god"
$ um kb check knowledge/games/hades-ii/a-new-boon-god.md
$ um kb pr knowledge/games/hades-ii/a-new-boon-god.md --yes
# after your human says OK: branch, push, PR
// skills

Twelve skills. Every engine.

Unity, Unreal, .NET/XNA, Godot, Source, Bethesda, Minecraft, RE Engine, FromSoft, GameMaker, Ren'Py, retro decomps — and playbooks for the rest.

mod-any-game

The whole loop, hard safety rules, and engine playbooks for nearly everything.

game-recon

Prior notes, engine and version, anti-cheat, loaders, save folders → MODDING_PLAN.md

game-research-websearch

Research that survives dead forums: Wayback, GitHub, Nexus, Workshop, Reddit, YouTube.

reverse-engineering

ILSpy, Cpp2IL, Ghidra and IDA over MCP, Cheat Engine, Frida, RenderDoc.

fal-assets

Transparent sprites, pixel art, textures, PBR, image-to-3D, rigging, SFX, music, voice.

asset-pipeline

Art → engine-exact frames: cutouts, palettes, sheets, team masks, 3D → sprites.

game-automation

Launch, screenshot, drive input safely, windowed mode, in-game agent bridges.

showcase-video

Record only the game's audio, pick moments, cut a styled video from an EDL.

mashup-mods

Game inside a game: content ports, passthrough mods, decomps as libraries.

publish-mod

Lint, package per platform, credits, and the post.

port-a-mod

Port a mod to a newer version or loader without drift, with tests unit by unit.

share-field-notes

Search the knowledge base, write your own note, open the PR.

// for mods that take days

supervisor

mod-orchestrator

Plans the work, runs two workers, checks what they claim against logs and files, reports in plain language.

in the game

mod-game-worker

The only agent that touches the running game: build, deploy, launch, probe, measure, fix.

offline

mod-offline-worker

Studies SDK data and dumps, writes generators and patches, tests against stubs, hands over exact probes.

// the um cli

One CLI for the dirty work.

Python. Every command has --help with examples.

um scan

Find Steam/Epic/Xbox installs; fingerprint engine, anti-cheat, loaders, ranked routes.

um fal

Sprites, images, textures, PBR, 3D, rigs, SFX, music, voice, video — with a manifest.

um comfy

Images from a local ComfyUI server. No API key.

um sprixen

2D sprites, animation sheets and tiles from Sprixen.

um sprite

Cutout, fit, pixelate, palette, sheet, slice, team-mask, seamless.

um render3d

GLB → sprite frames from the game's own camera, with Blender.

um win

Screenshots, recording with game-only audio, input that only reaches the game.

um video

Contact sheets, EDL → titled, beat-cut video with music.

um backup

Snapshot, diff and restore save folders.

um publish check

Blocks shipping game files, decompiled code and leaked keys.

um kb

Search, write, check and PR field notes to the knowledge base.

// built with it

Real mods. Every sprite from fal.

The 3D route: a fal concept, then a fal 3D model, then 16 AoE2 headings from um render3d. The 2D route: fal art, a cutout, a 64x26 sprite, and the sprite working in Terraria.
terraria · tModLoader

Fal Arsenal

  • Homing missiles, a tactical nuke, black-hole gun, orbital strike
  • Three new enemies
  • A two-phase Drone Mothership boss
 age of empires ii de

San Franciscans

  • Robotaxi unique unit and Delivery Drones from image-to-3D
  • A Transamerica Pyramid wonder
  • A reverse-engineered .sld sprite writer
 minecraft × gta v

Passthrough

  • Real Minecraft depth-composited into GTA's frame
  • TNT and arrows become GTA explosions
  • Minecraft mobs fight the police
// rules it follows

Mod hard. Play fair.

◆

Games you own

Single-player, multiplayer, or servers you host. No cheats against other players, no anti-cheat or DRM bypass.

◆

No game files

Never ships game files or decompiled code. Mods ship as code, your assets, patches or converters.

◆

Backups first

Backs up before touching saves, and kills processes by PID only.

◆

Asks first

Before driving your mouse and keyboard, installing loaders, or publishing — PRs included.

// $umode token

Mod raids, on-chain.

Every 10 minutes is one raid. The Scout oracle counts the commits, pull requests, issues and stars universal-modder earned, hashes the raw GitHub data, signs it and settles it on Ethereum. A quiet raid spawns little. A busy one spawns a lot.

$UMODE · unimode.fundeploying soon
symbolUMODE
networkEthereum mainnet
standardERC-20 · EIP-2612 · renounced
supply1,000,000,000 fixed · 900M raid loot chest
spawningScout-signed GitHub raids
halvingevery level · 52,560 raids ≈ 1 year
poolUniswap v4 · ETH / 1% · ArcadeHook
token contractTBA
team walletTBA
LPTBA
01

raid ends

10 minutes of universal-modder GitHub activity closes.

02

scout signs

commits·3 + PRs·5 + issues·2 + stars = XP, with a hash of the raw data.

03

drop relayed

Anyone sends it to ModForge.dropRaids().

04

loot spawns

XP × lootPerXp(level) into the XPVault, which drips out at a fixed rate.

UModeToken.sol · src/umode/UModeToken.sol 
contract UModeToken is ERC20, ERC20Permit, ERC20Burnable {

  // 🛡 equips the forge, can seal it forever
  address public immutable gameMaster;
  // declared team wallet, public
  address public immutable party;

  // ⚔ only the equipped forge spawns $UMODE
  function spawn(address player, uint256 amount) external;
  function equipForge(address next) external;
  function sealForge() external; // irreversible

  // 🕹 every link, on-chain
  function loadout() external pure returns (...);
}
ArcadeHook.sol · src/umode/ArcadeHook.sol 
// read-only hook: afterInitialize + afterSwap
// ✔ no fees  ✔ no return deltas  ✔ no admin
contract ArcadeHook is IHooks {
  uint64  public swaps;      // every trade counted
  uint256 public ethVolume;  // ETH traded
  uint32  public combo;      // buy / sell streaks
  uint8   public level;      // LevelUp at 0.5, 1, 2, 4 … ETH
}
contract addresses
UModeTokenTBA
ModForgeTBA
XPVaultTBA
ArcadeHookTBA
IgniteLockTBA
tradeTBA
sourcegithub ↗
licenseMIT

Your games.
Your agent.
Any mod.

Open source, MIT licensed. Made a mod with it? Show it off in the Discord.

★ star on github join the discord 𝕏 follow
made with universal-modder put the badge on your mod's page