用 universal-modder 给 Godot 3.x / 4.x 游戏做 Mod：从 GDPC pck 识别到四条改造路线

【免费下载链接】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 技能下references/engines/系列中 Godot 篇的完整解读与源码级佐证。读完你能掌握如何用GDPC魔数与 pck 头快速判定一个游戏是否为 Godot 构建、如何用um scan直接读出引擎版本、如何用 GDRE Tools 把整个项目场景、资源、反编译 GDScript恢复出来以及四条落地改造路线Godot Mod Loader、PCK overlay、override.cfg、Rebuild各自的适用条件与边界——从侦察到验证的完整闭环。先识别GDPC 魔数与两种 pck 布局给 Godot 游戏做 Mod 的第一步是确认它确实是 Godot 构建并拿到精确的引擎版本。识别特征在 godot.md 中定义为两种布局独立.pck文件与 exe 放在一起文件头 4 字节是GDPCpck 追加进 exe整个资源包被拼接在可执行文件末尾exe 本身以GDPC包的 8 字节长度字段 pck 内容收尾。um scan对这两种布局都会处理版本直接读自 pck 头。核心实现在 godot_pck 函数def godot_pck(path: Path) - str | None: with open(path, rb) as f: head f.read(20) if head[:4] bGDPC: fmt, major, minor, patch struct.unpack_from(4I, head, 4) return f{major}.{minor}.{patch} (pack format {fmt}) f.seek(-12, os.SEEK_END) tail f.read(12) if tail[8:] bGDPC: # pck appended to the executable size struct.unpack_from(Q, tail, 0)[0] f.seek(-12 - size, os.SEEK_END) head f.read(20) if head[:4] bGDPC: fmt, major, minor, patch struct.unpack_from(4I, head, 4) return f{major}.{minor}.{patch} (embedded in exe)从源码结构看pck 头的二进制布局是GDPC魔数 4 个小端 uint32依次为pack format、major、minor、patch嵌入 exe 时则从文件末尾倒数 12 字节校验GDPC倒数 8 字节是小端 uint64 的 pck 长度。检测流程 的优先级是先扫描安装目录中前 3 个*.pck文件命中即报 godot 引擎置信度 100若没有独立 pck再逐个检查前 6 个*.exe/*.x86_64看是否内嵌 pck命中后证据会标注为exe (embedded pck)。这一解析逻辑有离线测试直接覆盖test_godot_pck 构造了bGDPC struct.pack(4I, 2, 4, 2, 1)作为 pck 头断言检测结果为 godot 且版本号以4.2.1开头——即 pack format 2、引擎 4.2.1。所以当你运行um scan game看到godot且带版本后缀如4.2.1 (pack format 2)时这个版本号就是后续所有工作的前提编辑器版本必须与它对齐。um scan命中 Godot 后给出的默认路线见 ENGINES 表是recover the project with GDRE Tools; patch scripts/scenes via a PCK overlay or Godot Mod Loader即用 GDRE Tools 恢复项目通过 PCK overlay 或 Godot Mod Loader 打补丁。游戏逻辑在哪GDScript、加密 pck 与 C# 构建识别引擎之后要弄清逻辑代码的形态这决定了阅读与改造方式GDScript主流游戏逻辑是 GDScript。pck 中的脚本通常以tokenized形式存储.gdc即 GDScript 字节码有时还用每游戏不同的 key 加密。加密 pck 的 key 一般嵌在 exe 里——godot.md 的告诫是GDRE Tools 能针对许多构建自动找到 key但如果一款游戏是刻意加密的继续推进前先查它的 Mod 政策。C#.NET构建Godot 的 C# 项目会把Game.dll放在data_*文件夹如data_win64/里。这类构建的阅读方式与所有托管代码一致——用 ILSpy 反编译详见 dotnet-xna.md 的ilspycmd工作流。存档位置默认在%APPDATA%\Godot\app_userdata\Project\如果游戏设了use_custom_user_dir则用自定义的user://目录。这个路径是之后um backup create的输入动手前先快照。一个真实的 Godot 案例被写进了um scan的已知游戏表 KNOWNSlay the Spire 2是 Godot C# 混合体自带 Mod 加载器——mods/里是C#.dll Godot.pck.jsonmanifest三件套卡片、遗物和角色扩展走 BaseLibNuGet 包Alchyr.Sts2.BaseLib。测试 test_slay_the_spire_2_is_not_sts1 还专门验证了它不会被误配到 Slay the Spire 1 的 Java/ModTheSpire 路线上——版本判错比没判更危险。读取游戏GDRE ToolsgdsdecompGodot 是读游戏门槛最低的引擎之一因为 pck 本身就是项目内容的打包GDRE Toolsgdsdecomp能从 pck/exe 中恢复出完整可编辑的工程场景.tscn、资源、反编译出的 GDScript 源码。用与游戏匹配的 Godot 编辑器版本打开恢复出的项目就能直接理解代码结构与资源组织。这也是 reverse-engineering 技能 数据文件工具表里 Godot 一栏推荐的工具Unity 用 UABEA/AssetRipper、Unreal 用 FModelGodot 用 GDRE Tools。加密 pckkey 内嵌在 exeGDRE Tools 对许多构建能自动定位 key。再次强调原文的边界若游戏刻意加密先确认其 Mod 政策再继续。恢复出的代码就是spec——按 reverse-engineering 技能的总原则读真东西别猜把确认过的名字、ID、格式写进MODLOG.md反编译产物放在 Mod 仓库之外如~/game-decomp绝不发布。四条改造路线按成本从低到高选godot.md 给出四条路线选择逻辑与 mod-any-game 主流程 第 2 步一致选能达成想法的最便宜路线并把选择理由写进MODLOG.md。路线 1Godot Mod Loader游戏自带或社区已接入时首选如果游戏本身带 Mod 支持、或社区已经给游戏接入了 Godot Mod LoaderGodotModding/godot-mod-loader社区项目这是最干净的路线Mod 是mods/目录下的zip 包 manifest脚本扩展通过extend机制挂钩游戏方法Brotato、Dome Keeper 等游戏使用它上文 Slay the Spire 2 的自研加载器也是同一形态dll pck json manifest。判定方法就是um scan它会列出安装目录中已存在的加载器LOADERS 表mods/目录本身也在 MOD_DIRS 清单 中。如果社区已有官方加载器用它不要自造。路线 2PCK overlay资源覆盖最通用的只读内容路线Godot 支持加载额外资源包ProjectSettings.load_resource_pack(res://mod.pck)规则是后加载的包中、与已有res://路径同名的资源会覆盖前者。这意味着你只需制作一个只包含你要替换的场景/资源/脚本的 mod.pck就能整体覆盖游戏内容。关键限制原文说得很清楚调用它需要代码执行——load_resource_pack必须从一段被加载的代码里发出来源通常是注入的 autoload 或 Mod Loader。也就是说 PCK overlay 与路线 3 的override.cfgautoload 是配套的先用配置注入一个 autoload再由 autoload 调load_resource_pack。路线 3override.cfg纯配置注入 autoload / 换主场景在 exe 旁放一个override.cfgGodot 启动时自动应用的工程设置覆盖可以不改任何二进制地改变工程行为典型两条[autoload] MyMod*res://mod/my_mod.gd只要my_mod.gd所在的资源包已被加载例如 exe 内嵌 pck 或路线 2 的包这行就注册了一个 autoload 单例——它是你获得代码执行点的最小入口随后可由它调用load_resource_pack完成整条 overlay 链。另一条可用设置是application/run/main_scene把主场景指向你自己导出的 loader 场景从而引导整个启动流程。这是四条路线中最强的配置级手段也最需要与游戏的启动逻辑核对。路线 4Rebuild重导出仅限个人使用把 GDRE 恢复出的工程改掉后重新导出。原文设定了明确红线仅个人使用绝不重新分发重建后的游戏。这条与仓库安全规则的不重新分发条款一致mod-any-game 硬性规则不发布游戏文件、反编译源码或提取出的资源发布前跑um publish check mod --game install它专门检查与游戏文件逐字节相同的拷贝和反编译头。制作新内容--export-pack 与贴图导入元数据新增而非覆盖内容的标准做法新场景和脚本在与游戏版本一致的 Godot 编辑器里制作然后用--export-pack导出一个只包含你新文件的 pckgodot --headless --export-pack mod.pck project。不要导出整个项目——mod 包必须小到可审查、可分发。贴图PNG .import元数据文件成对存放。编辑器导出时会生成压缩贴图.ctex过滤方式必须与游戏一致——像素风游戏用 nearest点采样线性过滤会把像素画糊掉。这一节与仓库的资产管线衔接点生成类素材可以先过um fal每次调用记入fal_manifest.jsonl再用um sprite做抠图/缩放最后按上面的格式落进 mod.pck。坑与工程约束Pitfalls 全量原文 Pitfalls 三条逐条展开编辑器与运行时版本必须一致。4.2 与 4.3 之间存在资源格式变更——用 4.3 编辑器做的.tscn/.ctex放进 4.2 的 exe 里会加载失败。这就是um scan把 pck 头里的major.minor.patch读出来的原因它是你该安装的编辑器版本。GDScript 2.0Godot 4与 1.0Godot 3是两种语言。语法、类型系统、SceneTreeAPI 都有断裂式差异反编译结果和目标版本的写法不能互换写代码前先确认主版本号。godot-mcp可以在你构建新内容时驱动编辑器——对 Agent 工作流本仓库正是给 Claude Code 等 Agent 用的而言这意味着场景搭建、资源调整可以走编辑器自动化而不是手工点选。一条完整的 Godot Mod 工作流把 godot.md 与仓库工具链拼起来落地流程是侦察um scan game→ 报godot 版本号pck 头解析见 检测流程同时确认mods/、已知加载器、存档目录%APPDATA%\Godot\app_userdata\Project\。备份um backup create save folder --name game-saves把恢复路径写进MODLOG.md。恢复与阅读GDRE Tools 从 pck/exe 恢复工程用匹配版本的编辑器打开记录类名、场景路径、资源 ID。选路线有官方/社区加载器就走路线 1只改内容走路线 2PCK overlay --export-pack需要执行点时加路线 3 的override.cfgautoload全量改造且仅自玩才走路线 4。验证按 mod-any-game 第 7 步运行中的游戏才是 oracle——用um win launch/drive/shot驱动启动路径、看截图与日志确认同一失败重复 3 次就停手换路线。发布前检查um publish check确认没有游戏文件、反编译代码或密钥随 Mod 流出。Godot 是引擎手册里工具链最完整的一条线识别GDPC头、阅读GDRE、改造loader / overlay / cfg 三选一全部有成熟工具剩下的成败点集中在版本对齐与不越界Mod 政策、不重分发两处。赞分享【免费下载链接】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 中的 .NET 游戏 Mod 方法论XNA / FNA / MonoGame 游戏的识别、反编译、Mod 加载器与常见坑universal modder 中的 .NET 游戏 Mod 方法论XNA / FNA / MonoGame 游戏的识别、反编译、Mod 加载器与常见坑 本universal-modder mod-any-game从侦察到发布的 AI 游戏 Mod 全流程闭环方法论universal modder mod any game从侦察到发布的 AI 游戏 Mod 全流程闭环方法论 mod any game 是 universaWhishper进阶技巧如何优化转录准确性和效率Whishper进阶技巧如何优化转录准确性和效率 Whishper是一款强大的本地音频转录工具能够将任何音频转换为文本、翻译并编辑字幕完全在本地运行。本文上一篇Rust 编译器错误码 E0774 详解[derive] 只能应用于 struct、enum 与 union下一篇打破音乐枷锁开源桌面工具如何让你真正拥有数字音乐创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考