最近用 agent 跑的活越来越多，一直想让它试试游戏 mod 这种真实环境里的硬活，今天这个仓库正面回答了怎么做。

本周 Top5：VoiceStudio（+12,036）、ponytail（+8,596）、hindsight（+6,565）、paperclip（+6,030）、Agent-Reach（+5,703）。

本期主角不在上面。rehan-remade/universal-modder 创建于 9 月 30 日，六天攒下 3,895 星，是 GitHub 官方本周新建仓库榜的第一名，周榜 Top21 还没挤进去。mvschwarz/openrig（+3,776）连续第二天差一步进榜，用 Claude Code 和 Codex 组持久化 agent 团队，继续记一笔。上期主角 NVIDIA/OpenShell 掉出了本周 Top21，同期 Agent-Reach 还稳在第五，查资料这个需求的曲线没有回头。

universal-modder 目前 3,895 星、350 fork，MIT 协议，主体是 Python。作者 Rehan Sheikh 是 fal 的工程师，发布帖一天多拿了约六万浏览。定位一句话，把给 PC 单机游戏做 mod 的完整工艺装进编码 agent 的工具箱，agent 自己认引擎、读代码、生成美术、装进游戏验收，最后把学到的写下来留给下一个 agent。这篇讲三件事，AI 写给 AI 的知识库怎么转起来，agent 怎么确认自己没在做梦，现在上手的代价是什么。

图 官方横幅，mod any game

它是什么

传统 mod 工艺拆开是四层，引擎侦察、逆向读码、资产制作、游戏内验证，每层都有专门工具和多年社区经验，门槛把大多数人挡在外面。这个仓库把四层打包成 Agent Skills 格式的技能包，配一个 um 命令行和一个 fal 的 MCP 服务，Claude Code、Codex、Cursor、Gemini CLI、Copilot、OpenCode 装上就能用。

um scan 先扫你机器上的 Steam、Epic、Xbox 库存，认出每个游戏的引擎与版本、托管还是原生、有没有反作弊、存档在哪，排出可行的 mod 路线。确认目标后 agent 走一条固定的十步循环，查知识库找前人笔记，侦察定路线，备份存档建安全实验室，读真代码，先做一刀能跑的小切片，生成美术资产，装进真游戏验证，录像，打包，写战地笔记收尾。

图 官方管线图，上排 3D 路线从概念图到 16 方向精灵帧，下排 2D 路线从生图到精灵落进泰拉瑞亚

资产这层接的 fal 能出精灵图、贴图、音效、音乐、语音，还能图生 3D 再用 Blender 按游戏相机角度渲染成多方向精灵帧，配套技能覆盖 12 类引擎，从 Unity、Unreal、Source 到《帝国时代2》的 Genie 引擎和复古游戏反编译都有对应手册。

为什么有意思

知识库是产品，mod 只是演示

knowledge 目录现在躺着 48 篇游戏笔记和 8 篇技法笔记，索引由脚本从笔记前置元数据自动生成。每篇带精确游戏版本、走的路线、验证方法、执行的 agent 型号署名，坑按症状、原因、修法三段写。博德之门3一篇笔记记录二幕加载卡死在百分之五十的排障，对全部 524 个 pak 做静态扫描一无所获，最后把嫌疑 mod 的 pak 拆成两半二分，11 次测试启动定位到 Many More Monsters 的一个 NPC 挂在错误的 level layer 上，卡死与闪退是同一个故障地址。贡献规则要求诚实标注状态，火影角色移植一篇明明白白写着 abandoned，两个游戏的 CPK 包都加密了。社区 agent 已经在交笔记，署名里有 OpenCode 带 DeepSeek，也有免费小模型。

外部评测用一句话概括这个设计，mod 是消耗品，知识是复利。泰拉瑞亚的战术核弹是演示，会积累的知识库才是这个仓库的主要产出。

agent 怎么确认自己没在做梦

技法笔记里有一篇专门讲验证，把验证手段叫 oracle。文件格式理解对不对，解码再编码回读逐字节比对，《帝国时代2》精灵格式实测平均误差 0.91/255 才允许写新文件。改的行为跟原版一致不一致，把真实帧状态喂给模拟器逐变量对表，泰拉瑞亚 boss 战复刻与原版一致到 99.9%。游戏还没装就先测集成，拿一个假 D3D11 宿主跑真的合成器，金色参照墙测出了与宿主之间一帧的位姿超前。配套规则写得很实，截图必须真的打开看，同一个原因失败三次就熔断换路线，MODLOG.md 里的已证事实要能活过上下文压缩。

图 案例成果，fal 图生 3D 做出的 Robotaxi 概念图，后续按《帝国时代2》相机渲染成游戏内单位

两盘游戏缝成一个

README 案例里最夸张的是把《我的世界》缝进 GTA5 单机剧情模式。Fabric mod 和 ScriptHookV 插件经本地 WebSocket 交换相机、地面和事件，《我的世界》画面按深度合成进 GTA 的帧，TNT 引爆变成 GTA 的爆炸。合成器先在假宿主上跑通再进真游戏。同族案例还有《光环3》武器进《我的世界》，以及用 CS2 规则改造艾尔登法环离线版。

边界与局限

版本很早，正式 release 一个没有，issue #5 直接批评代码质量，#13 报 Gemini CLI 扩展装不上。资产生成走 fal 按量计费，3D 和视频最贵，作者建议动手前先跑 um fal price 看价目，没有 key 可以接本地 ComfyUI 出图。范围卡得很死，只做你拥有的单机离线游戏，反作弊在线游戏和多人作弊直接拒绝，不外发游戏文件和反编译代码，动存档先备份，动键鼠先问人。Mac 支持挂在 #16，手机是 #6。外部评测还有一句提醒，二十秒的展示视频证明不了长时间游玩稳定，社媒上疯传的串游 mod 也不都出自这个工具。

对谁有价值

手里有单机游戏库、天天用 Claude Code 或 Codex 的人，现在就值得装，从 um scan 加查知识库起步，挑一个 mod 加载器成熟的游戏下手。想搞明白 agent 怎么在真实环境里验证自己的工程者，oracles 那篇笔记单独就值回票价。想一键白得爆款串游 mod 的人可以先散了，fal 的账单和代码质量的批评都是真的。

我的打算很直接，先挑一个带成熟加载器的单机游戏试一刀，存档交给 um backup，资产成本先跑 um fal price 看清，再决定做多大多花哨。

数据截至 2026-10-06，来源 GitHub API、仓库 README 与 knowledge 目录（BG3 二幕排障、oracles、GTA5 passthrough 笔记）、issues #2 #5 #6 #13 #16、作者发布帖、外部评测（nohumans.jp 2026-10-04、aifrontierpost 2026-10-01）

GitHub 仓库 https://github.com/rehan-remade/universal-modder