Airsc is free for everyone. If it helps you, support it with $2–$20.

Support
VISign in
PluginSafeImages, video & audioSome setup

universal-modder

rehan-remade · rehan-remade/universal-modder

Enables AI coding agents like Claude Code to mod almost any PC game by performing recon, reverse engineering, creating assets, and testing.

Point Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.

4.6k stars414License: MITUpdated 12 days ago0 opens

See it in action

Halo Warthog mod generated and running in Minecraft

From the author's READMEHalo Warthog mod generated and running in Minecraft

1/2

From the author's README rehan-remade ·Source

What you can do with it

  • Automatically generate new 3D models or textures for a game mod.
  • Reverse engineer game files to understand their structure and identify modding opportunities.
  • Create custom audio effects or background music for a game's modified levels using fal.

Safety check

Safe

No risky patterns found in the files we scanned.

Automated scan of the repo files. Always review code you run.

From the README

Skills, tools and a shared knowledge base that let any AI coding agent mod almost any PC game you own. The agent finds the game, works out the engine and the route, reads the real code, builds the mod, makes art, 3D and sound with fal, tests it in the running game, cuts the video, and writes down what it learned for the next agent.

Coming next: the mod hub. Publish your mods, remix other people's, and make new ones.

Install

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

AgentInstall
Claude Code/plugin marketplace add rehan-remade/universal-modder``/plugin install universal-modder@universal-modder
Codexcodex plugin marketplace add rehan-remade/universal-modder``codex plugin add universal-modder@universal-modder
Gemini CLIgemini extensions install https://github.com/rehan-remade/universal-modder
VS Code / CopilotEnable chat.plugins.enabled, run Chat: Install Plugin From Source, and enter this repo's URL
CursorCursor Marketplace, or clone (Cursor reads AGENTS.md and .cursor/mcp.json)
OpenCodeClone and run opencode inside it (opencode.json adds the skills and the fal MCP server)
Skills only(any agent)npx skills add https://github.com/rehan-remade/universal-modder
Anything elsegit clone https://github.com/rehan-remade/universal-modder and start your agent inside it

Inside a clone, each agent finds the skills where it looks for them: .agents/skills (Codex, Gemini CLI, Copilot, Cursor, OpenCode) and .claude/skills (Claude Code) are copies of skills/. Instructions are in AGENTS.md, which CLAUDE.md and GEMINI.md point to. MCP config is in .mcp.json, .codex/config.toml, .cursor/mcp.json, .vscode/mcp.json and opencode.json (which also points OpenCode at skills/).

The um CLI. Plugin installs and clones put it on PATH. Anywhere else:

uv tool install git+https://github.com/rehan-remade/universal-modder     # or: pipx install git+...

For assets, get a fal API key. It powers both the fal MCP server and um fal (for images without a key, um comfy uses a local ComfyUI server):

export FAL_KEY=...

You also need Git, Python 3.10+ and ffmpeg. uv is recommended. Blender is needed for 3D → sprite renders. Windows games are driven natively or from WSL.

Try it

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?

The agent starts with the mod-any-game skill and runs the same loop every time:

  1. search the knowledge base;
  2. recon, then pick a route;
  3. set up a safe lab (saves backed up);
  4. read the actual code;
  5. build one working slice;
  6. generate assets;
  7. verify in the real game;
  8. record;
  9. package;
  10. write a field note for the next agent.

A knowledge base that AIs write for AIs

knowledge/ holds field notes: how specific games were actually modded, decompiled and reverse-engineered. Each note gives:

  • the exact versions that worked;
  • the route, and why;
  • what the engine really does;
  • how it was verified;
  • the gotchas (symptom → cause → fix).

Every agent that finishes a mod can open a pull request with its note, so the next agent starts where it left off instead of rediscovering the same traps.

um kb search "grand theft auto"                 # before you start: prior art (works outside the repo too)
um kb new --game "Hades II" --title "A new boon god" --from-scan hades --agent "Codex (gpt-6)"
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

Browse knowledge/INDEX.md. Every game is welcome. Contribution rules, for humans and AIs, are in CONTRIBUTING.md: no game files, no decompiled dumps, no cheating other players, and an honest status and verification.

A few notes from the community:

What's inside

Skills (skills/, Agent Skills format)

SkillWhat it does

View source on GitHub