Repolode
Submit
rehan-remade

rehan-remade/universal-modder

A set of skills, CLI tools and an MCP server that let AI coding agents scan, mod and test PC games you own, with fal-generated assets.

View on GitHub
Stars
8,461
Forks
934
Open issues
26
Last commit
13 hours ago

What is it?

Universal Modder gives AI coding agents such as Claude Code, Codex, Cursor and Gemini CLI a workflow for modding PC games. The agent identifies a game's install, engine and version, picks a modding route, reads the game's code, builds a working mod, and checks it in the running game. A bundled `um` CLI handles scanning installs, generating sprites, 3D models and audio through fal, capturing windows and audio, and cutting showcase videos.

The project covers many engine families, including Unity, Unreal, .NET/XNA, Godot, Minecraft, Age of Empires II and Bethesda titles, with reverse-engineering tools such as ILSpy, Ghidra and Frida. Its skills follow a fixed loop: search existing notes, run recon, back up saves, build one slice, generate assets, verify, and record findings. Agents can also contribute field notes to a shared knowledge base in the repo.

The project refuses to inject into online games with anti-cheat or to cheat against other players, and it never ships game files or decompiled code. Setup needs Git, Python 3.10+ and ffmpeg, plus a fal API key for asset generation.

Key features

  • 01Scans Steam, Epic and Xbox installs to identify engine, version and anti-cheat.
  • 02Provides agent skills for reverse engineering, recon, asset generation and in-game testing.
  • 03Generates sprites, 3D models, textures and audio through fal.
  • 04Captures game windows and game-only audio, and can send input only to the game window.
  • 05Backs up save folders before changes and includes a publish check that blocks game files.

Use cases

  • Adding new weapons or enemies to a Terraria mod with AI-generated sprites.
  • Building a new civilization or unit for Age of Empires II DE.
  • Recording and cutting a showcase video of a finished game mod.
  • Looking up whether a game has been modded before and which engine it uses.

Quick start

  1. 1

    Install the um CLI with uv

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

    Store your fal API key (optional, for asset generation)

    um fal key set
  3. 3

    Install the skills into your AI coding agent

    npx skills add https://github.com/rehan-remade/universal-modder

Things to know

  • Mods only PC games you own, and the README asks agents to avoid cheating other players.
  • Asset generation needs a paid fal API key, or a Sprixen key for sprites, or a local ComfyUI server.
  • Blender is needed for 3D-to-sprite renders, and Windows games are driven natively or from WSL.

Topics

#game-modding#claude-code#ai-agents#reverse-engineering#mcp#game-assets#fal#cli#age-of-empires#claude-code-plugin

FAQ

What is universal-modder?
A set of skills, CLI tools and an MCP server that let AI coding agents scan, mod and test PC games you own, with fal-generated assets. Universal Modder gives AI coding agents such as Claude Code, Codex, Cursor and Gemini CLI a workflow for modding PC games. The agent identifies a game's install, engine and version, picks a modding route, reads the game's code, builds a working mod, and checks it in the running game. A bundled `um` CLI handles scanning installs, generating sprites, 3D models and audio through fal, capturing windows and audio, and cutting showcase videos.
Is universal-modder free to use? What license does it have?
universal-modder is open source under the MIT license. Check the license terms before using it in commercial products.
Is universal-modder still maintained?
Actively maintained. The last commit to universal-modder was on Oct 19, 2026.
What can I use universal-modder for?
Adding new weapons or enemies to a Terraria mod with AI-generated sprites. Building a new civilization or unit for Age of Empires II DE. Recording and cutting a showcase video of a finished game mod. Looking up whether a game has been modded before and which engine it uses.
How do I install universal-modder?
Install the um CLI with uv: uv tool install git+https://github.com/rehan-remade/universal-modder Store your fal API key (optional, for asset generation): um fal key set Install the skills into your AI coding agent: npx skills add https://github.com/rehan-remade/universal-modder
Where can I get universal-modder?
The source code and installation instructions are on GitHub: https://github.com/rehan-remade/universal-modder

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects