Godot逆向工程实战三步把编译后的PCK包还原成可编辑的完整项目【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecompGDRE Tools仓库名 gdsdecomp是一款开源的 Godot 逆向工程工具主打 GDScript 反编译与 PCK 文件提取能把发行包还原成可编辑项目。这篇文章从新手视角出发带你理解它怎么工作、怎么上手以及最容易在哪一步踩坑。凌晨两点小林手里只剩一个 .pck 文件小林的独立游戏上线三个月口碑不错。然后他的笔记本报废了——硬盘彻底不读盘而源码只存在本机从未同步到云端。他手里还剩什么一个给玩家下载的 Windows 导出包里面只有 game.exe 和一个 game.pck。pck 是 Godot 打包项目资源后的容器文件里面的 GDScript 源码已被编译成 .gdc 字节码——一堆只有引擎能读懂的机器指令人眼根本看不下去。场景、贴图、音频也大多变成了二进制格式。对着这份天书小林差点放弃。但后来他靠一个开源工具把整个项目救了回来反编译出全部脚本、还原了场景文件、找回了原始贴图甚至重建了 project.godot。这个工具就是 GDRE Tools它做的事专业说法叫Godot 逆向工程。一句话定位它是把压缩饼干泡回面团的热水如果把发行包比作一块烤好的压缩饼干——原料被压紧、脱水、定型营养还在却不再是原来的形状——那么 GDRE Tools 就是那杯热水。它不会凭空给你一份新源码而是通过逆向分析尽可能把你压进去的东西恢复原状字节码还原成 GDScript、二进制场景还原成文本 .tscn、压缩贴图还原成 PNG。压缩饼干泡开不可能 100% 复原但这个工具的还原度已经足够支撑你继续开发。一句话记住它GDRE Tools 是给 Godot 开发者准备的项目还原器——丢源码、想学习、做审计它都能把编译产物泡回可读的工程文件。上手路径从下载到第一次成功恢复第一步拿到工具Windows 用户最快的安装方式是 Scoop两步搞定scoop bucket add games scoop install gdsdecomp执行完gdre_tools命令就装好了。不想用包管理器也可以直接去项目 release 页面下载现成版本想从源码构建见文末。第二步第一次 GUI 体验启动后是名为 PCK explorer 的主界面。把 .pck 或 .exe 文件直接拖进窗口工具会立刻解析出包内所有文件右侧还能预览脚本的字节码信息。第三步跑通第一条命令觉得命令行更顺手一条命令就能完成整个项目恢复gdre_tools --headless --recovergame.pck --outputrecovered_project它做的事读取 game.pck → 反编译所有 .gdc 脚本 → 还原场景与资源 → 重建 project.godot → 输出到 recovered_project 目录。跑完你甚至可以直接用 Godot 打开这个目录继续开发。任务驱动式能力地图遇到什么任务用什么命令按你想做的事来认识这个工具比按功能清单记它高效得多。先把六类高频任务速查表放在这里你想做的事核心命令参数效果整体还原项目--recovergame.pck脚本资源工程文件全恢复只要脚本源码--recovergame.pck --scripts-only只反编译脚本选择性提取资源--recovergame.pck --include...按规则挑着提取解包看内容--extractgame.pck仅解压不恢复解密加密包--recoverxx.pck --key64位hex解密后恢复目录反向打包--pck-createdir --pck-version2生成新 PCK下面逐一展开。任务一项目源码全部丢失想把整个游戏还原gdre_tools --headless --recovermy_game.pck --outputrecovered完整恢复会自动处理脚本反编译、二进制资源转文本、import 文件重建和插件配置。恢复时你可以选择模式比如只解压或完整恢复并指定目标目录。恢复完成后目录里会生成一份 gdre_export.log。它会告诉你检测到的 Godot 引擎版本、成功反编译的脚本数、失败数——恢复后第一件事就是读它。任务二只想学习脚本逻辑资源一概不要比如你研究某个游戏的实现方式不需要贴图和音频加一个参数就行gdre_tools --headless --recovergame.pck --scripts-only想单独反编译某个 .gdc 文件用--decompile还支持通配符批量处理gdre_tools --headless --decompileres://scripts/*.gdc --output./decompiled任务三只挑一部分资源跳过占空间的大文件用 include/exclude 做选择性提取比如只要脚本、排除贴图gdre_tools --headless --recovergame.pck \ --includeres://scripts/**/*.gd \ --excluderes://assets/textures/*.png注意glob 建议以res://开头**表示递归匹配任意层级。任务四游戏加密了只有密钥才能解开Godot 的 PCK 支持 AES-256-CFB 加密。只要你有 64 位十六进制密钥照常恢复gdre_tools --headless --recoverencrypted.pck \ --key000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F任务五反向操作——把项目目录打成 PCK 包恢复是拆创建是装。把项目目录重新打成发行格式同样支持还能顺便内嵌进 exe、加上加密gdre_tools --headless --pck-createproject_dir \ --pck-version2 --pck-engine-version4.3.0 --outputnew_game.pck做补丁、做汉化、给老游戏重新打包都靠它。深度一瞥它凭什么兼容从 2.x 到 4.x 的几十个版本你可能会好奇Godot 从 2.x 到 4.x字节码格式变化那么大GDRE Tools 为什么几乎全兼容答案藏在项目根目录的misc/bytecode_versions.json里——这份文件有上万行记录着 Godot 每个发行版本对应的字节码定义。每个版本一把专属的钥匙GDScript 源码编译时会被切成一串 token语言标记再编码进字节码。麻烦的是不同版本的 token 编号、函数签名、字节码头部结构都可能变化。GDRE Tools 的做法朴素但有效为每个版本单独维护一套 token 表和解码规则。在仓库bytecode/目录下每个版本对应一个解析器类如GDScriptDecomp_ebc36a7、GDScriptDecomp_f3f05dc全部继承自bytecode/bytecode_base.h中统一的GDScriptDecomp基类。多层版本检测猜不中就逐级回退面对一个陌生的 .gdc工具按这个顺序判断版本看文件头魔数判断是否为 PCK/EXE 格式解析字节码头提取版本标识与 token 表与已知版本比对精确匹配失败时回退到该版本的父版本解析器每个版本在 JSON 里都有 parent 字段仍不满足时你还能用--force-bytecode-version4.3.0手动指定这套版本族谱 逐级回退机制就是它能覆盖 Godot 2.x/3.x/4.x 全系列的根本原因。想深入研究从misc/bytecode_versions.json和bytecode/bytecode_base.h两个文件开始看最合适。避坑手册新手最常问的六个问题Q1反编译出来的脚本能直接用吗逻辑结构基本完整但变量名和局部变量类型可能被编译器优化或丢失。绝大多数场景下可以直接打开继续开发复杂脚本可能需要手动微调。Q2恢复的项目该用哪个 Godot 版本打开看 gdre_export.log里面明确写了检测到的引擎版本。用同版本 Godot 打开兼容性最好。Q3加密包一直解密失败怎么办八成是密钥不对。检查 64 位十六进制密钥是否完整、大小写是否一致。另外有些游戏会对密钥做二次变换密钥提取工具给出的值不一定直接用得上。Q4include/exclude 的 glob 怎么写才对以res://或user://开头**递归匹配。单独写*.gdc会被自动当成res://**/*.gdc。Q5为什么有些文件恢复不了Godot 2.x 的模型格式dae/fbx/glb 等以及 GDNative/GDExtension 脚本目前尚不支持转换这是工具已知的边界。Q6从源码编译时总报错是我的问题吗大概率不是。GDRE Tools 需要作为模块放进 Godot 源码的modules目录后一起重新编译同时要装好 Rust 工具链和 .NET SDK。单独编译它自己是编不出来的。进阶玩法当普通恢复已经满足不了你给非标准加密的游戏写自定义解密器如果某款游戏用了魔改的加密方案工具允许你写一个 GDScript 解密脚本继承CustomDecryptor类实现_parse_and_decrypt()方法然后挂载gdre_tools --headless --recovercustom_encrypted.pck \ --custom-decryption-scriptmy_decryptor.gd仓库docs/custom_decryptors.md里有完整指南还附带了实现标准加密方案的参考脚本docs/gdre_standard_encryption.gd照着改就行。注意解密脚本里不要内置密钥涉及法律风险。导出并修改字节码定义适配魔改引擎遇到改过内部的引擎可以先把内置定义全部导出成 JSONgdre_tools --headless --dump-bytecode-versions./bytecode_defs调整后再用--load-custom-bytecode./custom_bytecode.json加载相当于给工具配一把自定义钥匙。批量恢复一整个目录的游戏手里十几个 pck 要处理循环一键跑完for pck in *.pck; do gdre_tools --headless --recover$pck --outputrecovered_${pck%.pck} done最后源码会丢但工具不会跑回到小林的故事他最终从那个唯一的发行包里拿回了几乎全部源码、场景和素材游戏得以继续更新维护。GDRE Tools 的真正价值不在于破解而在于给开发者留了一条退路无论源码是意外丢失还是你想从成品中学习实现思路它都能把编译产物泡回可以读、可以改、可以继续开发的形态。如果你正握着一个 .pck 无从下手现在就可以动手# 从源码构建的话先克隆到 Godot 的 modules/gdsdecomp 目录 git clone https://gitcode.com/GitHub_Trending/gd/gdsdecomp # 或者直接开始恢复 gdre_tools --headless --recoveryour_game.pck --outputrecovered_projectHappy reversing祝你顺利找回自己的项目。【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考