1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | universal-modder |
| 作者/维护者 | Rehan Sheikh(个人开发者,独立仓库) |
| 来源链接 | https://github.com/rehan-remade/universal-modder |
| 许可证 | MIT(GitHub API 确认) |
| GitHub Stars | 778(GitHub API) |
| Forks | 52(GitHub API) |
| 最新版本 | 未使用 GitHub Releases,以 main 分支持续更新为准 |
| 安装方式 | Claude Code 插件市场:/plugin marketplace add rehan-remade/universal-modder 后 /plugin install universal-modder@universal-modder;或克隆仓库后在其中启动 agent |
2. 功能介绍与亮点
一套让编程 Agent 为用户自己拥有的 PC 游戏做 MOD 的完整工具链,由 9 个 SKILL.md 与配套 CLI(um)、fal.ai MCP 共同构成一条流水线:① game-recon 识别游戏引擎、版本、是否带反作弊、存档位置;② reverse-engineering 按引擎类型(Unity IL2CPP、.NET/Mono、Java、原生 C/C++)选用 Ghidra、Cpp2IL、ILSpy、Cheat Engine、Frida、RenderDoc 等工具读懂游戏内部逻辑;③ fal-assets/asset-pipeline 用 fal.ai 生成像素画、3D 模型、音效并转换成引擎可用的精灵图/贴图;④ game-automation 负责启动游戏、截图、模拟输入以在真实游戏中验证效果;⑤ showcase-video/publish-mod 完成录屏剪辑与发布前检查。核心亮点是把“读代码验证一个假设→写一次往返转换证明格式解析正确→在真实游戏里跑一遍”的实证闭环写成了可复用的方法论,并覆盖 12 类引擎的具体打法(Unity、Unreal、Godot、Source、Bethesda、Minecraft、AoE2 等)。
3. 适用场景
固定分类:其他(游戏 MOD 制作与逆向工程,不属于前端设计、工程效率等既有类别)。典型场景:拥有正版游戏、想给游戏加自定义内容(新怪物、新载具、新文明、场景美术替换)但自己不熟悉逆向工程或游戏引擎内部结构的玩家型开发者,用 Agent 完成从读懂游戏代码到生成美术资源、在真实游戏里验证效果的全过程。
4. 跨 Agent 兼容性
- Claude Code:原生支持——官方插件市场安装方式,
.claude/目录含 SessionStart hook - Codex:支持——仓库根目录的
AGENTS.md与CLAUDE.md内容一致(前者指向后者),README 明确写明“works with Codex/Cursor via AGENTS.md too” - OpenClaw:未验证——官方渠道未点名
- Hermes Agent:未验证——官方渠道未点名
5. 推荐理由
多数“AI 生成游戏”类技能做的是从零造一个新游戏,这套技能解决的是完全不同也更难的问题——改造你已经拥有的商业游戏:先靠逆向工程真正读懂目标游戏的引擎与数据格式,再动手改,而不是凭空猜。它把“用往返编解码证明格式解析正确”“在真实游戏里跑一遍再收工”这类专业逆向工程习惯,包装成了普通玩家也能跟着 Agent 走完的流程,同时对在线游戏反作弊、DRM 绕过等红线给出了业内少见的详尽书面规则。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 仓库 2026-09-30 建仓,1 天内涨至 778 stars;作者本人 X 账号发布仓库当日即获媒体报道(vgtimes.com 专文介绍),且已出现社区自发移植版(面向 OpenCode、Antigravity 等其他 agent 生态的独立仓库)——星数本身不高,但独立报道与社区自发移植说明关注度已跨出单一平台 |
| 可用性 | 7 | Claude Code 插件市场一条命令安装;README/CLAUDE.md/AGENTS.md/docs/examples 文档体系完整,含 Terraria、AoE2 两个跑通的实例;但依赖链较长(Python 3.10+、ffmpeg、uv、3D 功能还需 Blender、生成美术需自备 fal API key),且仓库上线仅 1 天,缺乏长期维护记录 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:① 执行 shell 命令范围明确——通过 um CLI launch/screenshot/input 模拟/进程管理,均要求“按精确 PID 结束进程”等具体约束,写在 skills/mod-any-game/references/safety.md;② 联网外发仅限用户主动配置的 fal.ai 资产生成 API(需自备 FAL_KEY),逆向工程工具产生的 MCP 服务器要求绑定 127.0.0.1 并带 token,目标透明;③ 仅涉及用户自备的 fal API key,以环境变量存储,未见硬编码;④ 未发现可疑指令或 prompt injection 迹象,SKILL.md 正文反而包含大段专门用于拒绝风险操作的规则;⑤ 作者为真实个人(X 账号 @rehan_shei,公开身份),无造假迹象;⑥ MIT License 明确;⑦ 仓库持续提交中(最近一次提交在建仓次日)。扣分点:安装依赖较多、且要求对游戏内存/进程进行读写操作,属于“有代码执行但范围明确”档而非最高档。尤为值得说明的一点:该技能明确禁止对抗在线游戏反作弊系统、禁止绕过 DRM/所有权校验、禁止制作多人游戏外挂,并给出具体软件清单(EasyAntiCheat、BattlEye、Vanguard 等)作为“遇到即停手”的红线——这是一套主动拒绝规避检测类用途的书面规则,而非提供此类能力。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| gamedev-skills/awesome-gamedev-agent-skills(74 个 SKILL.md) | 用 Godot/Unity/Unreal/Phaser 等引擎从零开发新游戏的技能集合 | 面向游戏开发者造新游戏,不处理“如何读懂并改造一个已经打包发布的商业游戏”这一逆向工程环节 |
| threejs-game-director | 用 Three.js 造网页小游戏 | 同样是“造”而非“改”,且限定 Web/Three.js 技术栈,不涉及原生 PC 游戏内部结构分析 |
| 通用逆向工程 MCP(GhidraMCP、ida-pro-mcp 等) | 提供反编译能力的底层工具 | 只是本技能内部会调用的单点工具,不含“识别引擎→选路线→改代码→出美术→装进游戏验证”的完整流程与游戏引擎专属打法 |
8. 用户评价
作者 Rehan Sheikh 在其 X 账号发布仓库介绍帖,展示了用该工具给《Terraria》加战术核弹、给《帝国时代2》做全新文明的实例;vgtimes.com 发表专文介绍该工具“为 Claude Code 创建和测试 PC 游戏 MOD 提供工作流”。该技能上线仅 1 天,Reddit/HN 等渠道尚无独立具名用户评价。
9. 安装使用方式
# 方式一:作为 Claude Code 插件安装
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder
# 方式二:克隆后在仓库内启动 agent(同时支持 Codex/Cursor)
git clone https://github.com/rehan-remade/universal-modder && cd universal-modder && claude
安装后需额外配置 export FAL_KEY=...(用于生成美术/音效资源,可选但推荐);需自行安装 Python 3.10+、ffmpeg,uv 会自动管理依赖;3D 转精灵图功能需要本机装有 Blender。使用时直接用自然语言描述想加的 MOD 内容,Agent 会自动从 mod-any-game 技能起步执行完整流程。
10. 注意事项
- 仅支持修改用户自己拥有的单机/离线游戏,明确拒绝对抗在线游戏反作弊系统或制作多人游戏外挂
- 3D 相关功能依赖本机安装 Blender,Windows 游戏的部分操作需从 WSL 或原生 Windows 环境驱动
- 逆向工程产出的反编译代码与提取的游戏资源要求留在仓库之外、不得随 MOD 一并发布,避免侵犯版权
- 仓库上线仅 1 天,尚缺乏中长期维护记录与大规模社区验证