{"slug": "universal-modder-let-any-ai-coding-agent-mod-almost-any-pc-game", "title": "Universal Modder: Let Any AI Coding Agent Mod Almost Any PC Game", "summary": "Developer Rehan launched Universal Modder, an open-source toolkit that lets AI coding agents mod almost any PC game through a shared knowledge base, Agent Skills, a fal MCP server and a `um` CLI. The project supports Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode via `AGENTS.md`, and requires Python 3.10+, ffmpeg and a fal API key for asset generation. Each completed mod can be submitted as a pull request adding a field note to the `knowledge/` directory so later agents reuse the exact versions, routes and fixes.", "body_md": "**Skills, tools and a shared knowledge base that let any AI coding agent mod almost any PC game you own.**\n\n  Works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, or anything that reads `AGENTS.md`.\n\n  The agent finds the game, works out the engine and the route, reads the real code, builds the mod, makes art, 3D and sound\n  with [fal](https://fal.ai), tests it in the running game, cuts the video, and writes down what it learned for the next agent.\n\nPick your agent. Each gets the same skills (Agent Skills format), the fal MCP server, and the `um` CLI.\n\n| Agent | Install | \n|---|---|\n| **Claude Code** | `/plugin marketplace add rehan-remade/universal-modder` , then`/plugin install universal-modder@universal-modder` | \n| **Codex** | `codex plugin marketplace add rehan-remade/universal-modder` , then`codex plugin add universal-modder@universal-modder` | \n| **Gemini CLI** | `gemini extensions install https://github.com/rehan-remade/universal-modder` | \n| **VS Code / Copilot** | Enable `chat.plugins.enabled` , run**Chat: Install Plugin From Source** , and enter this repo's URL | \n| **Cursor** | Cursor Marketplace, or clone (Cursor reads `AGENTS.md` and`.cursor/mcp.json` ) | \n| **Skills only** (any agent) | `npx skills add https://github.com/rehan-remade/universal-modder` | \n| **Anything else** | `git clone https://github.com/rehan-remade/universal-modder` and start your agent inside it | \n\nInside a clone, each agent finds the skills where it looks for them: `.agents/skills` (Codex and friends),\n`.claude/skills`, `.gemini/skills` and `.github/skills` all link to `skills/`. Instructions are in\n`AGENTS.md`, which `CLAUDE.md` and `GEMINI.md` point to. MCP config is in `.mcp.json`, `.codex/config.toml`,\n`.cursor/mcp.json` and `.vscode/mcp.json`.\n\n**The `um` CLI.** Plugin installs and clones put it on PATH. Anywhere else:\n\n```\nuv tool install git+https://github.com/rehan-remade/universal-modder     # or: pipx install git+...\n```\n\n**For assets,** get a [fal API key](https://fal.ai/dashboard/keys). It powers both the fal MCP server and\n`um fal`:\n\n```\nexport FAL_KEY=...\n```\n\nYou also need Python 3.10+ and ffmpeg. `uv` is recommended. Blender is needed for 3D → sprite renders.\nWindows games are driven natively or from WSL.\n\nMod Terraria: add a homing missile launcher and a tactical nuke that craters the world. Make the sprites with fal.\n\nMake a new civilization for Age of Empires II with a unique unit rendered from 3D.\n\nPut real Minecraft inside GTA V story mode. Minecraft's camera should follow GTA's, and its TNT should blow up GTA cars.\n\nWhat engine is `C:\\Games\\Foo`, and has anyone modded it before?\n\nThe agent starts with the **mod-any-game** skill and runs the same loop every time:\n\n1. search the knowledge base;\n2. recon, then pick a route;\n3. set up a safe lab (saves backed up);\n4. read the actual code;\n5. build one working slice;\n6. generate assets;\n7. verify in the real game;\n8. record;\n9. package;\n10. write a field note for the next agent.\n\n[`knowledge/`](https://github.com/rehan-remade/universal-modder/blob/main/knowledge) holds **field notes**: how specific games were actually modded, decompiled and\nreverse-engineered. Each note gives:\n\n- the exact versions that worked;\n- the route, and why;\n- what the engine really does;\n- how it was verified;\n- the gotchas (symptom → cause → fix).\n\n**Every agent that finishes a mod can open a pull request with its note**, so the next agent starts where it\nleft off instead of rediscovering the same traps.\n\n```\num kb search \"grand theft auto\"                 # before you start: prior art (works outside the repo too)\num kb new --game \"Hades II\" --title \"A new boon god\" --from-scan hades --agent \"Codex (gpt-6)\"\num kb check knowledge/games/hades-ii/a-new-boon-god.md\num kb pr knowledge/games/hades-ii/a-new-boon-god.md --yes    # after your human says OK: branch, push, PR\n```\n\nBrowse [`knowledge/INDEX.md`](https://github.com/rehan-remade/universal-modder/blob/main/knowledge/INDEX.md). Contribution rules, for humans and AIs, are in\n[`CONTRIBUTING.md`](https://github.com/rehan-remade/universal-modder/blob/main/CONTRIBUTING.md): no game files, no decompiled dumps, nothing that helps cheat online,\nand an honest status and verification.\n\n**Skills** (`skills/`, Agent Skills format)\n\n| Skill | What it does | \n|---|---|\n| `mod-any-game` | The whole loop, hard safety rules, and **12 engine playbooks** : Unity, Unreal, .NET/XNA (Terraria, Stardew, Celeste), Godot, Source 1/2, Bethesda, Minecraft, AoE2/Genie, RE Engine/FromSoft/GTA/Cyberpunk/BG3, native C++, indie engines (GameMaker, RPG Maker, Ren'Py, Paradox, Doom, HTML5, LÖVE, Java), retro decomps | \n| `game-recon` | Prior field notes, engine and version, managed or native, anti-cheat, loaders, save folders, community route → `MODDING_PLAN.md` | \n| `reverse-engineering` | ILSpy / Cpp2IL / Vineflower / Ghidra and IDA over MCP / Cheat Engine / Frida / RenderDoc; reverse-engineer a file format and prove it with a round trip | \n| `fal-assets` | Sprites with real transparency, consistent variants, pixel art, seamless textures, PBR maps, image-to-3D, auto-rigging, SFX, music, voice, cutscene video | \n| `asset-pipeline` | Art → engine-exact frames: cutout, nearest-neighbour fit, palettes, sheets, team-colour masks, 3D → 8/16-heading sprites | \n| `game-automation` | Launch, screenshot (GPU-safe), click/type safely, windowed mode, crash-reporter cleanup, in-game agent bridges | \n| `showcase-video` | Record the window with only the game's audio, pick moments, cut a styled video from an EDL | \n| `mashup-mods` | Game inside a game: content ports, passthrough mods (worked example: Minecraft × GTA V), decomps as libraries, reimplementations | \n| `publish-mod` | Lint, package per platform, credits, the post | \n| `share-field-notes` | Search the knowledge base, write your own note, open the PR | \n\n**The `um` CLI** (Python). Every command has `--help` with examples.\n\n| `um scan` | Find Steam/Epic/Xbox installs; fingerprint engine and version, .NET vs native, anti-cheat, installed loaders, save folders, ranked routes | \n| `um fal` | `sprite` ,`image` ,`edit` ,`rmbg` ,`pixelate` ,`upscale` ,`texture` ,`pbr` ,`model3d` ,`rig` ,`sfx` ,`music` ,`voice` ,`video` ,`run` ,`search` ,`schema` ,`price` . Plain REST, with a manifest of every generation | \n| `um sprite` | `cutout` ,`fit` ,`pixelate` ,`palette` ,`sheet` ,`slice` ,`frames` ,`team-mask` ,`seamless` ,`preview` | \n| `um render3d` | GLB → sprite frames from the game's camera ( `aoe2` ,`iso8` ,`trueiso` ,`topdown` ,`side` ,`turntable` ) with Blender | \n| `um win` | `shot` ,`record` (gfxcapture + process-loopback audio),`drive` (input that only reaches the game),`ps` ,`kill` ,`launch` ,`reg` | \n| `um video` | `contact` sheets,`compile` (EDL → titled, beat-cut video with music),`mux` ,`beats` ,`first-frame` | \n| `um backup` | Snapshot, diff and restore save folders | \n| `um publish check` | Blocks shipping game files, decompiled code and leaked keys | \n| `um kb` | The knowledge base: `search` ,`show` ,`new` ,`check` ,`index` ,`sync` ,`pr` | \n\nTwo no-build Windows tools ship inside the package (`um/ps1/`): WinDrive input and ProcLoopback game-only\naudio, both PowerShell with embedded C#.\n\n- **[examples/terraria-tmodloader](https://github.com/rehan-remade/universal-modder/blob/main/examples/terraria-tmodloader)** :*Fal Arsenal* for tModLoader.\n  - Weapons: a homing missile launcher, a tactical nuke (crater + mushroom cloud), a chain-lightning rifle, a black-hole gun and an orbital strike.\n  - Three new enemies and a two-phase Drone Mothership boss.\n  - Every sprite came from fal.\n- **[examples/aoe2-de-civ](https://github.com/rehan-remade/universal-modder/blob/main/examples/aoe2-de-civ)** :*San Franciscans* for Age of Empires II DE.\n  - A new civilization with a Robotaxi unique unit and Delivery Drones, rendered from fal image-to-3D models at AoE2's camera angle.\n  - A Transamerica Pyramid wonder.\n  - A reverse-engineered `.sld` sprite writer.\n- **[examples/minecraft-gta5-passthrough](https://github.com/rehan-remade/universal-modder/blob/main/examples/minecraft-gta5-passthrough)** : real Minecraft inside\nGTA V story mode.\n  - A Fabric mod and a ScriptHookV + ReShade add-on exchange camera, ground and events over a local WebSocket.\n  - Minecraft's colour + depth are depth-composited into GTA's frame.\n  - Minecraft TNT, arrows and fireworks become GTA explosions and bullets, and Minecraft mobs fight the police.\n\nEach has a field note with every non-obvious lesson: [knowledge/INDEX.md](https://github.com/rehan-remade/universal-modder/blob/main/knowledge/INDEX.md).\n\n- **Single-player and offline, on games you own.** It refuses to inject into online games with anti-cheat,\nwrite multiplayer cheats, or bypass anti-cheat, DRM or ownership checks.\n- **It never ships game files or decompiled code.** Mods ship as code, your own assets, patches or\nconverters.\n- **It backs up before touching saves** , and kills processes by PID only.\n- **It asks before** driving your mouse and keyboard, installing loaders into game folders, or publishing,\nPRs included.\n\nFull reasoning: [`skills/mod-any-game/references/safety.md`](https://github.com/rehan-remade/universal-modder/blob/main/skills/mod-any-game/references/safety.md).\n\n- Built from real agent sessions modding Terraria, Age of Empires II and GTA V × Minecraft.\n- Assets: [fal](https://fal.ai) (GPT Image 2, Nano Banana 2, FLUX, Trellis 2, ElevenLabs...).\n- Standing on the shoulders of tModLoader, genieutils-py, AoE2ScenarioParser, ScriptHookV, ReShade, Fabric, BepInEx, Harmony, UE4SS, REFramework, SKSE, ILSpy, Ghidra and every modding community that documented its game.\n- The engine playbooks also draw on the September 2026 wave of AI-built mods, and on how their creators explained them in public.\n\nMIT licensed. Fonts: Space Grotesk and JetBrains Mono (SIL OFL).", "url": "https://wpnews.pro/news/universal-modder-let-any-ai-coding-agent-mod-almost-any-pc-game", "canonical_source": "https://github.com/rehan-remade/universal-modder", "published_at": "2026-10-01 02:48:15+00:00", "updated_at": "2026-10-01 03:18:50.449204+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "agent-protocols", "generative-ai"], "entities": ["Universal Modder", "Rehan", "Claude Code", "Codex", "Cursor", "Gemini CLI", "GitHub Copilot", "fal"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/universal-modder-let-any-ai-coding-agent-mod-almost-any-pc-game", "markdown": "https://wpnews.pro/news/universal-modder-let-any-ai-coding-agent-mod-almost-any-pc-game.md", "text": "https://wpnews.pro/news/universal-modder-let-any-ai-coding-agent-mod-almost-any-pc-game.txt", "jsonld": "https://wpnews.pro/news/universal-modder-let-any-ai-coding-agent-mod-almost-any-pc-game.jsonld"}}