Godot RE Tools 完整指南:Godot反编译与项目恢复
【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp
Godot RE Tools 是一款 Godot 逆向工程工具,围绕 Godot反编译、APK提取Godot资源与完整项目恢复三大能力设计:它能把发布后的 APK、PCK 或内嵌 EXE 还原成可再次编辑的 Godot 项目。它解决的核心问题是——你手上只有成品包,却想拿回工程源码和资源。
为什么需要它
做 Godot 项目维护时,最常见的三种处境:
- 老项目源码丢失,仓库里只剩当年打出的发布包;
- 想研究某款 Godot 游戏的实现,却拿不到工程文件;
- 要改文本、换本地化资源或修复场景,面对的却是一堆二进制文件。
如果你是开发者、逆向工程爱好者,或参与游戏保存工作,这个工具就是为此准备的。它对 Godot 4.x、3.x、2.x 三代项目都保留了处理能力。
🧰 它到底能做什么
功能按可感知的能力分成四类,每类对应一类实际场景:
- 完整项目恢复:从 APK、PCK 或 EXE 加载资源,反编译全部 GDScript,还原原始工程文件,把导入资源转回原始导入格式,把自动转换成的二进制资源还原为文本,并重建插件配置——适合把发布包整体变回可编辑项目。
- GDScript反编译:
--decompile支持通配符批量处理.gdc字节码——适合只关心脚本逻辑的场景。 - PCK 归档工具:
--extract解包、--list-files列文件、--pck-create从目录新建 PCK——适合单独处理归档。 - 资源格式转换:
--txt-to-bin与--bin-to-txt在文本与二进制场景/资源文件间批量互转——适合改完文本后重新打包。
🚀 上手:从安装到第一次恢复
安装
从项目发布页面下载对应平台的最新版即可;Windows 用户也可以走 Scoop:
scoop bucket add games scoop install gdsdecompGUI 恢复步骤
- 打开应用,在
RE Tools菜单选择Recover project...,或直接把 PCK/EXE 拖到应用窗口上; - 在文件对话框中选择
.pck、.apk或.exe文件:
- 在 PCK explorer 中确认文件列表,勾选
Full Recovery(只做提取则选Extract only),设置目标目录后点击Extract...:
命令行恢复示例
无头模式下,一条命令即可完成全量恢复,这也是 Godot反编译最省事的入口:
gdre_tools --headless --recover=game.pck --output=recovered_project完整用法形如gdre_tools --headless <main_command> [options],常用命令还包括--extract、--decompile、--pck-patch等,配合--include/--exclude通配符可以只处理部分文件。
⚙️ 进阶能力
多版本字节码兼容
工具会自动检测项目的 Godot 版本并匹配对应的字节码定义;检测不准时,用--force-bytecode-version手动指定 commit hash(如f3f05dc)或版本号(如4.3.0),也可以用--list-bytecode-versions查看全部可用版本。多版本兼容让 Godot反编译的覆盖面从 2.x 一直延伸到 4.x。
加密项目与 C# 项目
- 加密的 PCK 通过
--key传入 64 位十六进制字符串即可解密恢复;自定义解密方案的说明见 docs/custom_decryptors.md - C# 项目可加
--csharp-assembly指向程序集文件,未指定时会自动从 PCK 路径推断
📌 实用建议与避坑
- 版本匹配:Godot反编译结果能否直接编辑,关键在版本匹配。用与原游戏编译时相同版本的 Godot 编辑器打开项目,恢复日志会明确写出检测到的版本,照着选即可:
- 自定义版本提示:项目若使用了 Godot 自定义版本,打开后脚本或着色器可能出现大量非导入错误,此时按日志提示改用原游戏二进制作为导出模板
- 已知限制:2.x 的模型文件(
dae、fbx、glb等)与 GDNative/GDExtension 脚本暂不支持转换 - 反馈问题:提交报告时附上日志中提示的
gdre_export.log,方便定位
Godot RE Tools 适合三类人:想找回丢失工程资源的开发者、研究现有 Godot 游戏实现的逆向爱好者,以及需要维护老项目的团队。把发布包拖进窗口、确认恢复日志、再用对应版本的编辑器打开——一个可编辑的 Godot 项目就回来了。
【免费下载链接】gdsdecompGodot reverse engineering tools项目地址: https://gitcode.com/GitHub_Trending/gd/gdsdecomp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考