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 um command‑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:

  1. Terraria – a tModLoader pack with missile launchers, nukes and a boss, all sprites generated by Fal.
  2. Age of Empires II DE – a new civilization with 3‑D‑rendered units created via Fal’s image‑to‑3‑D pipeline.
  3. 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