rehan-remade/universal-modder

universal-modder – AI 驱动的游戏模组工具包

是什么

• 一组 Agent Skills 和一个小型 Python CLI（um），让大型语言模型编码代理（Claude、Codex、Gemini、Copilot、Cursor 等）能够自动为几乎任何你拥有的 PC 游戏创建、测试和发布模组。
• 仓库提供一个 知识库（knowledge/），代理在此记录特定游戏的逆向工程笔记、所用引擎、以及成功步骤。新代理可在开始前搜索此知识库。

如何工作

1. Agent 插件 – 将仓库作为插件安装到你选择的 LLM 编码助手（参见 Install 下的表格）。插件会添加 skills/ 中的一组 技能 和每个代理读取的配置文件（AGENTS.md）。
2. mod-any-game 技能 – 这是主循环。它：
   • 在知识库中搜索目标游戏的过往工作。
   • 执行侦察（引擎检测、版本、反作弊状态、存档位置）。
   • 设置安全实验环境（备份存档、隔离进程）。
   • 读取游戏代码（使用 ILSpy、Ghidra 等反编译）。
   • 生成一个最小可运行的模组片段。
   • 通过 um fal 子命令调用 fal.ai，生成角色、纹理、3D 模型、声音、音乐或语音。
   • 使用自动化工具（um win 用于启动、截图、输入驱动）在游戏内验证模组。
   • 记录展示视频（um video）。
   • 打包模组并为未来代理撰写新的现场笔记。
3. CLI（um） – 提供每个阶段的具体命令：扫描已安装游戏、资产生成、3D 转精灵渲染、Windows 自动化、备份/恢复、知识库 CRUD、发布检查。
4. 安全规则 – 系统拒绝操作在线多人游戏，从不发送反编译的游戏文件，备份存档，并在任何侵入性操作前请求用户确认。

核心组件

• 技能目录 – 为 12 种引擎“剧本”（Unity、Unreal、.NET/XNA、Godot、Source、Bethesda、Minecraft、AoE2、RE Engine、原生 C++ 以及许多独立引擎）预写好的提示和脚本。每个剧本编码了该引擎的典型逆向工程和模组构建工作流。
• 知识库 – Markdown 格式的现场笔记（knowledge/games/<game>/<mod>.md），记录版本、路径、验证步骤和陷阱。代理可执行 um kb search "grand theft auto" 搜索，之后使用 um kb pr … 提交新笔记。
• Fal 集成 – 资产生成由 Fal AI 服务（图像转 3D、纹理超分辨率、音频合成等）处理。CLI 包装了 REST API（um fal …）。
• 自动化工具 – 用于安全鼠标/键盘注入和回环音频捕获的 PowerShell 工具，以及用于启动游戏、截图和录制视频的 Python 包装器。

仓库中的示例用例

• Terraria – 添加一个追踪导弹发射器和战术核，所有精灵均由 Fal 生成。
• Age of Empires II DE – 创建一个新文明，包含由 3D 模型渲染的机器人出租车单位。
• Minecraft × GTA V 混合 – 将 Minecraft 的渲染帧流式传输到 GTA V，通过 WebSocket 桥接同步相机和物理。

适合谁

• 构建 AI 辅助模组流水线的开发者。
• 探索自动化逆向工程和资产生成的研究人员。
• 希望获得可复现、AI 驱动的单人游戏模组工作流的爱好者。

安装快速入门

# 安装 CLI（需要 Python 3.10+，推荐使用 uv）
uv tool install git+https://github.com/rehan-remade/universal-modder
# 或使用 pipx
pipx install git+https://github.com/rehan-remade/universal-modder

# 导出 Fal API 密钥用于资产生成
export FAL_KEY=your_key_here

然后将仓库作为插件添加到你选择的 LLM 编码代理（Claude、Codex、Gemini、Copilot、Cursor 等）中，并运行 um scan 以发现你的游戏。

许可证 – MIT（字体在 SIL OFL 下）