GH-Offset-Dumper 开源项目最佳实践教程

1. 项目介绍

GH-Offset-Dumper 是一个现代化的签名扫描器，适用于任何游戏。该工具可以快速为磁盘上的游戏或运行时的游戏生成完整的偏移头文件，而不需要修改任何代码。用户可以为每个游戏和项目创建独立的 JSON 配置文件，实现拖放式操作。

该项目的主要特点包括：

• 支持生成内存分析表、ReClass.NET 项目以及单一代码偏移头文件。
• 可移植，适用于任何项目，CLI 应用程序仅需一行代码。
• 支持从磁盘文件中提取偏移量。

2. 项目快速启动

以下步骤将帮助你快速启动并使用 GH-Offset-Dumper。

首先，确保你已经安装了 C++ 编译环境和必要的依赖库。

// main.cpp
#include <iostream>
#include <GHDumper.h>

int main(int argc, const char** argv) {
    if (!gh::ParseCommandLine(argc, argv)) {
        std::cout << "[-] Failed to dump offsets.\n";
        return 1;
    }
    std::cout << "[+] Successfully dumped offsets!\n";
    return 0;
}

编译上述代码，生成可执行文件。

然后，创建一个 JSON 配置文件，例如 config.json，根据你的游戏和需求进行配置：

{
    "fileonly": true,
    "relativeByDefault": true,
    "exefile": "C:/Path/To/Game/dump.exe",
    "executable": "GameName.exe",
    "filename": "GameName",
    "additionalModules": [
        {
            "name": "AnotherModule",
            "path": "C:/Path/To/Module/something.dll"
        }
    ],
    "signatures": [
        {
            "name": "TestSig123",
            "pattern": "E9 ? ? ? ? 48 8B 8A ? ? ? ? 48 83 C1 28 E9 ? ? ? ? 40 55",
            "rva": true,
            "opLoc": 1,
            "opLength": 5,
            "module": "AnotherModule"
        }
    ]
}

最后，运行你的可执行文件，并将配置文件拖放到它上面，即可开始提取偏移量。

3. 应用案例和最佳实践

应用案例

• 游戏辅助开发：使用 GH-Offset-Dumper 生成游戏的偏移量，以便开发自定义的游戏辅助工具。
• 游戏调试：在游戏调试过程中，使用偏移量定位关键函数和变量，以便进行更深入的分析。

最佳实践

• 配置文件的维护：保持配置文件更新，以便在游戏更新后能够快速获取新的偏移量。
• 代码的模块化：将生成的偏移头文件包含到你的项目中，确保代码的模块化和可维护性。

4. 典型生态项目

• hazedumper：GH-Offset-Dumper 的灵感来源，也是一个用于游戏偏移量提取的工具。
• 内存分析工具：一个广泛使用的内存扫描和修改工具，可以与 GH-Offset-Dumper 生成的内存分析表兼容。
• ReClass.NET：一个强大的反向工程工具，可以将 GH-Offset-Dumper 生成的 ReClass 文件用于游戏的逆向工程。