GitHub Universal Modder 安装与使用
用 Universal Modder 帮助 Claude Code 分析你拥有的 PC 游戏、制作 Mod，并在游戏中验证。
关于 Universal Modder
Universal Modder 把代理技能、um 命令行工具、fal MCP 集成和共享经验笔记组合起来，帮助 AI 为 PC 游戏制作 Mod。它引导代理识别游戏引擎与可行的改造路径、检查代码、完成小范围修改，并在实际游戏中验证结果。这是制作 Mod 的工具包，不是现成 Mod 下载，也不能替代具体游戏所需的加载器。
- 针对本机安装的 PC 游戏识别引擎并规划 Mod 路线。
- 提供用于检查、素材、测试、打包和经验记录的代理技能与 um 命令行工具。
- 可选用 fal 生成图片、3D 和音频素材；这一流程需要单独的 fal 密钥。
项目演示
安装前准备
- 一款你拥有、可在本机检查的 PC 游戏；先备份存档，并在单独的测试环境尝试。
- Git、Python 3.10+ 和 ffmpeg；维护者推荐使用 uv。
- 使用 fal 生成素材需要 API key；本机 ComfyUI 图像生成可不配置。把 3D 模型渲染成精灵图还需要 Blender。
Windows 游戏需要在 Windows 本机或 WSL 环境中操作；Mac 或 Linux 上运行代理，不代表目标游戏及加载器也能在该系统运行。
如何安装
先启动 Claude Code，在会话中逐行运行下面两条斜杠命令；不要把它们输入系统终端。
Claude Code
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder安装的是工具包，不会自动安装游戏或生成现成 Mod。素材生成等可选功能按维护者文档另行配置。
开始使用
在 Claude Code 中安装插件后，选择一款你拥有的 PC 游戏。先让代理评估引擎与加载器，备份存档，再从一个小改动开始，并在实际游戏中验证。其他代理的安装方式、依赖与完整流程见维护者 README。
使用前留意
阅读项目指令和请求的工具权限，先在小范围任务中验证。本站核对来源与说明，收录不代表代码安全审计。
第一次使用
- 1在 Claude Code 会话里运行上方两条插件命令，然后确认插件已安装。
- 2告诉代理游戏名称和安装位置，先让它识别引擎、已有 Mod 方案及限制。
- 3核对生成的计划，从一个小改动开始，在实际游戏中验证，再决定是否扩展。
可以这样发出第一条请求
请检查 C:\Games\Foo 是什么游戏引擎、当前版本有哪些可靠的 Mod 方案。先查知识库并给出计划、需要的工具和风险，暂时不要修改游戏文件。
第一步应得到侦查结果和可核对的方案；实际制作仍需选择具体改动，并在游戏中验证。
各部分负责什么
Agent Skills
引导代理侦查游戏、选定 Mod 路线、制作并验证一个可运行的小版本。
um CLI
用 um scan 识别安装与引擎，用 um backup 保护存档，并提供素材处理与发布检查命令。
知识库
按游戏和版本查找已有实践记录，包括路线、验证方法和常见问题。
fal MCP / um fal
按需生成图像、3D、音频和视频素材；需要单独的 fal API key。
um comfy
连接本机 ComfyUI 服务生成图像；需要自行准备可运行的本地服务。
常见问题
- 这是现成的游戏 Mod 下载吗？
- 不是。它是一套帮助 AI 编码代理制作和测试游戏 Mod 的工具；具体游戏通常还需要对应的社区加载器或构建步骤。
- 不用 fal 能开始吗？
- 可以先用占位素材或已有素材。生成图像时，um comfy 也可连接本机运行的 ComfyUI 服务，不需要 fal API key。
- 真的支持所有 PC 游戏吗？
- 项目目标是覆盖广泛的 PC 游戏，不保证每款游戏都能自动完成。可行路线取决于游戏版本、引擎、加载器和运行环境。