Universal Modder
让 AI 编程代理从游戏勘察到实机验证，完成 PC 游戏模组制作。
- Star 数
- ★ 8.5k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Python
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- Terraria 模组作者想用 tModLoader 增加武器和敌人，并为它们生成精灵图。
- 不适合
- 需要修改带反作弊联机游戏的团队
- 需要绕过 DRM 或所有权检查的用户
- 源码审查
- 49/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Universal Modder 是一套面向多种 AI 编程代理的游戏模组工具，包含 Agent Skills、um Python CLI、fal MCP 配置和供代理积累经验的知识库。它可扫描 Steam、Epic 和 Xbox 游戏安装，识别引擎与版本，并为反向工程、资源制作、测试和发布提供工作流程。代理可调用 um 命令处理游戏扫描、资源生成、精灵图、窗口自动化、存档备份、视频和知识库操作。资源制作可使用 fal，也可通过本地 ComfyUI 生成图像；Sprixen 提供独立的付费 2D 美术 API。README 展示了 Terraria、Age of Empires II DE 和 Minecraft 与 GTA V 的模组示例，并说明工具会在实机中验证模组、记录经验和打包产物。
安装对应代理的 Skills、fal MCP 服务器配置和 um CLI 后，代理先用 um scan 查找游戏并识别引擎、版本、反作弊状态、已装加载器和存档目录，再检索 um kb 知识库并制定模组路线。mod-any-game 等技能指导代理查看实际代码、构建可运行切片，并用 um fal、um comfy 或 um sprixen 制作图像、3D、音频或视频资源；um sprite 和 um render3d 可进一步处理精灵图和 3D 渲染。um backup 可快照和恢复存档，um win 可启动、截图、录制和驱动游戏窗口；流程要求在运行中的游戏里验证结果。完成后可用 um publish check 检查发布包，并用 um kb new、um kb check 和 um kb pr 整理知识库贡献。
- Terraria 模组作者想用 tModLoader 增加武器和敌人，并为它们生成精灵图。
- Age of Empires II DE 创作者要制作新文明，并把 3D 单位渲染成游戏视角的精灵图。
- 熟悉 Fabric 与 ScriptHookV 的开发者想制作 Minecraft 与 GTA V 之间的联动模组。
- 不确定某款已安装游戏使用什么引擎、版本或模组路线的玩家，可先运行
um scan并检索知识库。 - 需要把某款游戏的实测模组步骤分享给后续开发者的贡献者，可撰写并检查 field note，再提交 PR。
如何安装或部署这个 Agent？
选择代理并按其入口安装。Claude Code 和 Codex 可添加市场并安装插件；其他文档列出的选项包括 Gemini CLI 扩展、VS Code / Copilot 插件来源安装、Cursor 或 OpenCode 克隆使用，以及仅安装 Skills。独立安装 um CLI 可用 uv 或 pipx。环境需要 Git、Python 3.10+ 和 ffmpeg；3D 转精灵图需要 Blender。使用 fal 资源生成功能需要 fal API 密钥；使用 Sprixen 2D 美术命令需要单独的 Sprixen API 密钥。
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-moddercodex plugin marketplace add rehan-remade/universal-modder
codex plugin add universal-modder@universal-modderuv tool install git+https://github.com/rehan-remade/universal-modderum fal key set
export FAL_KEY="$(secret-tool lookup service fal.ai key api)"如何使用这个 Agent？
在装有目标游戏的机器上启动已安装的 AI 编程代理，从 um scan 开始识别游戏，再用 um kb search 查找相关 field note。向代理描述要制作的模组，按其流程勘察、备份存档、读取代码、构建切片、制作资源，并在运行中的游戏里验证。使用 um --help 查看 CLI 命令帮助；发布前运行检查，完成的经验可创建知识库笔记并提交贡献。
um scan
um kb search "grand theft auto"
um --help这个 Agent 有哪些优点和局限？
- 覆盖从游戏识别、引擎路线和反向工程，到资源处理、实机验证、视频制作和打包的完整模组流程。
- 通过
um scan与 field note 知识库复用游戏版本、验证记录和常见问题的处理方法。 - 为 Claude Code、Codex、Gemini CLI、VS Code / Copilot、Cursor 和 OpenCode 文档化了不同接入方式。
- 需要本地游戏文件、Git、Python 3.10+ 和 ffmpeg；3D 转精灵图还需要 Blender。
- fal 资源功能依赖 fal API 密钥；Sprixen 2D 美术又依赖单独的 API 密钥和付费服务。
- 工具不支持向带反作弊的在线游戏注入，也不处理绕过反作弊、DRM 或所有权检查的需求。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Universal Modder 当前 | 49 · 缺口较多 | Agent 插件 / 技能 | ★ 8.5k | 今天 | Python | Codex · Claude Code |
| Cheat Engine MCP Bridge | 59 · 缺口较多 | MCP 服务器免费 + 模型费 | ★ 1.7k | 2 个月前 | Lua | Codex · Claude.ai |
| Co-op Anything | 37 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 693 | 今天 | Python | Codex · Claude Code |
| Spring AI Alibaba | 53 · 缺口较多 | 开发框架免费 + 模型费 | ★ 11k | 13 天前 | Java | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 与 SECURITY.md 明确声明：不注入带反作弊的在线游戏、不绕过 DRM、不发布游戏文件或反编译代码、改动存档前先备份、按 PID 杀进程、驱动键鼠/安装加载器/发布前先询问，这些是加分项。但权限面本身很大：um win 可驱动真实输入、杀进程、写注册表；MCP 与插件安装会拉取外部代码；示例的 Minecraft×GTA 本地 WebSocket 无令牌监听 127.0.0.1:25599（作者自述为设计选择）。密钥处理有测试佐证（keyring 优先、文件 0600/目录 0700、secret-tool 走 stdin、status 掩码），但 .env 明文回退与 FAL_KEY 环境变量透传给 MCP 仍扩大暴露面。依赖仅 pillow/numpy/pyyaml 且无锁文件或哈希，外部工具（ffmpeg、Blender、ComfyUI、fal、Sprixen）未固定版本。回滚有 um backup 快照/差异/恢复，但仅覆盖存档目录，不覆盖加载器安装或注册表改动。来源归属在 Credits 中列出上游项目，但未逐文件标注。
测试覆盖编码、密钥查找、KB 搜索等具体行为，CI 运行 pytest 与各子命令 --help，说明内部一致性较好。但依赖可用性只声明 Python>=3.10 与外部二进制，无版本锁定；失败信息在测试中体现为 SystemExit 与提示，但 README 未系统说明错误码或诊断路径，故只给薄分。
面向多款 AI 编码代理（Claude Code、Codex、Cursor、Gemini CLI、Copilot、OpenCode）与多引擎，场景覆盖广；能力边界在 Rules 与 safety.md 中写明拒绝项。但触发精度依赖技能描述与 AGENTS.md 路由，仓库未给出触发/不触发的判定测试或冲突处理说明，故扣分。环境适配声明 Windows 原生或 WSL、Linux 键环，但未说明 macOS 细节。
README 结构清晰，安装表覆盖多代理，示例与知识库索引齐全，MIT 许可证完整。但无 CHANGELOG，版本仅 pyproject 0.2.0；已知限制分散在正文而非集中章节；维护责任仅指向 Discord 与 GitHub 私有报告，无治理或 SLA 说明；命名稳定性方面插件/市场名与仓库名耦合，未见弃用策略。
示例（Terraria、AoE2、Minecraft×GTA）与 CLI 子命令表显示可产出可用资产与模组，边际价值在于把侦察、逆向、资产生成、测试、视频串成闭环。但成本方面：三代理团队自述消耗数倍 token，fal/Sprixen 为付费服务，且需 Blender/ffmpeg 等重依赖，成本收益仅部分说明，故扣分。
README 的声明多可追溯到具体技能文件与示例目录，知识库要求记录版本与验证方式，属可追溯的雏形。但多数效果声明（如“几乎任何 PC 游戏”）无独立佐证，示例未附可复现的测试输出；事实与推断在 README 中混排（如“September 2026 wave”），未明确区分。静态审查无法验证运行结果。
- um win 具备真实键鼠驱动、按 PID 杀进程与注册表写入能力，误操作影响面大，建议在隔离环境或虚拟机中首次使用。
- 示例的 Minecraft×GTA 本地 WebSocket 无令牌监听 127.0.0.1:25599，作者声明为设计选择，但同机其他进程可访问。
- FAL_KEY 会通过环境变量透传给 MCP 服务器，且支持 .env 明文回退；优先使用 keyring 并避免在共享 shell 中导出。
- 外部依赖（ffmpeg、Blender、ComfyUI、fal、Sprixen）未固定版本，行为可能随上游变化。
- 发布者身份未经 FollowAgents 验证，安装插件或 MCP 前应自行审查代码与更新路径。