如何高效恢复Godot项目：逆向工程工具GDSDecomp完全指南 🚀

Godot引擎作为一款开源游戏开发工具，深受开发者喜爱。但当你意外丢失项目源码或需要分析基于Godot的游戏时，GDSDecomp（Godot逆向工程工具） 就能成为你的救星！这款强大的开源工具支持Godot 4.x、3.x及2.x版本，提供项目恢复、PCK解包、GDScript批量反编译等核心功能，让你轻松应对各种项目修复需求。

📌 为什么选择GDSDecomp？核心功能一览

GDSDecomp并非普通的文件提取器，而是一套完整的Godot项目逆向解决方案。它能深度解析APK、PCK或EXE文件，还原项目的每一个细节：

• 全项目恢复：从资源文件到脚本代码，一键重建完整项目结构
• PCK全能处理：支持PCK文件的提取、创建与加密解密
• GDScript批量反编译：将二进制GDC文件转换为可读的GDScript代码
• 资源格式转换：实现文本与二进制资源的双向批量转换

GDSDecomp直观的图形界面，让项目恢复操作变得简单高效

📥 零基础安装指南：3种方式任选

1️⃣ 二进制快速安装（推荐新手）

访问项目Release页面获取最新预编译版本，解压即可使用，无需复杂配置。

2️⃣ Scoop包管理器（Windows用户）

打开命令提示符，输入以下命令一键安装：

scoop bucket add games
scoop install gdsdecomp

3️⃣ 从源代码编译（高级用户）

1. 将仓库克隆到Godot引擎的modules目录下，命名为gdsdecomp
2. 安装依赖：rustup 和 dotnet 9 sdk
3. 按照Godot官方编译指南编译引擎

🚀 实战教程：3步完成项目恢复

图形界面操作（适合新手）

1. 启动集成GDSDecomp的Godot引擎
2. 从菜单选择 "RE Tools" → "恢复项目..."
3. 遇到加密项目时，先通过 "设置加密密钥..." 输入64位十六进制密钥
4. 选择目标文件（APK/PCK/EXE），设置输出目录，点击**"全量恢复"**

GDSDecomp项目恢复对话框，支持加密文件解密与自定义输出设置

命令行高效操作（适合批量处理）

对于高级用户，命令行模式能实现自动化处理：

gdre_tools --headless --recover=path/to/game.pck --output=recovered_project --key=000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F

常用参数说明：

• --recover：指定要恢复的文件路径
• --output：设置输出目录（默认自动生成）
• --key：加密项目的解密密钥（64位十六进制字符串）
• --scripts-only：仅提取并恢复脚本文件

⚠️ 注意事项与常见问题

系统要求

• 推荐使用Godot 4.0开发分支（@daeb1c7292cbb426fd45c5ca98b1c7da40b390ba版本）
• 编辑恢复项目时，建议使用与原始游戏相同版本的Godot工具

当前限制

• 不支持GDNative、GDExtension或GDMono脚本的反编译
• 部分资源类型（如2.x版本的dae/fbx/glb模型）转换尚未实现

GDSDecomp详细的恢复日志，帮助追踪处理过程与排查问题

🛠️ 高级功能：自定义与扩展

自定义字节码版本

通过--force-bytecode-version参数指定特定的字节码版本，支持提交哈希或版本字符串：

gdre_tools --headless --decompile=main.gdc --bytecode=4.3.0

PCK文件创建与补丁

使用--pck-create创建新的PCK文件，或通过--pck-patch为现有PCK打补丁：

gdre_tools --headless --pck-create=./project --output=game.pck --pck-version=2 --pck-engine-version=4.3.0

📚 资源与支持

• 官方文档：项目内置详细使用说明
• 源码地址：https://gitcode.com/gh_mirrors/gd/gdsdecomp
• 问题反馈：提交issue至项目仓库

无论你是需要恢复丢失的项目源码，还是想深入学习Godot引擎的资源结构，GDSDecomp都能为你提供强大支持。这款开源工具正在不断迭代完善，赶快来体验它的强大功能吧！