GDSDecomp 实战教程：GDScript 反编译、PCK 提取与 Godot 项目恢复一篇讲清

GDSDecomp 实战教程GDScript 反编译、PCK 提取与 Godot 项目恢复一篇讲清【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecompGDSDecompGodot RE Tools是跑在 Godot 引擎里的逆向模块能把游戏的 PCK、APK 或 EXE 还原成可编辑的工程。它承担逆向流程里最费时的三件事反编译 GDScript 字节码、提取资源、恢复项目文件。无论你是想研究某个游戏的实现还是想找回弄丢的源码目录它都能替你省掉手搓格式解析的活儿。项目说明支持版本Godot 4.x / 3.x / 2.x 项目字节码定义覆盖 2014 年以来 50 个版本运行平台以 Godot 引擎模块形式运行预编译发布或源码编译均可安装方式预编译包、ScoopWindows、Godot fork 源码编译许可协议MIT 快速上手从安装到跑通第一条提取命令最省事的路径是预编译发布包解压即用。Windows 上也可以用 Scoop 两条命令装好scoop bucket add games scoop install gdsdecomp装好后立刻跑通你的第一条提取命令gdre_tools --headless --extractgame.pck --outputextracted不写--output也行默认输出到文件名_extracted目录。想自己编译的话把项目 clone 进 Godot 的 modules 目录再用 scons 构建另外需要 rustup 和 .NET SDKgit clone https://gitcode.com/GitHub_Trending/gd/gdsdecomp godot/modules/gdsdecompGUI 里的 PCK explorer 能直接浏览包内文件、当场反编译 .gdc和命令行能力等价。 能力讲解按你要做的事分四组资源提取PCK 本质是目录式存档提取就是逐文件解包落盘APK 和 EXE 里内嵌的存档同样支持。gdre_tools --headless --extractgame.pck --outputextracted加密包追加--key64位十六进制密钥只看不想解用--list-files文件。完整项目恢复恢复 提取 反编译 资源重导入 项目文件重建一条命令全做完它会补回 project.godot 和插件配置并把二进制场景资源转回文本格式。gdre_tools --headless --recovergame.pck --outputrecoveredGUI 里对应“Extract only / Full Recovery”两个选项也可以直接把 PCK 拖进窗口启动。批量反编译脚本.gdc 是字节码工具为每个引擎版本备了一份独立定义版本对得上就能还原出可读的 .gd。gdre_tools --headless --decompileres://**/*.gdc自动识别不准时用--bytecode4.3.0手动指定版本--compile则能把 .gd 编回 .gdc。重新打包与修补pck-create 把目录重新打成 PCKpck-patch 往现有包里新增或替换个别文件还能用--embed把结果写进 EXE。gdre_tools --headless --pck-createmodified --pck-version2 \ --pck-engine-version4.3.0 --outputmodified.pck 实战演练场景一恢复一个 PCK 工程并验证结果目标把一个游戏 PCK 变成能直接编辑的工程目录。步骤gdre_tools --headless --list-filesgame.pck gdre_tools --headless --recovergame.pck --outputproj验证跑完会弹出报告窗口GUI或写入日志CLI核对反编译脚本数、成功转换的资源数、失败文件数。报告末尾会写明该用哪个版本的 Godot 编辑器打开工程并生成 gdre_export.log 文件——万一遇到 bug报问题时附上它。场景二替换单个脚本并写回包目标修改 main.gdc把改动写回原包。步骤gdre_tools --headless --decompileres://main.gdc gdre_tools --headless --compileres://main.gd --bytecode4.3.0 gdre_tools --headless --pck-patchgame.pck \ --patch-filemain.gdcres://main.gdc --outputpatched.pck验证再跑--list-filespatched.pck确认 main.gdc 尺寸变了、文件总数不变。 参数速查表参数作用备注--extract文件解包 PCK / EXE / APK加密包搭配--key--recover文件完整项目恢复输出工程文件 脚本源码--decompile路径.gdc 转 .gd支持 glob如res://**/*.gdc--compile路径.gd 编译为 .gdc需要--bytecode--pck-create目录从目录创建 PCK必填--pck-version与--pck-engine-version--pck-patchpck向现有 PCK 增改文件--patch-file源文件res://目标可重复--list-files文件列出包内文件列完即退出--key密钥解密密钥64 位十六进制字符串--include/--excludeglob 过滤可重复使用--bytecode/--force-bytecode-version指定字节码版本版本号或 commit 哈希均可--list-bytecode-versions列出支持的版本排查版本时用--output目录输出目录默认名称_extractedglob 规则有四条要记住递归用**res://*.gdc只匹配根目录一层不写前缀时自动挂在res://下不带目录的纯通配符如*.gdc按res://**/*.gdc处理只匹配包内真实存在的文件main.gd不在 PCK 里时用它过滤什么都恢复不出来要匹配main.gdc❓ 避坑指南Q反编译出来的内容乱码或有占位文本现象产出的 .gd 部分行是占位符或整个文件还原失败。 原因字节码版本和游戏实际编译用的引擎版本对不上。 解法先跑--list-bytecode-versions看清单再用--force-bytecode-version4.3.0或对应 commit 哈希重试。Q加密包提取时报校验错误现象提取过程中报 MD5 错误或文件整体无法识别。 原因没给密钥或游戏压根没走 Godot 标准加密。 解法有密钥就带--key密钥仍报错可加--skip-checksum-check跳过校验属于自定义加密的参考 docs/custom_decryptors.md 编写解密脚本。Q恢复出的工程打开后一片红现象编辑器里脚本、shader 大量非导入类错误。 原因编辑器版本和游戏用的版本不一致或游戏用了魔改 Godot。 解法换成恢复日志里标注的那个编辑器版本还是不行就用游戏原始二进制作为导出模板。Q--include过滤后什么都没命中现象加了过滤条件结果列表是空的。 原因glob 没挂在res://下或者没写**导致不递归。 解法写成res://**/*.gdc另外记住过滤只认包内真实存在的文件。Qpck-create 跑起来直接被拒现象命令一执行就报错。 原因缺参数。 解法--pck-version和--pck-engine-version必须成对提供缺一不可。开始之前三件事放在前面说只对有权处理的项目做逆向动手前备份原始 PCK / EXE输出文件别覆盖原件编辑器版本尽量与游戏版本一致以恢复日志的提示为准。到这里解包、还原、再打包这条完整逆向链路你就都拿到了CLI 覆盖全部能力GUI 则把同样的操作做成点点就能完成。想再往深处看先翻 BYTECODE_HISTORY.md 里的版本对照表再去 bytecode/ 目录读一遍反编译实现。【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考