universal-modder

让 Claude 直接帮你做任意 PC 游戏 Mod

universal-modder 是一套面向 Claude Code 的游戏模组开发工具包，目标是让 AI 直接参与几乎所有 PC 游戏的 Mod 制作。它通过技能（Skills）、工具集和 fal MCP 服务，把原本分散的逆向工程、资源生成与测试流程串成一条链：先对目标游戏做侦察与内存/文件结构分析，再用 fal 生成美术、3D 模型和音频素材，随后编写或修改 Mod 代码，最后在游戏内实测并产出展示视频。项目覆盖《帝国时代》等具体案例，也兼容 tModLoader 等模组框架，把 Claude Code 从代码助手扩展为能操作游戏资产的智能体。对想快速做 Mod 但缺乏逆向和美术能力的玩家与开发者，它降低了从想法到可玩 Mod 的门槛，把重复劳动交给 AI 与自动化工具。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3578

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类智能体

开发团队rehan-remade

所属国家

官网地址

GitHubhttps://github.com/rehan-remade/universal-modder

定价模式free

价格说明开源免费，fal API调用需自付费用

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型age-of-empires,claude-code,claude-code-plugin,fal,game-assets,game-modding,mcp,modding,reverse-engineering,tmodloader

GitHub 星标★ 3578

30天Star增速

HF 下载量

上线时间2026-09-30 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-05

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Python 3.10 及以上
ffmpeg
uv（官方推荐，用于安装 um CLI）
fal API Key（生成美术/3D/音频素材时需要）
Blender（仅在做 3D 转精灵图渲染时需要）

安装与启动步骤

1克隆仓库

任意 agent 的通用做法：克隆后在该目录内启动你的编码 agent，它会读取 AGENTS.md 与各技能文件。
```
git clone https://github.com/rehan-remade/universal-modder
```
2Claude Code 安装

在 Claude Code 会话中依次执行两条插件命令，装好后自动获得技能、fal MCP 服务与 um CLI。
```
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder
```

3Codex 安装

在终端中执行两条 codex 插件命令，效果与 Claude Code 一致。

codex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modder

4Gemini CLI 安装

Gemini CLI 用户直接用 extensions install 指向仓库地址即可完成安装。
```
gemini extensions install https://github.com/rehan-remade/universal-modder
```
5仅安装 Skills

任何 agent 都可用 npx skills 只装技能部分，不装插件体系。
```
npx skills add https://github.com/rehan-remade/universal-modder
```
6安装 um CLI

插件安装和克隆会把 um 放到 PATH；其他场景用 uv 或 pipx 单独安装。
```
uv tool install git+https://github.com/rehan-remade/universal-modder
```
7配置 fal 密钥

导出 fal API Key 后才能生成图片等素材，无密钥可改用 um comfy 连本地 ComfyUI。
```
export FAL_KEY=...
```

关键配置

配置项	必填	说明	示例
`FAL_KEY`	是	fal API Key，同时供 fal MCP 服务与 um fal 调用。	`fal-xxxxxxxxxxxxxxxxxxxx`
`chat.plugins.enabled`	是	VS Code / Copilot 需先开启该设置才能从源码安装插件。	`true`

如何确认成功

在克隆目录内启动 agent，确认技能已加载、AGENTS.md 生效，且终端里 um 命令可直接调用。

常见问题

Q：没有 fal API Key 还能做素材吗？

A：可以。图片生成可改用 um comfy，它连接本地运行的 ComfyUI 服务，无需 fal 密钥。

Q：支持哪些 AI coding agent？

A：Claude Code、Codex、Gemini CLI、VS Code/Copilot、Cursor、OpenCode 等，也支持任意 agent 只装 Skills。

Q：做 3D 转精灵图还需要装什么？

A：需要额外安装 Blender，用于把 3D 模型渲染成游戏可用的精灵图。

Q：Windows 游戏怎么运行和测试？

A：Windows 游戏可以原生驱动，也可以在 WSL 环境下驱动，按你的系统选择即可。

注意事项

各 agent 读取技能的路径不同：Codex、Gemini CLI、Copilot、Cursor、OpenCode 用 .agents/skills，Claude Code 用 .claude/skills，二者都是 skills/ 的副本。
统一说明文档在 AGENTS.md，CLAUDE.md 和 GEMINI.md 都指向它。
MCP 配置分散在 .mcp.json、.codex/config.toml、.cursor/mcp.json、.vscode/mcp.json 与 opencode.json。
Cursor 也可直接克隆仓库使用；OpenCode 则在仓库内运行 opencode 命令。

核心亮点

把侦察、逆向、素材生成、测试、出片串成完整流水线，而非单一工具
集成 fal MCP，可直接生成美术、3D 与音频，省去外部素材流程
以 Claude Code 插件形式分发，安装后即可在对话中调用，上手路径短

不足之处

依赖 Claude Code 与 fal 服务，存在账号、额度与网络门槛
对复杂商业游戏的逆向深度和实际成功率缺少系统评测

适用场景

给老游戏做高清材质与模型替换 Mod
为独立游戏快速生成新角色、音效并实测
把 Mod 制作过程自动录制成展示视频发布

替代项目

Awesome-Game-Modding、modding-tools、Cheat Engine

项目介绍

universal-modder 是智能体领域的开源项目，由 rehan-remade 开发，是 2026 年新上线的项目。

在全站 13,752 个收录项目中，它的 GitHub 星标数（3,578）位列前 30%，在智能体分类的 2,595 个项目里位列前 12%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-10-05。开源免费，fal API调用需自付费用。

它主要面向的使用场景是：给老游戏做高清材质与模型替换Mod。同类可对比的替代方案包括 Awesome-Game-Modding、modding-tools、Cheat Engine。

上一篇：whoop-mcp

下一篇：OpenDots