GH-Offset-Dumper 项目启动与配置教程

1. 项目目录结构及介绍

GH-Offset-Dumper 项目的主要目录结构如下：

• src: 源代码目录，包含了项目的核心实现。
• configs: 配置文件目录，包含了项目运行所需的配置文件。
• resources: 资源文件目录，可能包含了一些项目所需的资源，如示例配置文件等。
• .gitignore: 用于Git的忽略文件列表，指定哪些文件和目录应该被忽略。
• GH-Offset-Dumper.sln: Visual Studio解决方案文件，用于在Visual Studio中打开和管理项目。
• LICENSE: 项目许可证文件，说明了项目的版权和许可信息。
• README.md: 项目自述文件，包含了项目的介绍和使用说明。

2. 项目的启动文件介绍

项目的启动主要通过主程序文件进行，具体如下：

• GH-Offset-Dumper-64.exe 或 GH-Offset-Dumper-32.exe: 根据游戏是64位还是32位选择对应的可执行文件。运行此可执行文件，可以启动offset dumper工具。
• 在主程序中，main 函数通过调用 gh::ParseCommandLine 函数来解析命令行参数，并启动offset dump过程。

#include <iostream>
#include <GHDumper.h>
#include <GHFileHelp.h>

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

3. 项目的配置文件介绍

配置文件用于指定offset dumper工具如何操作，主要包括以下内容：

• 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"
    },
    {
      "name": "MysteriousFunction",
      "pattern": "E8 ? ? ? ? 48 8B F8 48 89 44 24 ? 48 85 DB",
      "rva": true
    }
  ]
}

在配置文件中，可以指定是否只从文件中dump（fileonly），是否默认所有签名是相对的（relativeByDefault），目标可执行文件路径（exefile），以及其他模块和签名信息。签名信息包括名称（name）、模式（pattern）、是否为相对地址（rva）、操作位置（opLoc）、操作长度（opLength）等。