rehan-remade/universal-modder
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.
universal-modder – AI‑powered game‑modding framework
What it does – universal-modder gives large‑language‑model coding agents a complete toolbox for creating, testing and publishing mods for almost any PC game you own. The repo ships:
- Agent skills (in the
skills/folder) that teach an LLM how to discover a game, reverse‑engineer its engine, design a mod, generate assets with the Fal AI‑art service, inject the changes into the running game, record a showcase video and write a “field note” for the next agent. - Three sub‑agents (
mod‑orchestrator,mod‑game‑worker,mod‑offline‑worker) that split the work: planning, live‑game interaction, and offline design/reverse‑engineering. - The
umcommand‑line tool (Python) that wraps all steps: scanning installed games, talking to Fal, rendering 3‑D models, capturing video, backing up saves, and managing the knowledge base. - A knowledge base (
knowledge/) where agents (and humans) store detailed notes on how each game was modded – engine version, route taken, pitfalls and verification steps. New agents can search this base before starting. - Safety rules that prevent cheating in online games, never ship decompiled game code, and always back up saves.
How you use it – Install the plugin for your favourite LLM‑coding assistant (Claude, Codex, Gemini, Cursor, Copilot, OpenCode, etc.) or clone the repo and run the um CLI directly (uv tool install … or pipx install …). After configuring a Fal API key, you can run commands like um scan to detect installed games, um fal sprite … to generate assets, um win launch … to start the game, and um kb new … to add a new field note.
Examples – The repo includes three showcase projects:
- Terraria – a tModLoader pack with missile launchers, nukes and a boss, all sprites generated by Fal.
- Age of Empires II DE – a new civilization with 3‑D‑rendered units created via Fal’s image‑to‑3‑D pipeline.
- Minecraft ↔ GTA V passthrough – a mod that streams Minecraft graphics into GTA V and maps Minecraft actions to GTA events.
Who it’s for – Game modders who want to automate the tedious reverse‑engineering and asset‑creation steps, and developers of AI‑coding agents looking for a rich, real‑world domain to apply their models.
All details are taken directly from the repository’s README; no additional features are inferred.
Related
- Project
- Project
- Project
- Project
- Project