Godot 逆向工程工具下载及安装教程

1. 项目介绍

Godot 逆向工程工具（Godot RE Tools）是一个专为 Godot 引擎设计的逆向工程工具集。该工具能够从 APK、PCK 或嵌入式 EXE 文件中完整恢复 Godot 项目资源，包括 GDScript 脚本的反编译、资源文本与二进制格式的批量转换等核心功能。

该工具支持 Godot 4.x、3.x 和 2.x 版本的项目，为开发者提供了从已发布的游戏或项目中恢复原始项目文件的强大能力。完整项目恢复功能包括：

• 从 APK、PCK 或嵌入式 EXE 文件加载项目资源
• 反编译所有 GDScript 脚本
• 恢复原始项目文件
• 将导入的资源转换回原始导入格式
• 将自动转换的二进制资源转换回原始文本格式
• 重新创建插件配置文件

2. 项目下载位置

要获取 Godot 逆向工程工具，请使用以下 git 命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/gd/gdsdecomp.git

此命令会将项目完整克隆到您的本地机器，包含所有必要的源代码和资源文件。

3. 项目安装环境配置

在安装 Godot 逆向工程工具之前，需要确保开发环境已正确配置。以下是必需的软件和工具：

必备组件：

• Godot 引擎：推荐使用 Godot 4.0 或更高版本
• 编译工具：需要安装 scons 用于编译 Godot 引擎
• Rust 工具链：需要安装 rustup
• .NET 9 SDK：需要安装 dotnet 9 开发工具包

环境配置步骤：

1. 安装 Godot 引擎源代码：

   • 从 Godot 官方网站下载 Godot 4.0 或更高版本的源代码
   • 解压到您的工作目录

2. 安装编译工具 scons：

   sudo apt-get install scons
   

3. 安装 Rust 工具链：

   • 访问 https://rustup.rs 安装 rustup

4. 安装 .NET 9 SDK：

   • 从微软官网下载并安装 .NET 9 SDK

4. 项目安装方式

从源代码编译安装：

1. 将克隆的 gdsdecomp 项目复制到 Godot 引擎的 modules 子文件夹中：

   cp -r gdsdecomp /path/to/godot/modules/
   

2. 重新编译 Godot 引擎以包含该模块：

   cd /path/to/godot
   scons platform=linuxbsd target=template_debug
   

3. 构建完成后，Godot 引擎将包含逆向工程工具模块

使用预编译版本： 项目也提供预编译的发布版本，可以从项目的发布页面获取最新的稳定版本。

5. 项目使用指南

图形界面使用

通过图形界面进行完整项目恢复：

• 从 "RE Tools" 菜单中选择 "Recover project..."
• 或者直接将 PCK/EXE 文件拖放到应用程序窗口

命令行使用

基本命令格式：

gdre_tools --headless <主命令> [选项]

主要命令功能：

• --recover：对指定的 PCK、APK、EXE 或提取的项目目录执行完整项目恢复
• --extract：提取指定的 PCK、APK 或 EXE 文件
• --compile：将 GDScript 文件编译为字节码
• --decompile：将 GDC 文件反编译为文本
• --pck-create：从指定目录创建 PCK 文件

使用示例：

bin/godot.linuxbsd.template_debug.x86_64.llvm --headless --path=modules/gdsdecomp/standalone --recover=game.pck

文件过滤规则

项目支持使用 glob 模式进行文件过滤：

• 使用 ** 表示递归模式匹配
• 路径应相对于 res:// 或 user://
• 支持包含和排除过滤器组合使用

6. 项目处理脚本

Godot 逆向工程工具包含多个处理脚本，用于执行不同的任务：

核心脚本：

• gdre_tools：主工具程序，执行项目恢复、资源提取和 GDScript 编译等操作
• bytecode_generator.py：GDScript 字节码生成器
• config.py：工具运行参数配置

辅助脚本：

• 位于 helpers 目录下的多个检测脚本，用于识别不同 Godot 版本的特性支持

7. 技术限制

目前尚未支持转换以下资源类型：

• 2.x 版本的模型文件（dae、fbx、glb 等）
• GDNative 或 GDExtension 脚本

8. 字节码版本支持

工具支持从 Godot 1.0 到 4.5 的多个字节码版本，每个版本都有特定的功能变化和改进。详细的字节码历史记录可以参考项目中的 BYTECODE_HISTORY.md 文件。

9. 开发说明

对于开发者，项目提供了完整的开发环境配置：

• 包含 VSCode 的启动、构建和设置模板
• 需要先构建编辑器版本，并在 standalone 目录中启动编辑器至少一次以确保资源正确导入

通过本教程，您应该能够成功下载、安装并使用 Godot 逆向工程工具来恢复和处理 Godot 项目资源。该工具为 Godot 开发者提供了强大的逆向工程能力，有助于从已发布的项目中学习和恢复原始资源。