What Is Universal Modder?

Universal Modder is an open-source toolkit that gives AI coding agents instructions, utilities and shared game-modding knowledge. It helps an agent investigate a PC game you own, build a modification and check the result in the running game.

What problem does it solve?

A modding project involves more than writing a piece of code. You need to identify the game edition and engine, choose a loader, locate saves, fit assets to the game's formats, build a package and see whether it works. Different engines require different routes.

Universal Modder connects those tasks through reusable skills and a Python command-line tool. Its knowledge base preserves field notes from earlier projects, including exact versions and failed approaches. The agent can begin with those notes and investigate the current installation instead of treating a game name as a complete specification.

For commands, use the installation guide. For the sequence of a first project, use the Universal Modder tutorial.

What's inside

Eleven agent skills

The skills directory on GitHub contains:

The agent loads these as instructions. Review what each step produces before moving to the next one.

The um CLI

The Python package provides scan, backup, fal, comfy, sprite, render3d, win, video, publish and kb command groups. Each has help for its available arguments. For example, scan investigates an installation while backup snapshots saves; those have very different effects and should be used at the appropriate stage.

Start with um --help and the CLI installation checks. Our um CLI reference covers the ten command groups with syntax, examples and platform limits. For a one-table overview, open the tool table in the GitHub README.

fal and local image generation

fal connects the workflow to asset models, through either MCP tools or um fal. A generated picture still needs to be converted to a usable sprite, texture or set of frames. Generation uses your own service credentials and can incur charges.

um comfy offers a local image route through an existing ComfyUI server. Bring your own server, models and hardware. The cost FAQ separates the toolkit's license from these optional services.

A shared knowledge base

The knowledge index holds nearly 100 field notes. Notes identify versions, routes, status, verification and lessons. An unfinished attempt can still be useful when it explains what failed.

How it works: the 10-step loop

The workflow searches prior notes, investigates the game, prepares backups, reads relevant code, builds one small feature, creates assets, verifies in game, records a demonstration, prepares a package and writes a field note. The order matters: a working basic item gives you a stable point from which to add artwork and more complex behavior.

The Terraria tutorial applies that sequence. The source examples show how the same process changes for a civilization data mod or a bridge between two running games.

Which AI agents does it support?

Universal Modder supports Claude Code, Codex, Gemini CLI, Cursor, VS Code/GitHub Copilot and OpenCode. It also provides a skills-only command and a clone route for other agents.

Choose Claude Code, Codex, Cursor, Gemini CLI, VS Code / Copilot or OpenCode for detailed setup. The installation overview includes all eight routes and explains what to verify after installation.

Which games and engines does it support?

The toolkit provides engine playbooks and game-specific notes rather than a fixed compatibility list. A loader API may be enough for Terraria, while an AoE2 data change needs different tools. A two-game mashup can require a bridge, synchronized cameras and a rendering pipeline.

Read which games it supports and compare the edition, platform and loader from the relevant note. The title of a game alone does not tell you whether the same route applies to your installation.

How is it different from traditional modding?

An AI agent can perform research, propose code, run tools and record findings within the access you grant it. The game's loader APIs, build system and file formats remain the underlying constraints. An agent-generated mod still needs a correct package, matching versions and real in-game verification.

This makes a precise first prompt useful: name your edition, installation path, desired feature and success check. Our prompt examples keep that information visible and ask the agent to record unresolved questions.

Safety rules and limits

The project's rules require owned game files, backups and review of consequential actions. They exclude protected online-client injection, cheating against other players, bypassing protections and distributing game files or decompiled source. Read the full safety rules and the safety FAQ.

Who made it, and is this site official?

Universal Modder is developed by rehan-remade at rehan-remade/universal-modder on GitHub and released under the MIT license. Our about page explains what this guide covers and how to reach us.

Project status

6,561 GitHub stars · 649 forks · MIT license · Latest commit 2026-10-11

Our Universal Modder update notes summarize significant changes. Browse the commit history for the full record and the README for current plans. The mod hub is announced as upcoming and is not yet a live service.