How to Install Universal Modder
Universal Modder installs as a plugin or extension inside your AI coding agent. Pick your agent below; every command comes from the official README.
Requirements
| Requirement | Notes |
|---|---|
| Git | Required |
| Python 3.10+ | Required for the um CLI |
| ffmpeg | Required for recording and video |
| uv | Recommended; pipx also works |
| Blender | Only for 3D-to-sprite renders |
| fal API key | Optional; only for AI-generated assets |
| Windows or WSL | For launching and driving Windows games |
Install commands by agent
| Agent | Command |
|---|---|
| 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 the repo URL |
| Cursor | Use the Cursor Marketplace, or clone the repo (Cursor reads AGENTS.md and .cursor/mcp.json) |
| OpenCode | Clone the repo and run opencode inside it. On OpenCode 2: opencode plugin add 'github:rehan-remade/universal-modder#main::path:plugins/opencode', then add the skills with “Skills only” |
| 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, then start your agent inside the folder |
Commands can change as the project moves quickly. If one fails, check the README for the current version.
Install the um CLI
If um is not already on your PATH after installing the plugin, install it on its own:
uv tool install git+https://github.com/rehan-remade/universal-modderThe README also lists a pipx install git+... alternative with the same repository URL. Verify with um scan, which should list the games it finds on your machine.
Set up fal (optional)
- Create a key
Get an API key from the fal.ai dashboard (fal.ai/dashboard/keys). fal is a paid, usage-based API. - Export it
export FAL_KEY="your-fal-api-key". Both the fal MCP server andum falread this variable. - Check prices first
Runum fal pricebefore large batches. Keep the key out of chats, commits and published mods.
FAQ
Can I install Universal Modder without a fal key?
Yes. The key is only needed for fal-generated assets. For images, um comfy can use a local ComfyUI server instead.
Do I need to clone the repo?
Not for Claude Code, Codex or Gemini CLI, which install it as a plugin or extension. Cloning is the fallback for Cursor, OpenCode and other agents.
Where do the skills and configs live?
According to AI Frontier Post, skills are linked in .agents/skills, .claude/skills, .gemini/skills and .github/skills, instructions live in AGENTS.md, and MCP configs ship for .mcp.json, .codex/config.toml, .cursor/mcp.json and .vscode/mcp.json.
Next
Unofficial, independent guide. Not affiliated with the Universal Modder project, its maintainers (rehan-remade), fal, Anthropic or any game publisher. The official source is github.com/rehan-remade/universal-modder. We do not host game files, mods or decompiled code. Only mod games you own.