Godot 反编译指南：从 APK、PCK、EXE 完整恢复你的 Godot 项目
项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp 拆了一个 APK，得到的却只是 PCK 包和一堆 .gdc 字节码文件——脚本看不见，资源动不了。Godot RE Tools（gdsdecomp）就是为这个场景准备的 Godot 反编译与项目恢复工具，它能从 APK、PCK 或内嵌 EXE 文件里，完整还原出一个包括反编译脚本、原始资源和目录结构在内的 Godot 项目。
它是什么、覆盖哪些版本
Godot RE Tools 是一套 Godot 逆向工程工具集，覆盖 Godot 4.x、3.x、2.x 三个大版本，可处理三类输入：手机 APK 包、PCK 资源包、以及内嵌了 PCK 的 EXE 可执行文件。理解它的定位可以做个简单对比：普通的"提取"工具只是从包里倒出一堆文件，而它做的事情更接近把整本教材拆开、重新摊在桌上——拿回的是一个可以直接在 Godot 编辑器里打开、运行、继续编辑的工程，而不是一目录散落的素材。
📦 安装与首次恢复：三步完成
最简上手路径是从项目 Release 页下载对应平台的版本；Windows 用户也可以直接用 Scoop 安装：
scoop bucket add games
scoop install gdsdecomp
首次通过界面做完整恢复，只需要三步：
- 打开 Godot RE Tools 程序；
- 在 RE Tools 菜单中选择 "Recover project..."，选中要恢复的 PCK、APK 或 EXE，勾选 Full Recovery 并指定输出目录；
- 等待恢复结束，查看弹出的恢复报告。
嫌菜单麻烦的话，把 PCK/EXE 文件直接拖进程序窗口也能开始。
🧩 工具的三个核心能力
全项目恢复：拿回一个能继续编辑的工程
单看 GDScript 反编译，只是把 .gdc 字节码变回 .gd 源码，这只是其中一步。全项目恢复会反编译全部 GDScript、把导入过的资源转回原始导入格式、将自动二进制化的资源还原成文本，并重建插件配置文件与整体目录结构。它解决的是"把游戏拿回成一个可编辑的 Godot 工程"这个完整问题。
GDScript 跨版本反编译：4.x、3.x、2.x 自动识别
GDScript 字节码的格式随引擎版本不断演化，4.x、3.x、2.x 各自使用的反编译规则并不相同。工具会自动检测目标项目的字节码版本，并套用对应规则，不需要你手动判断游戏是用哪个版本编译的；万一检测偏差，也可以在命令行强制指定字节码版本。
资源格式转换：把二进制资源还原成文本
Godot 会把 .tscn、.tres 这类文本格式资源在导入时自动转成二进制，项目包里看到的往往是不可读的二进制内容。工具可以把这些资源批量转回可读文本，适合需要通读场景结构或调整个别资源参数的场合。
真实使用场景：修复、学习、迁移
最常见的场景是游戏文件损坏后的修复与魔改：对幸存的 PCK 或 EXE 做一次完整恢复，就能拿到可编辑的工程，修补损坏的资源，或者修改数值、行为。另一个用途是学习——把一个现成项目完整恢复后，看它如何组织资源、编写脚本、配置插件，比只看教程更直观地理解 Godot 的工程实践。第三类是迁移：老版本工程在新编辑器里打不开或报错时，先经工具完整恢复，再在新版引擎中继续开发，或重新打包到其他平台。
进阶用法：无界面模式、加密项目与版本建议
脚本化和批处理场景下，工具提供无界面的 CLI 模式：
gdre_tools --headless --recover=game.pck --output=recovered_project
如果项目本身是加密的，需要通过 --key 传入 64 位十六进制密钥来解密；遇到非标准加密方案时，也可以加载自定义解密器处理。还有一个容易忽略的细节：恢复报告会明确写出检测到的引擎版本，例如提示用 3.4 版编辑器打开工程。建议就用日志中标出的同一版本 Godot 打开恢复后的项目，后续编辑时能避免资源重新导入带来的各种差异。
恢复报告也便于在遇到问题时核对版本或反馈缺陷。对游戏保存、研究现有项目、二次开发来说，它把"一个 APK"到"一个可编辑的 Godot 工程"这条路走通了，而这往往是逆向过程中最有价值的一步。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
