Godot RE 工具箱：项目恢复与资源解包完全指南

Godot RE 工具箱：项目恢复与资源解包完全指南

gdsdecomp Godot reverse engineering tools 项目地址: https://gitcode.com/gh_mirrors/gd/gdsdecomp

概览

上帝之手：逆向工程工具（Godot RE Tools）正处于测试阶段，专为Godot引擎的项目逆向工程设计。该工具集包括全面的项目还原、PCK归档的提取与创建、GDScript脚本批量反编译以及资源的文本与二进制格式转换功能。支持Godot 4.x、3.x及2.x版本的项目处理。

最新版本获取

安装指南

系统要求

确保您的开发环境满足以下条件：

• Godot 4.0 开发分支（推荐使用@daeb1c7292cbb426fd45c5ca98b1c7da40b390ba版本）
• 对于3.x版本的Godot的支持已终止，但此工具仍可处理这些项目的数据。
• 推荐用于编辑恢复项目的是与原始游戏编译相同的Godot工具版本。

获取并安装

1. 二进制发布: 访问项目页面的Release部分，下载最新的预编译版本进行快速使用。

2. 从源代码编译:

   • 将此仓库克隆到Godot引擎的modules目录下，命名为gdsdecomp。
   • 根据Godot官方编译指南编译Godot引擎。
   • 为了便捷开发，项目提供了VSCode的配置文件模板，在设置好Godot的构建环境后，将.vscode目录下的模板文件去除.template扩展名，并在Godot根目录启动VSCode。

使用说明

图形界面(GUI)

1. 启动集成Godot RE Tools的Godot引擎。
2. 从菜单选择“RE Tools” -> “恢复项目…”以开始项目还原过程。
3. 遇到加密项目时，先通过“设置加密密钥…”输入相应密钥。
4. 浏览并选择你的APK、PCK或嵌入式EXE文件。
5. 在弹出的对话框中，决定是否进行“全量恢复”或仅“提取”，指定目标目录。

命令行使用

对于批处理或者自动化流程，使用命令行模式更为高效：

gdre_tools --headless --recover=path/to/your/game.pck

主要参数包括：

• --recover=<路径>: 对指定的PCK/EXE/APK执行完整项目恢复。
• --extract=<路径>: 只提取资源而不进行转换。

可选参数允许自定义输出目录、加密密钥等。

API使用文档

当前提供的工具主要为功能驱动而非API形式，但在自定义工作流或脚本自动化时，通过调用命令行工具可视为间接使用其API接口。例如，利用shell脚本调用gdre_tools进行批量处理任务。

项目限制

• 不支持GDNative、GDExtension或GDMono脚本的反编译；这类文件需依赖如ILSpy或dotPeek等其他工具。
• 某些特定类型资源的转换可能不完整，如特定字体和模型格式。

---

以上为Godot RE Tools的基本使用指南，无论是专业开发者还是游戏修改爱好者，都能利用这个强大的工具来分析、备份或理解基于Godot的游戏项目结构。使用过程中遇到任何问题，请记得提交至项目的GitHub页面。祝您探索愉快！

gdsdecomp Godot reverse engineering tools 项目地址: https://gitcode.com/gh_mirrors/gd/gdsdecomp