【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址https://gitcode.com/gh_mirrors/un/universal-modder点击查看免费下载Universal Modder 的mod-any-game技能把「选定改造路线」做成了一张引擎路由表:um scan识别出游戏引擎后,指向 references/engines/ 下对应的 playbook。misc-engines.md 正是其中覆盖「长尾引擎」的一份快速路线手册,涵盖 GameMaker、RPG Maker、RenPy、Paradox(Clausewitz/Jomini)、id Tech/Doom 系、HTML5/Electron/NW.js、LÖVE、Java 与 Defold/Cocos2d-x/Haxe 九类。读完本篇,你能针对这些常见的小众/独立游戏引擎判断出:数据文件在哪、用什么工具解开、代码以什么形态存在、以及哪条路线(纯数据 / 插件加载器 / 字节码)能最便宜地实现你的 Mod 想法。这份 playbook 在 mod-any-game 工作流中的位置SKILL.md 定义的标准循环是:Recon(侦察)→ 选最便宜的路线 → 建实验室 → 读源码 → 垂直切片 → 素材 → 验证 → 录像。其中第 1 步侦察由um scan game完成,它会报告引擎与版本、代码是托管还是原生、反作弊情况,并告诉你该读references/engines/里的哪一份 playbook。这个「引擎 → playbook 路线」的映射就硬编码在 um/scan.py 的ENGINES表中,长尾引擎的条目与misc-engines.md一一对应:引擎键标签表内给出的默认路线(节选)gamemakerGameMakerUndertaleModTool:反编译/编辑data.win里的 GML、精灵与房间rpgmaker-mvmzRPG Maker MV/MZ (NW.js)js/pluginsjs/plugins.js的 JS 插件;data/*.json数据库编辑rpgmaker-rgssRPG Maker XP/VX/VX Ace (RGSS Ruby)解包 RGSS 存档,编辑Scripts.rvdata2中的 RubyrenpyRenPyunrpa/unrpyc读取;向game/添加.rpy文件clausewitzParadox Clausewitz/Jomini纯文本脚本 Mod,位于Documents/Paradox Interactive/game/modidtechid Tech / Doom 家族WAD/PK3/PK4 Mod,source portelectronElectron / NW.js / HTML5解包resources/app.asar(或package.nw),改 JS,开 devtoolslove2dLÖVE (Lua).love/exe 就是 Lua zip;补丁或 lovely 注入javaJava反编译 jar(Vineflower/CFR),用 Mod 加载器或字节码(Mixin/ASM)打补丁defold/cocos/haxeDefold / Cocos2d-x / Haxe解包game.arcd;Lua/JS 脚本;assets/覆盖检测逻辑同样在 um/scan.py 中:例如 GameMaker 按data.win/game.unx等文件直接给 100 分(L526),Electron/NW.js 靠resources/app.asar、package.nw、nw.dll等线索(L602-L605),LÖVE 靠love.dll/*.love(L608-L609),Java 靠 jar 数量与自带 JRE 判断(L611-L612)。个别知名游戏还有手工覆盖表,如 Balatro 直接指向「Steamodded lovely(Lua 注入)」并挂到本 playbook(L377),Doom 指向「WAD/PK3 GZDoom/UZDoom」(L382)。以下各节按原文档的引擎顺序展开,并结合仓库中的实现证据补充细节。GameMaker(data.win、game.unx)UndertaleModTool(UTMT)是默认工具:它能打开data.win,提供 GML 反编译/重编译、精灵、房间、声音、字体资源,以及用于批量编辑的 C# 脚本(存在 CLI 构建用于自动化)。它覆盖 Undertale、Deltarune、Pizza Tower 以及大多数 GMS2 游戏。关键警告在原文档最后一句,也是最容易踩的坑:YYC(编译)导出的代码是原生代码,GML 被编译进了 exe,data.win里没有代码,此时应转入 native.md 的原生逆向路线。仓库中的实战笔记 GameMaker YYC vs VM 检测 给出了可操作化的判据:um scan对 VM 和 YYC 构建都会报告bytecode_version(该字段读自 GEN8 chunk,两种导出都有),所以字节码版本不是「代码可编辑」的证据。真正的方法是在规划任何工作之前,扫一遍 chunk 表看CODEchunk(VARI、FUNC随它出现;FEAT是 GM2022.8 的特性标志,不是代码):存在且长度 0→ GML VM,UndertaleModTool 可以反编译、编辑、重编译 GML;缺失(bytecode 17)或长度为 0(bytecode ≤ 16)→ YYC,代码在 exe 里。chunk 帧格式:data.win以FORM开头,偏移 8 处开始 chunk 列表;每个 chunk 是 4 字节 ASCII 名 小端uint32长度 length字节数据,下一个 chunk 在pos 8 length。正确走完 chunk 表应恰好落在文件末尾。该笔记附带的参考实现:import struct def gm_chunks(path): b open(path, rb).read() assert b[:4] bFORM, not a GameMaker data file pos, chunks 8, [] while pos 8 len(b): name b[pos:pos 4] try: text name.decode(ascii) except UnicodeDecodeError: break if not text.isalnum(): break length struct.unpack_from(I, b, pos 4)[0] chunks.append((text, length)) pos 8 length return chunks, pos len(b) # ([(name, length)], walk was complete) chunks, complete gm_chunks(r...\data.win) is_yyc not dict(chunks).get(CODE) # absent, or empty in bytecode 16 YYC builds也可以用工具自身确认:UndertaleModCli.exe info data.win会直接打印Is YYC - True/False。该笔记还实测了四款 GameMaker 游戏(Cook, Serve, Delicious! 3?! 为 GML VM,Loop Hero / Katana ZERO / Tormentor X Punisher 均为 YYC),并指出两条反直觉结论:exe 大小不能当判别依据(YYC 的 Tormentor X Punisher exe 只有 7.9 MB,与 VM 构建相当);info能跑通不等于资源可改——YYC 文件能列出完整资产清单,但dump --sprites会以「代码被编译进 exe,无代码可 dump」退出,replace会抛NullReferenceException。最后一条分发规则:修改前先备份data.win,发布 Mod 时用xdelta 补丁分发,绝不发布整个修改后的data.win。RPG Maker原文档按两代引擎拆开:MV/MZ(NW.js JavaScript)插件是js/plugins/下的 JS 文件,在js/plugins.js中注册;数据库是data/*.json(角色、物品、地图、事件),改数据即改游戏;加密资产(.rpgmvp/png_这类改名后缀)的密钥在data/System.json里,社区已有解密器;playtest 构建按 F12/F8 开 devtools,或在package.json中启用。因为 MV/MZ 本质是 NW.js 打包的网页应用,它与下一节 HTML5/Electron 的路线相通:devtools 控制台本身就是你的 Mod 加载器。XP/VX/VX Ace(Ruby RGSS)脚本在Data/Scripts.rxdata/.rvdata/.rvdata2(Marshal 序列化 zlib 压缩的 Ruby);加密存档为Game.rgssad/.rgss2a/.rgss3a,社区有解包器;RPG Maker 2000/2003 则走 EasyRPG 的 liblcf 格式解析。RenPy(renpy/、game/*.rpa)读取工具链:unrpa解.rpa存档,unrpyc反编译编译后的脚本。Mod 的形态是往game/里放额外的.rpy文件,不需要动原脚本:新增 label 和 screen、覆盖config、用更高优先级init块改写行为。调试入口:通过config.developer True启用 RenPy 控制台,游戏内 ShiftO 打开。这是典型的「加载器即目录约定」的引擎——um scan对它的建议路线正是「unrpa/unrpyc 读取;向game/添加.rpy文件」(um/scan.py)。Paradox(Clausewitz/Jomini:EU4、CK3、HOI4、Stellaris、Victoria 3)这类大战略游戏的一切几乎都是纯文本:事件、决议、兵种、GUI 都是脚本。Mod 是放在Documents/Paradox Interactive/Game/mod/mod/的纯文本脚本 Mod,带一个.mod描述符文件;较新的游戏改用.metadata/metadata.json。排错入口是logs/error.log,官方 wiki 记录了每个 trigger 和 effect。仓库里有一个完整的 Clausewitz 数据流案例可作纵深参考:South Central 1985:Victoria 2 全面转化。该笔记验证了原文档「Everything is data」的判断——一个 265 省的新世界地图、48 种商品换皮、事件与全程序化贴图,全部用文本 BMP/DDS 完成,零 exe 补丁。其中对本节读者直接有用的实现细节:replace_path不递归,.mod描述符里每个原版子目录都要单独一行,且history/*路径必须用引擎自己的大小写写法(如history/Provinces/sub);用户数据与日志跟随user_dir落到Documents\Paradox Interactive\Victoria II\user_dir\(logs\、map\cache\);「文件的存在本身会创建对象」:没有参与者的战争文件会创建一个空战争,没有数据的省份文件会重置该省份——所以影子(stub)文件要极其小心,该案例因此踩了两次崩溃;Victoria 2 的 Mod 实际放在游戏目录game\mod\下而不是 Documents,victoria2.exe只是 .NET 启动器,真正的游戏是v2game.exe。这些细节提醒:原文档给出的「纯文本脚本 Mod」路线成立,但每个 Clausewitz 游戏的引擎代际(老 Clausewitz vs Jomini)在描述符、缓存和路径匹配上有差异,落地前应以官方 wiki 与该游戏社区为准。id Tech / Doom 家族经典 Doom:在 source port(GZDoom/UZDoom)上跑 WAD/PK3 Mod,用 ZScript/DECORATE 写脚本;地图用 Ultimate Doom Builder 编辑,文件用 SLADE 检视。Quake:pak0.pak QuakeC;Quake 2/3 有源码发布,可以基于官方源码做 total conversion。较新的 idTech(DOOM Eternal):原文档的表述很克制——目前只有社区工具,且限于离线。仓库的 scan 表对 Doom 的默认路线同样是「WAD/PK3 source port」(um/scan.py),注意这条路线针对的是经典引擎,不能外推到 Eternal。HTML5 / Electron / NW.js 游戏这一节把「现代桌面壳」的游戏归为一类,核心事实是逻辑就是明文 JS:Electron:resources/app.asar是打包体。用npx electron/asar extract app.asar app/解出,修改 JS 后重新打包;或者干脆不打包,重命名让引擎优先使用resources/app/目录。NW.js:package.nw或散放的普通文件。在package.json里设chromium-args: --remote-debugging-port9222即可连远程调试,或用nw.Window.get().showDevTools()直接开 devtools。Construct(c3runtime.js)、Phaser、PixiJS:逻辑是纯 JS;Construct 的事件表被编译进运行时 JSON,读 JSON 即可理解行为。自己可控的浏览器游戏:devtools 控制台就是你的 Mod 加载器,直接注入脚本即可,无需任何补丁。对应地,um scan对 Electron/NW.js 的建议路线是「解包resources/app.asar(或package.nw),改 JS,开 devtools」(um/scan.py),与原文档完全一致。LÖVE(Lua)LÖVE 游戏的分发表就是一个 zip:要么是.love文件,要么是追加在 exe 尾部的 zip 数据。解压缩后直接读 Lua 源码即可。如果不想重打包,可以用注入框架;原文档给出的实例是 **Balatro 社区方案:lovely(Lua 补丁注入) Steamodded**,um scan的手工覆盖表也把它登记为 Balatro 的默认路线(um/scan.py)。Java 游戏(非 Minecraft)Minecraft 有自己的专门 playbook(minecraft.md),本节针对其他 JVM 游戏:反编译:Vineflower、CFR、Procyon 出代码,Recaf 支持边编辑边反编译;社区加载器优先:Slay the Spire:ModTheSpire BaseMod,补丁注解SpirePatch;Starsector:官方 Mod API;Project Zomboid:Lua Mod 加 Java。没有加载器时:Java agent(-javaagent)配 ASM/ByteBuddy 做字节码增强,或用 Mixin 做方法级补丁。um scan对 Java 的默认建议正是「反编译 jar(Vineflower/CFR),用 Mod 加载器或字节码(Mixin/ASM)打补丁」(um/scan.py);检测上它以 jar 文件数量与是否自带jre/目录来判断(L611-L612)。Defold、Cocos2d-x、Haxe/OpenFL三个「小引擎」的快速判据:Defold:game.arcd/.arci存档,脚本是 Lua,社区有解包器;Cocos2d-x:Lua/JS 脚本包(有时用 XXTEA 加密,密钥藏在二进制里),解不出脚本就归入原生路线(native.md);HaxeFlixel/OpenFL:assets/目录覆盖是最低成本的资源 Mod;部分游戏内嵌了 Polymod(hscript)Mod 支持,有就用。通用底线:安全与分发以上九类路线都受 SKILL.md 硬规则的约束,与 safety.md 的详细解释配套:只 Mod 自己拥有的游戏,并且优先单人/离线;带反作弊的在线客户端一律不碰;先备份:动存档或游戏目录前用um backup create saves folder --name game-saves做快照(例如 GameMaker 一节要求的「先备份data.win」);不重分发:Game 文件、反编译出的源码、解包出的资产都不随 Mod 发布;只发布自己的代码、资产,或运行在用户自己安装之上的补丁/转换工具(如 xdelta 补丁、「自带游戏文件」式工具);反编译产物不进仓库:um scan报告的路线(如 UTMT、Vineflower)产出的反编译代码应放在仓库外(如~/game-decomp)并 gitignore。相关仓库路径速查路径内容skills/mod-any-game/references/engines/misc-engines.md本文主体:长尾引擎快速路线skills/mod-any-game/SKILL.md完整 Modding 循环与硬规则skills/mod-any-game/references/engines/native.mdYYC/Cocos 等转入原生路线时的 proxy DLL、签名扫描、MinHook 手册um/scan.pyENGINES路由表:引擎 → playbook → 默认路线knowledge/techniques/gamemaker-yyc-vs-vm-check-the-code-chunks-before-trusting-th.mdGameMaker VM/YYC 的 chunk 表判据与实测数据knowledge/games/victoria-2/south-central-gang-total-conversion.mdClausewitz 纯数据全面转化的落地案例knowledge/INDEX.md知识库总索引,可按游戏与技巧检索更多实战笔记赞分享【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址https://gitcode.com/gh_mirrors/un/universal-modder点击查看免费下载相关推荐用 universal-modder 给 Godot 3.x / 4.x 游戏做 Mod从 GDPC pck 识别到四条改造路线用 universal modder 给 Godot 3.x / 4.x 游戏做 Mod从 GDPC pck 识别到四条改造路线 本文是 universalRPG-Paper-Maker打造个性化3D游戏世界的强大引擎RPG Paper Maker打造个性化3D游戏世界的强大引擎 项目介绍 RPG Paper Maker 是一款开源游戏制作引擎适用于非商业用途。该引擎让用2025-2026终极指南LÖVE引擎未来路线图与功能规划全解析2025 2026终极指南LÖVE引擎未来路线图与功能规划全解析 LÖVE是一款基于Lua的出色2D游戏框架深受独立开发者喜爱。本文将全面揭秘LÖVE引擎2游戏开发图形学上一篇终极指南如何用OpenRocket免费开源软件设计完美火箭模型下一篇RT-DETR完整安装指南从零开始构建实时目标检测系统 创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考