Godot 反向工程工具常见问题解决方案

项目基础介绍

Godot 反向工程工具（Godot RE Tools）是一个用于 Godot 引擎的反向工程工具集。该项目的主要功能包括：

• 全项目恢复：从 APK、PCK 或嵌入的 EXE 文件中加载项目资源，并恢复原始项目文件。
• PCK 归档提取/创建：提取或创建 PCK 归档文件。
• GDScript 批量反编译：批量反编译 GDScript 脚本。
• 资源文本与二进制批量转换：批量转换资源文件的文本与二进制格式。

该项目支持 Godot 4.x、3.x 和 2.x 版本的项目，主要使用 Python 和 C++ 进行开发。

新手使用注意事项及解决方案

1. 项目依赖安装问题

问题描述：新手在首次使用该项目时，可能会遇到依赖库未安装或版本不匹配的问题，导致工具无法正常运行。

解决方案：

1. 检查依赖库：首先，确保你已经安装了所有必要的依赖库。可以通过查看项目根目录下的 requirements.txt 文件来确认所需的 Python 依赖库。
2. 使用虚拟环境：建议在虚拟环境中安装依赖库，以避免与其他项目的依赖冲突。可以使用 virtualenv 或 conda 创建虚拟环境。
3. 安装依赖：在虚拟环境中运行以下命令安装依赖库：

   pip install -r requirements.txt
   

2. 项目恢复失败

问题描述：在进行全项目恢复时，可能会遇到项目恢复失败的情况，通常是由于资源文件损坏或加密导致的。

解决方案：

1. 检查文件完整性：确保你使用的 APK、PCK 或 EXE 文件没有损坏。可以使用文件校验工具（如 md5sum）检查文件的完整性。
2. 解密资源文件：如果项目资源文件是加密的，需要提供正确的解密密钥。在命令行中使用 --key 参数指定解密密钥，例如：

   gdre_tools --recover=game.pck --key=000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F
   

3. 忽略校验错误：如果资源文件的校验错误不影响恢复结果，可以使用 --ignore-checksum-errors 参数忽略校验错误：

   gdre_tools --recover=game.pck --ignore-checksum-errors
   

3. GDScript 反编译失败

问题描述：在进行 GDScript 反编译时，可能会遇到反编译失败的情况，通常是由于脚本版本不兼容或脚本内容异常导致的。

解决方案：

1. 检查脚本版本：确保你使用的 Godot 版本与反编译工具支持的版本一致。可以通过 --list-bytecode-versions 命令查看支持的脚本版本：

   gdre_tools --list-bytecode-versions
   

2. 手动指定版本：如果反编译工具无法自动识别脚本版本，可以手动指定版本进行反编译。例如：

   gdre_tools --compile=script.gd --bytecode=4.0
   

3. 检查脚本内容：确保脚本内容没有异常或损坏。可以使用文本编辑器打开脚本文件，检查是否有乱码或其他异常情况。

通过以上步骤，新手可以更好地理解和使用 Godot 反向工程工具，解决常见的问题。