Repolode
rehan-remade

rehan-remade/universal-modder

一套技能、CLI 工具与 MCP 服务,让 AI 编程代理能分析、改造并测试你拥有的 PC 游戏,素材可由 fal 生成。

Star
8,461
Fork
934
未关闭 Issue
26
最近提交
12小时前

这是什么?

Universal Modder 为 Claude Code、Codex、Cursor、Gemini CLI 等 AI 编程代理提供一套 PC 游戏改造流程。代理会识别游戏的安装位置、引擎和版本,选择改造路线,阅读游戏代码,构建可运行的 Mod,并在游戏中实际验证。配套的 `um` 命令行工具可以扫描安装目录,通过 fal 生成精灵图、3D 模型和音频,录制窗口与声音,并剪辑展示视频。

项目覆盖 Unity、Unreal、.NET/XNA、Godot、Minecraft、帝国时代 II 和 Bethesda 等多类引擎,并附带 ILSpy、Ghidra、Frida 等逆向工具。技能遵循固定流程:检索已有笔记、侦察、备份存档、实现一个功能切片、生成素材、验证并记录。代理还能向仓库内的共享知识库提交实践笔记。

项目不会向带反作弊的在线游戏注入代码,也不会针对其他玩家作弊,且不会分发游戏文件或反编译代码。使用前需安装 Git、Python 3.10+ 和 ffmpeg,生成素材还需要 fal API 密钥。

核心功能

  • 01扫描 Steam、Epic 和 Xbox 安装目录,识别引擎、版本与反作弊情况。
  • 02提供逆向工程、侦察、素材生成和游戏内测试等代理技能。
  • 03通过 fal 生成精灵图、3D 模型、纹理和音频。
  • 04录制游戏窗口与仅游戏的声音,并可将输入只发送到游戏窗口。
  • 05修改前备份存档,发布检查会阻止游戏文件被打包上传。

适用场景

  • 借助 AI 生成的精灵图,为 Terraria 添加新武器或敌人。
  • 为帝国时代 II DE 制作新文明或新单位。
  • 录制并剪辑已完成 Mod 的展示视频。
  • 查询某款游戏是否有过改造先例以及它使用的引擎。

快速上手

  1. 1

    使用 uv 安装 um 命令行工具

    uv tool install git+https://github.com/rehan-remade/universal-modder
  2. 2

    保存你的 fal API 密钥(可选,用于生成素材)

    um fal key set
  3. 3

    将技能安装到你的 AI 编程代理中

    npx skills add https://github.com/rehan-remade/universal-modder

使用前须知

  • 仅适用于你拥有的 PC 游戏,且 README 要求代理不得对其他玩家作弊。
  • 素材生成需要付费的 fal API 密钥,生成精灵图需要 Sprixen 密钥,或使用本地 ComfyUI 服务器。
  • 3D 转精灵图渲染需要 Blender,Windows 游戏需原生运行或通过 WSL 运行。

标签

常见问题

universal-modder 是什么?
一套技能、CLI 工具与 MCP 服务,让 AI 编程代理能分析、改造并测试你拥有的 PC 游戏,素材可由 fal 生成。 Universal Modder 为 Claude Code、Codex、Cursor、Gemini CLI 等 AI 编程代理提供一套 PC 游戏改造流程。代理会识别游戏的安装位置、引擎和版本,选择改造路线,阅读游戏代码,构建可运行的 Mod,并在游戏中实际验证。配套的 `um` 命令行工具可以扫描安装目录,通过 fal 生成精灵图、3D 模型和音频,录制窗口与声音,并剪辑展示视频。
universal-modder 可以免费使用吗?用的什么许可证?
universal-modder 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
universal-modder 还在维护吗?
活跃维护中。universal-modder 最近一次提交是在 2026年10月19日。
universal-modder 适合用来做什么?
借助 AI 生成的精灵图,为 Terraria 添加新武器或敌人。 为帝国时代 II DE 制作新文明或新单位。 录制并剪辑已完成 Mod 的展示视频。 查询某款游戏是否有过改造先例以及它使用的引擎。
universal-modder 怎么安装和运行?
使用 uv 安装 um 命令行工具: uv tool install git+https://github.com/rehan-remade/universal-modder 保存你的 fal API 密钥(可选,用于生成素材): um fal key set 将技能安装到你的 AI 编程代理中: npx skills add https://github.com/rehan-remade/universal-modder
在哪里获取 universal-modder?
源代码和安装说明在 GitHub 上:https://github.com/rehan-remade/universal-modder

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目