从零恢复一个完整 Godot 项目GDRE Tools 的 PCK 恢复与 GDScript 反编译实战【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp你手里有一个 .pck、一个安卓 APK、一个内嵌 PCK 的 exe而原始脚本找不到了。GDRE Tools 就是为这种场景准备的 Godot 逆向与项目恢复工具把字节码反编译回 .gd还原完整项目结构还能改完重新打包。本文按任务顺序带你从编译模块走到进阶操作。先看清工具的边界上手之前先确认它的能力边界知道不能做什么能省更多时间。它负责归档到可编辑项目的整条链路解包、反编译、还原导入格式、重建项目文件。但链路上有几个断点维度能做还不能做输入归档PCK、APK、内嵌 PCK 的 EXE、已解包的项目目录非 PCK 的私有打包格式脚本还原批量把 .gdc 反编译为 .gd也支持 .gd 反向编译成 .gdcGDNative / GDExtension 脚本引擎版本2.x / 3.x / 4.x 项目反编译4.x 是主维护线3.x 引擎的构建支持已移除3.x 项目仍可反编译还有一个隐性断点2.x 的模型格式dae、fbx、glb 等没有转换支持恢复后对应场景可能要手动处理。动手前把 Godot 模块编译出来边界清楚了先干最基础的一件事把这个模块编译进 Godot 引擎。前置条件是一份能编译的 Godot 4.x 引擎源码、Rust 工具链rustup、.NET SDK仅 C# 项目需要。把仓库放进引擎的 modules 目录然后编出一个编辑器cd godot/modules git clone https://gitcode.com/GitHub_Trending/gd/gdsdecomp gdsdecomp cd .. scons platformlinuxbsd targettemplate_debug编译完成后确认装好的办法有两个启动编辑器看顶部菜单栏是否出现 RE Tools或者在无界面环境跑这条版本探测命令能打印工具版本即通过bin/godot.linuxbsd.template_debug.x86_64.llvm --headless --pathmodules/gdsdecomp/standalone --gdre-version第一次完整恢复图形界面路线有了带模块的 Godot第一次别急着上命令行先在界面里走一遍完整恢复把流程跑熟。进入恢复入口启动编辑器在顶部 RE Tools 菜单里选 Recover project...。这个入口会启动完整流程资源解包、脚本反编译、导入格式还原、项目文件重建一次做完所以只需要选一次文件。文件对话框会自动识别 .pck、.apk、.exe 三类目标选中后点 Open 即可。还有个更省事的捷径直接把文件拖进编辑器窗口整个菜单都省了。密钥格式与为什么必须是 64 位如果原始项目加密了恢复对话框会要求输入密钥。它的格式是 64 个字符的十六进制串对应 32 字节密钥例如000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F。位数不对、混入非十六进制字符都会导致所有文件解密失败——这是恢复失败最常见的原因粘贴前请数一遍。读恢复报告恢复完成后会弹出报告窗口给出日志文件路径和各项统计。报告有两处值得看开头 Use Godot editor version X 一行提示你用哪个版本的编辑器打开项目版本不对会产生大量误报其次是脚本反编译的成功/失败计数。如果日志里出现大量 non-import 错误多半是项目用了定制引擎版本报告会建议你改用原游戏二进制作为导出模板再跑一次。什么时候该切到命令行恢复成功、项目能打开之后你多半会接着问PCK 有好多个怎么办判断标准很简单——只恢复一两个项目时 GUI 足够需要批量处理、写进脚本或 CI、或者机器没有图形界面就切到命令行。基本结构是gdre_tools --headless 主命令 [选项]下面三条高频组合覆盖多数场景gdre_tools --headless --recovergame.pck --outputrecovered gdre_tools --headless --recovergame.pck --scripts-only gdre_tools --headless --decompile*.gdc --bytecode4.3.0第一条是带输出目录的完整恢复第二条只提取并反编译脚本速度最快第三条针对散落的 .gdc 文件直接反编译注意--bytecode版本必须与原游戏匹配。界面里也有对应窗口可以左右对照查看还原出来的源码常用参数整理成表不用死记参数作用--keyhex加密项目的解密密钥64 位十六进制--outputDIR输出目录默认NAME_extracted--scripts-only只处理脚本跳过其他资源--include/--excludeGLOBglob 过滤文件支持res://**/*.gdc递归匹配--force-bytecode-versionver手动指定字节码版本版本号或 commit hash--ignore-checksum-errorsMD5 不匹配时不视为失败踩坑对照现象 → 原因 → 处理批量跑之前把最常踩的三个坑先过一遍按现象分组看到症状就找对应解法。版本不匹配导致恢复失败的解法反编译结果乱码或直接报错多半是反编译定义版本与原游戏引擎版本对不上。用--force-bytecode-version指定版本号或 commit hash并对照恢复日志里检测到的版本核对。加密密钥导致恢复失败的解法加密项目恢复失败、文件全是 0 字节或报 MD5 错误通常是密钥格式不对必须 64 位十六进制或游戏对密钥做了二次变换。先核对密钥本身确认游戏确实使用非标准加密方案后再参考仓库里的自定义解密器文档编写定制解密脚本。资源导入失败的处理恢复后部分资源仍是二进制或导入报错2.x 模型格式和 GDNative/GDExtension 脚本没有转换支持报告会列出未转换文件清单手动处理或暂时忽略同时检查磁盘剩余空间和文件权限。进阶玩法PCK 创建、修补与特殊参数恢复跑通之后反方向的操作也有用武之地不只是解包还能创建和修改 PCK。自定义字节码定义项目用的是非官方 Godot 构建、内置字节码定义对不上时先用--dump-bytecode-versionsDIR把所有定义导出为 JSON改好存成自定义文件再在恢复时加载它gdre_tools --headless --load-custom-bytecodecustom.json --recovergame.pck翻译文件修补多语言项目想补一门新语言时把 CSV 文件映射到项目内的源路径即可格式是CSV文件源路径gdre_tools --headless --patch-translations/path/translation.csvres://translations/translation.csvPCK 创建与修补要自己打一个 PCK或替换现有 PCK 里的单个脚本用这两条gdre_tools --headless --pck-create./myproj --pck-version2 --pck-engine-version4.3.0 --outputout.pck gdre_tools --headless --pck-patchgame.pck --patch-filenew.gdres://main.gd如果要把结果嵌回可执行文件加--embedEXE想同时加密这两条命令都能再挂--key。全部跑完后别忘了验证用日志建议的编辑器版本打开恢复出的项目确认目录结构、场景引用完整把主场景跑一遍。若日志提示大量 non-import 错误就换原游戏二进制作为导出模板再恢复一次。到这里项目能正常编辑运行这次 Godot 逆向工作才算真正落地。【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考