UE4游戏逆向实战：Unreal-Finder-Tool自动化定位GNames与GObjects

1. 项目概述与核心价值

如果你正在研究或修改基于虚幻引擎4（UE4）开发的游戏，无论是为了制作模组、进行游戏数据分析，还是深入理解其内部对象结构，一个绕不开的难题就是如何从运行中的游戏进程里，准确地找到并导出那些关键的运行时信息，比如游戏里所有的对象（GObjects）和它们的名称（GNames）。手动去内存里大海捞针？那效率低得令人发指，而且极易出错。Unreal-Finder-Tool（后文简称UFT）就是为解决这个痛点而生的利器。它是一个专门为UE4游戏设计的逆向工程辅助工具，核心功能就是自动化地扫描、定位并导出游戏的GNames和GObjects数组，进而生成可用的C++ SDK头文件。

简单来说，它把一项原本需要深厚逆向功底和大量手动操作的工作，变成了几乎可以一键完成的流程。你不需要自己去推算偏移、分析虚表，UFT会帮你完成最繁琐的底层内存模式匹配工作。这对于游戏模组开发者、外挂（Cheat）编写者（在合法研究范围内）、安全研究人员乃至只是想学习UE4引擎运行时结构的爱好者来说，价值巨大。它能让你快速获得游戏的“骨架”，即所有类的定义、对象实例的地址和关系，这是进行任何深度修改或分析的第一步，也是最关键的一步。虽然项目在2021年已归档，但其v3版本的代码和思路至今仍是学习UE4游戏逆向的经典参考。

2. 工具核心功能与工作原理拆解

在深入使用之前，有必要理解UFT到底在做什么，以及它是如何做到的。这能帮助你在遇到问题时，不是盲目尝试，而是有方向地排查。

2.1 核心目标：定位UE4运行时核心数组

UE4引擎在运行时，会维护几个全局的核心数据结构，其中最重要的两个就是GNames和GObjects（在较新版本中可能演变为GUObjectArray）。

  • GNames： 一个存储了所有FName字符串（游戏内对象、函数、属性等的名称）的全局数组。找到它，你就获得了游戏中所有“名字”的目录。
  • GObjects： 一个存储了所有UObject实例（游戏里的一切，从角色、武器到UI元素，都是UObject或其子类）的全局数组。找到它，你就获得了游戏中所有“物体”的清单。

游戏逆向的许多工作，比如寻找玩家指针、武器类、游戏世界实例，都始于对这两个数组的遍历和筛选。UFT的核心任务，就是自动化地、可靠地在目标游戏进程的内存空间中，找到这两个数组的起始地址。

2.2 核心功能模块解析

UFT v3版本主要集成了以下几个功能模块，共同构成了一个完整的工作流：

  1. GNames/GObjects查找器： 这是工具的“引擎”。它通过特征码扫描（Pattern Scan）或启发式搜索，在游戏进程的内存中寻找符合GNames和GObjects结构特征的地址。它会尝试多种已知的UE4版本内存布局模式，以提高查找成功率。你只需要选择目标进程，点击“查找”，它就会输出找到的地址。

  2. 实例记录器（Instance Logger）： 一旦获得了有效的GObjects地址，这个功能可以遍历整个数组，将每个UObject的地址、所属的类（FName）、以及对象名称（FName）导出到一个文本文件中。这相当于给你生成了一份游戏内所有对象的实时“花名册”，是后续分析的基础数据。

  3. SDK生成器（SDK Generator）： 这是UFT最强大的功能。它不仅仅记录对象实例，还能通过分析对象的虚函数表（vTable）和属性结构，反向推导出这个对象所属的C++类的内存布局。最终，它会生成一组.h头文件，里面包含了游戏中重要类的C++定义，包括成员变量、函数签名等。有了这个SDK，你就可以在自己的外部程序或DLL中，以类型安全的方式读取和修改游戏内存，极大地简化了开发流程。

  4. 内核模式内存读写： 工具集成了通过驱动进行内核模式读写的功能（基于BypassPH等思路）。这主要是为了对抗一些游戏的反调试或内存保护机制。在用户模式（常规的ReadProcessMemory）访问被拦截或导致游戏崩溃时，切换到内核模式读写可能是一条可行的路径。请注意，此功能涉及底层系统操作，使用需格外谨慎，并确保你拥有在目标系统上进行此类操作的合法权限。

  5. JSON引擎与类查找器： 为了应对不同UE4版本间结构体的变化，UFT引入了JSON配置文件来定义关键结构体的偏移。Class Finder功能允许你输入一个类名（如“APlayerController”），工具会遍历GObjects，列出所有属于该类或其子类的实例地址，这对于快速定位关键对象非常有用。

2.3 工具界面与设计逻辑

UFT使用ImGUI构建了直观的图形界面。界面通常分为几个区域：

  • 进程选择与连接区： 列出系统进程，供你选择目标UE4游戏。
  • 地址输入与查找区： 显示或手动输入GNames、GObjects的地址，并提供“查找”按钮。
  • 功能执行区： 放置“Dump GNames/GObjects”、“Generate SDK”、“Find Class”等核心功能的按钮。
  • 日志与信息输出区： 显示操作进度、结果和错误信息。

其设计逻辑是线性的：先连接进程 -> 自动或手动找到核心地址 -> 利用这些地址执行高级功能（导出、生成SDK）。理解这个流程，能让你更清晰地使用工具。

3. 环境准备与工具获取

工欲善其事，必先利其器。在使用UFT前，需要做好以下准备。

3.1 系统与运行时环境

  • 操作系统： Windows 7/10/11 (64位)。工具本身支持64位和32位（x86）目标进程，但作为主程序的UFT通常是64位的，以便能读写64位游戏进程。
  • 目标游戏： 使用虚幻引擎4开发的游戏。你需要确认游戏版本。UFT v3主要针对2019年及之前的UE4版本（大约4.20以下）优化较佳。对于更新版本的游戏，可能需要手动调整或寻找社区提供的JSON配置文件。
  • 依赖项： 通常UFT的发布版本是独立的可执行文件（.exe），但有时可能需要Visual C++ Redistributable运行库。如果运行时提示缺少DLL（如MSVCP140.dll,VCRUNTIME140.dll），请安装最新版的 Visual C++ Redistributable 。
  • 权限： 以管理员身份运行UFT。因为工具需要调用OpenProcess等API获取较高的进程访问权限，特别是当游戏本身以管理员权限运行时。

3.2 工具版本选择与获取

由于原仓库已归档，你需要从GitHub的Release页面或可靠的第三方镜像获取编译好的可执行文件。

  1. 访问https://github.com/corrm/Unreal-Finder-Tool/releases。
  2. 找到最新的v3版本（例如v3.1.0）的Assets，下载其中的UnrealFinderTool.zip或类似名称的压缩包。
  3. 解压到本地一个单独的文件夹。强烈建议不要在桌面或系统目录直接运行，因为工具运行时会生成日志、配置文件、导出的SDK等文件。

注意： 网络上可能存在被修改过的版本。务必从官方仓库或你信任的来源下载，以避免潜在的安全风险（如捆绑恶意软件）。下载后，可以用杀毒软件扫描一下，但请注意，此类逆向工具本身的行为（如内存扫描、注入）可能被启发式检测误报为风险，需要你自行判断。

3.3 辅助工具准备

为了更顺利地使用UFT，建议准备以下辅助工具：

  • 进程查看器： 如系统自带的“任务管理器”（详细信息视图），或更专业的Process Hacker、Process Explorer。用于确认目标游戏的准确进程名和PID。
  • 调试器/内存查看器（可选但推荐）： 如x64dbg或Cheat Engine。当UFT自动查找失败时，你可能需要手动寻找地址，这些工具必不可少。它们也能帮你验证UFT找到的地址是否正确。
  • 文本编辑器/IDE： 如Visual Studio Code或Visual Studio，用于查看和编辑UFT生成的SDK头文件、JSON配置文件。

4. 完整使用流程与实操详解

现在，我们以一个假设的64位UE4游戏“ExampleGame.exe”为目标，走一遍完整的UFT使用流程。

4.1 第一步：启动与进程附加

  1. 启动游戏和UFT： 首先运行你的目标UE4游戏，并进入游戏主界面或某个可稳定运行的状态。然后，以管理员身份运行UnrealFinderTool.exe。
  2. 选择目标进程： 在UFT主界面的进程列表里，找到你的游戏进程。通常进程名就是游戏的可执行文件名（如ExampleGame.exe）。点击选中它。
    • 实操心得： 如果列表中没有你的游戏，尝试点击“Refresh”按钮。如果还是没有，检查游戏是否真的已经运行，以及UFT是否以管理员权限运行。有些带反作弊的游戏可能会隐藏进程，这超出了基础教程范围。

4.2 第二步：自动查找核心地址

这是最关键的一步。在旧版本中，你可能需要手动查找并输入GNames的地址。但在v3.1.0及之后，流程大大简化。

  1. 执行查找： 在界面上找到“Find GNames”和“Find GObjects”的按钮（有时会合并为一个“Find”或“Scan”按钮）。直接点击“Find GNames”。
  2. 观察结果： 工具会开始扫描游戏内存。如果成功，它会在对应的输入框（通常标有“GNames Address”和“GObjects Address”）中自动填入找到的地址，格式是类似0x7FF6A1B2C000的十六进制数。同时，日志区域会显示“GNames found at: 0x...”的成功信息。
    • 常见问题： 如果查找失败，日志会报错。失败原因可能包括：
      • 游戏版本太新： UFT v3的内置模式识别不了新版UE4的内存布局。
      • 游戏有保护： 内存被加密或混淆，常规扫描找不到特征。
      • 扫描范围/权限不足： 可以尝试在UFT的设置中（如果有）勾选“Use Kernel Mode”或调整扫描参数，但这需要更深入的知识。
  3. 验证地址（重要）：不要完全依赖自动结果。用一个简单的方法验证：点击“Dump GNames”或“Dump GObjects”。如果地址正确，工具会快速导出一个文本文件（如GNames.txt），里面是成千上万个名称字符串（如/Script/CoreUObject.Object,/Game/Characters/Player等）。如果导出失败、文件为空或程序崩溃，说明地址很可能不对。

4.3 第三步：导出基础信息与查找特定类

获得有效地址后，你可以进行一些基础操作来熟悉数据和验证环境。

  1. 导出GNames/GObjects列表： 分别点击“Dump GNames”和“Dump GObjects”按钮。这会在UFT工具所在目录生成两个文本文件。用文本编辑器打开GObjects.txt，你会看到类似下面的行：

    [0x1426F45F0] Class: Actor | Name: PersistentLevel [0x1426F4890] Class: PlayerController | Name: PlayerController_0 ...

    这证明了你的工具工作正常，并且已经掌握了游戏对象的全局视图。

  2. 使用类查找器： 在“Class Finder”或类似功能的输入框中，输入你想查找的类名，例如“PlayerController”。点击查找。工具会遍历GObjects，列出所有类名为PlayerController或其子类（如APlayerController）的实例地址。这个功能对于快速定位你关心的对象极其有用，比如找到本地玩家控制器（Local Player Controller）的地址，这是很多修改的起点。

4.4 第四步：生成C++ SDK（核心进阶功能）

这是UFT的终极功能，能将内存中的对象结构反编译为C++代码。

  1. 配置生成选项： 在生成SDK前，通常有一些选项需要选择：

    • SDK类型：
      • Internal： 生成用于内部DLL注入的SDK。类定义中会包含虚函数，并且会生成可以直接调用的函数指针（如果工具能解析的话）。适用于你打算写一个DLL注入到游戏进程内部的情况。
      • External： 生成用于外部进程读写的SDK。这是更常用的选项。它会为每个类生成ReadAsMe和WriteAsMe函数，这些函数封装了ReadProcessMemory和WriteProcessMemory，让你能方便地在外部程序中以结构体的方式安全地读写游戏内存。
    • 游戏名称与版本： 填写这些信息会体现在生成的文件头注释中，便于管理。
    • 输出路径： 选择或确认SDK文件输出的文件夹。

  2. 执行生成： 点击“Generate SDK”按钮。工具会开始工作，期间会遍历对象、分析虚表、解析属性。这个过程可能需要几十秒到几分钟，取决于游戏对象的数量。观察日志输出，它会显示当前正在处理的类名。

  3. 处理生成结果： 完成后，在输出文件夹（通常是UFT目录下的SDK子文件夹）里，你会看到一堆.h头文件，例如：

    • Basic.h： 包含FName、FString、TArray等UE4基础类型的定义。
    • CoreUObject.h： 包含UObject,UClass,UFunction等核心类的定义。
    • Engine.h： 包含AActor,APawn,APlayerController,UWorld等引擎关键类的定义。
    • GameplayClasses.h： 包含游戏特定逻辑类的定义（如果被识别出来）。

  4. 在外部项目中使用SDK：

    • 将生成的整个头文件文件夹复制到你的Visual Studio等C++项目中。
    • 在你的代码中包含所需的头文件，例如#include “SDK/Engine.h”。
    • 如果你生成的是External SDK，你需要实现一个简单的内存读写接口。通常，UFT生成的SDK会依赖于一个全局的“内存读写器”对象。你需要参考SDK根目录下的example.cpp或README，实现一个类似下面的类：
      class MemoryManager { public: template<typename T> bool Read(uintptr_t address, T& value) { SIZE_T bytesRead; return ReadProcessMemory(hProcess, (LPCVOID)address, &value, sizeof(T), &bytesRead) && bytesRead == sizeof(T); } // 类似地实现Write函数... HANDLE hProcess; }; extern MemoryManager Mem;
    • 然后，你就可以像下面这样安全地读取游戏数据了：
      uintptr_t playerControllerAddr = 0x1426F4890; // 从UFT的Class Finder获得 APlayerController pc; if (Mem.Read(playerControllerAddr, pc)) { FString playerName; if (Mem.Read(pc.PlayerState->PlayerNamePrivate, playerName)) { std::cout << "Player Name: " << playerName.ToString() << std::endl; } }

重要提示： 自动生成的SDK并非100%完美。对于复杂的继承关系、模板类或某些特定版本的引擎，可能需要手动校对和调整偏移量。生成的代码是学习的起点和强大的辅助，而非最终成品。

5. 高级技巧、疑难排查与注意事项

即使按照流程操作，你也可能会遇到各种问题。这里分享一些实战中的经验和排查思路。

5.1 自动查找失败的应对策略

如果UFT无法自动找到GNames/GObjects，你就需要手动介入。

  1. 使用Cheat Engine手动定位（通用方法）：

    • 附加Cheat Engine到游戏进程。
    • UE4的GNames通常是一个指向TNameEntryArray结构的指针。一个经典的寻找方法是搜索已知的FName字符串。
    • 在CE中搜索字符串类型（String），输入一个你确信游戏里存在的、独特的FName，例如从游戏日志或之前导出的不完整列表中看到的“/Script/Engine.PlayerController”。
    • 在结果列表中，右键点击某个地址，选择“Browse this memory region”。在内存浏览器中，向上滚动，寻找一个看起来像是结构体指针数组的区域。GNames数组的地址通常在这个字符串地址上方不远处，并且其本身是一个指针，指向另一个包含TNameEntryArray的地址。这需要一些经验和对UE4内存布局的了解。
    • 对于GObjects，可以搜索“Object”类对象的虚函数表指针。或者，如果找到了GNames，有时在其附近的内存区域也能发现GObjects的线索。

  2. 更新或自定义JSON引擎文件： UFT支持通过JSON文件定义不同UE4版本的结构体偏移。如果游戏版本较新，可以尝试在社区（如UnknownCheats论坛、相关Discord频道）寻找其他人分享的对应游戏版本的JSON配置文件，将其放入UFT的JsonEngine或Resources目录。你也可以根据逆向结果，参照现有的JSON格式手动创建或修改。

5.2 SDK生成过程中的常见问题

  1. 生成崩溃或无响应： 可能是遇到了无法解析的虚函数表或异常对象。尝试在设置中限制生成的类范围，或者先只导出GObjects列表，然后针对少数关键类进行SDK生成测试。
  2. 生成的类成员偏移错误： 这是最常见的问题。表现为用SDK读取的数据全是乱码。解决方法： 使用调试器（如x64dbg）附加游戏，找到该类的某个实例，手动分析其内存布局，与生成的SDK头文件对比。重点检查类继承链顶部的父类（如UObject）的成员偏移（InternalIndex,ClassPrivate等）是否正确。UE4不同版本间这些基础偏移常有变化。你需要手动修正头文件中的STRUCT_OFFSET宏定义。
  3. External SDK的ReadAsMe/WriteAsMe无法编译： 检查你是否正确实现了MemoryManager类，并声明了全局实例Mem。确保你的项目链接了必要的库（如kernel32.lib用于ReadProcessMemory）。

5.3 内核模式读写的风险与注意事项

UFT集成的内核读写功能是一把双刃剑。

  • 风险： 内核驱动（如果使用）安装不当可能导致系统蓝屏（BSOD）。某些游戏的反作弊系统（如BattlEye, EasyAntiCheat）会检测并封禁使用未签名内核驱动进行内存操作的行为，导致游戏账号被封。
  • 建议： 仅在绝对必要（用户模式读写被拦截）且你清楚后果的情况下使用。对于单机游戏或研究环境可以尝试，对于在线游戏务必谨慎。优先尝试用户模式下的各种方法。

5.4 保持学习与社区资源

UFT是一个强大的起点，但不是终点。UE4逆向是一个深奥的领域。

  • 深入学习： 理解UE4的UObject系统、属性系统（UProperty）、反射机制是根本。推荐阅读UE4官方文档中关于对象系统的部分，以及逆向社区的分析文章。
  • 工具更新： UFT v3之后，社区有更新的工具出现，如UE4Dumper、Unreal Engine 4 Game Explorer等，它们可能支持更新的引擎版本。多关注GitHub和UnknownCheats等论坛。
  • 法律与道德： 所有技术都应被用于合法的目的，如单机游戏模组开发、安全研究、教育学习。尊重游戏开发者的劳动成果和服务条款，切勿将其用于破坏在线游戏公平性或侵犯他人权益。

最后，使用像UFT这样的工具，最大的收获不仅仅是获得一个游戏的SDK，更是在这个过程中对虚幻引擎运行时机制的深刻理解。每一次手动修正偏移、分析内存布局，都是对你逆向工程能力的锻炼。从依赖工具自动生成，到能独立验证和修正其输出，再到能完全手动完成整个分析流程，这才是成长的路径。工具让起点变高了，但通往精深的道路，依然需要一步步扎实地走。