Skip to main content
Universal Modder
Menu

THE INDEPENDENT MODDING GUIDE

Universal Modder

Universal Modder is an open-source set of skills, tools and a knowledge base that lets AI coding agents mod almost any PC game you own.

★ 6.6K on GitHubMITUpdated

Claude CodeRun in: Claude Code
Select code
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

You can select the code to copy it manually.

FROM IDEA TO IN-GAME
ONE TOOLKIT. SIX AGENTS.

Start with a game you own.
Build one small change.

YOUR WORKSPACE, YOUR CHOICE

Claude Code · Codex · Gemini CLI · VS Code / Copilot · Cursor · OpenCode

What is Universal Modder?

Universal Modder brings game-modding instructions, command-line tools and a shared knowledge base into your AI coding agent. You name a game you own and a change you want; the agent investigates the game, selects a modding route and works toward a result you can check in the game. How Universal Modder works in detail.

How to install Universal Modder

Choose the agent you already use. The project supports Claude Code, Codex, Gemini CLI, Cursor, VS Code with GitHub Copilot, and OpenCode. Each full integration connects the skills and optional fal asset service; the command-line tools support the work underneath.

Claude Code

Add the marketplace, then install the plugin.

installRun in: Claude Code
Select code
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

You can select the code to copy it manually.

Install with Claude Code

Codex

Add the marketplace and plugin from your terminal.

installRun in: Terminal
Select code
codex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modder

You can select the code to copy it manually.

Install with Codex

Gemini CLI

Install the extension from the GitHub repository.

installRun in: Terminal
Select code
gemini extensions install https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Install with Gemini CLI

VS Code / Copilot

Enable chat.plugins.enabled, run Chat: Install Plugin From Source, then enter this URL.

URLRun in: Chat: Install Plugin From Source
Select code
https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Install with VS Code / Copilot

Cursor

Install from Cursor Marketplace, or open a clone in Cursor.

installRun in: Terminal (clone route)
Select code
git clone https://github.com/rehan-remade/universal-modder

You can select the code to copy it manually.

Install with Cursor

OpenCode

Clone the repository and launch OpenCode inside it.

installRun in: Terminal
Select code
git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
opencode

You can select the code to copy it manually.

Install with OpenCode

Have Git and Python 3.10 or later ready. Video work needs ffmpeg, while rendering 3D models into sprites also needs Blender. The complete Universal Modder install guide explains dependencies, shell checks and the eight installation routes.

How Universal Modder works: the 10-step loop

  1. Search the knowledge base. Read previous notes for the game and engine, including the versions and unfinished work.
  2. Investigate the installation. Identify the edition, engine, loader and save locations before choosing a route.
  3. Prepare a practice environment. Back up saves and use an isolated profile or world where the game supports one.
  4. Read the relevant code and data. Work from the loader API and the installed game's actual behavior.
  5. Build one small feature. Get one item, unit or mechanic into the running game before expanding the idea.
  6. Make assets. Generate or supply art, sound or 3D models, then convert them to the game's required formats.
  7. Verify in the game. Check the logs and look at the result, including animation, scale and behavior.
  8. Record a demonstration. Capture a repeatable scene that shows what the feature does.
  9. Prepare the package. Check its contents, document installation and credit dependencies.
  10. Write a field note. Preserve versions, decisions and fixes so the next person can build on them.

The Universal Modder tutorial turns that loop into a small Terraria weapon project with planning prompts, backup commands and checkpoints.

What people have built with Universal Modder

The GitHub repository includes source projects for a Terraria arsenal, a new Age of Empires II civilization, and Minecraft running inside GTA V story mode. They show three different routes: a loader API, a data mod with rendered sprites, and a bridge between two running games.

Explore the Universal Modder examples before choosing the scope of your first project. The small Terraria route is easier to reason about than a two-game rendering bridge.

Which games can it mod?

Universal Modder groups its engine guidance into 12 playbooks: Unity; Unreal; .NET/XNA; Godot; Source 1/2; Bethesda; Minecraft; AoE2/Genie; RE Engine, FromSoft, GTA, Cyberpunk and BG3 frameworks; native C++; smaller engines; and retro decompilation projects. Each playbook is an investigation route, so confirm your edition and loader before committing to it.

The knowledge base holds nearly 100 field notes. Each note records its author's environment and status; compare those details with your setup before reusing its steps. Start with the Universal Modder game guides, or open the knowledge index on GitHub.

What Universal Modder won't do

Universal Modder sets four practical boundaries:

  • Work with games you own; do not inject into protected online clients, cheat against other players, or bypass anti-cheat, DRM or ownership checks.
  • Distribute your own code and assets, patches or converters; do not ship game files, extracted assets or decompiled source.
  • Back up saves before changing them and record the way back to the original setup.
  • Ask before taking over input, adding loaders to game folders or publishing work, including a pull request.

Read the full safety rules on GitHub before your first session. The FAQ covers costs, platform limits and account safety.

Universal Modder FAQ

Is Universal Modder free?

The toolkit is MIT-licensed and free to install. Your agent provider and optional fal asset generation can have separate charges. See the FAQ for the cost breakdown.

Universal Modder costs

Is Universal Modder safe?

The project includes backup, packaging and permission rules. Review the agent's tool access, work in a practice environment and check the result in the game.

Universal Modder safety rules

Does it work on Mac?

The Python tools and supported agents can run on macOS, subject to their dependencies. Windows game automation needs Windows, either directly or driven from WSL.

Universal Modder on Mac

Do I need a fal API key?

Only if you use the fal service for generated assets. You can start with placeholder art, your own assets, or an already configured local ComfyUI server.

When you need a fal API key

Is this the official site?

No. This is an independent guide; Universal Modder is developed by rehan-remade at rehan-remade/universal-modder on GitHub.

The official Universal Modder project