rehan-remade/universal-modder

Install

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

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/).

Without a clone, OpenCode 2 installs the plugin in plugins/opencode/ with opencode plugin add: one umrun tool that passes its arguments straight to the CLI and runs um from PATH (see below), plus the fal MCP server when FALKEY is set and none is configured. A clone doesn't need it. See plugins/opencode/README.md.

The um CLI. The Claude Code plugin puts it on PATH (its SessionStart hook), and so does a clone opened in Claude Code (.claude/settings.json); in a clone with another agent, export PATH="$PWD/bin:$PATH". Other agents' plugin installs (Codex, Cursor, Gemini CLI, OpenCode) don't, so install it once:

• Claude Code — /plugin marketplace add rehan-remade/universal-modder/plugin install universal-modder@universal-modder
• Codex — codex plugin marketplace add rehan-remade/universal-moddercodex plugin add universal-modder@universal-modder
• Gemini CLI — gemini extensions install https://github.com/rehan-remade/universal-modder
• VS Code / Copilot — Enable chat.plugins.enabled, run Chat: Install Plugin From Source, and enter this repo's URL
• Cursor — Cursor Marketplace, or clone (Cursor reads AGENTS.md and .cursor/mcp.json)
• OpenCode — Clone and run opencode inside it (opencode.json adds the skills and the fal MCP server)or, on OpenCode 2, opencode plugin add 'github:rehan-remade/universal-modder#main::path:plugins/openco
• Skills only(any agent) — npx skills add https://github.com/rehan-remade/universal-modder
• Anything else — git clone https://github.com/rehan-remade/universal-modder and start your agent inside it

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

Built with it

Each has a field note with every non-obvious lesson: knowledge/INDEX.md.

• examples/terraria-tmodloader: Fal Arsenal for tModLoader.
• Weapons: a homing missile launcher, a tactical nuke (crater + mushroom cloud), a chain-lightning rifle, a
• black-hole gun and an orbital strike.
• Three new enemies and a two-phase Drone Mothership boss.
• Every sprite came from fal.
• examples/aoe2-de-civ: San Franciscans for Age of Empires II DE.
• A new civilization with a Robotaxi unique unit and Delivery Drones, rendered from fal image-to-3D models
• at AoE2's camera angle.
• A Transamerica Pyramid wonder.
• A reverse-engineered .sld sprite writer.
• examples/minecraft-gta5-passthrough: real Minecraft inside
• GTA V story mode.
• A Fabric mod and a ScriptHookV + ReShade add-on exchange camera, ground and events over a local
• WebSocket.

Rules it follows

• Any game you own: single-player, multiplayer, or servers you host. It refuses to inject into online
• games with anti-cheat, write cheats against other players, or bypass anti-cheat, DRM or ownership checks.
• It never ships game files or decompiled code. Mods ship as code, your own assets, patches or
• converters.
• It backs up before touching saves, and kills processes by PID only.
• It asks before driving your mouse and keyboard, installing loaders into game folders, or publishing,
• PRs included.

概述

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 at universalmodder.com. Publish your mods, remix other people's, and make new ones. Share what you make, get help, and follow along: