1. 项目概述：为什么我们需要UE4Dumper？

如果你和我一样，曾经为了逆向分析一款基于虚幻引擎4（UE4）的手游，在IDA Pro里对着动辄几百MB的libUE4.so文件一筹莫展，那么你肯定对“卡顿”和“崩溃”这两个词深有体会。IDA加载和分析如此庞大的二进制文件，不仅耗时极长，对内存的消耗更是惊人，32GB内存的机器都可能被拖垮。更关键的是，我们逆向的最终目标往往不是整个引擎库，而是找到几个核心的运行时数据结构，比如GWorld和GNames指针。这两个指针是UE4对象系统和游戏世界的入口，有了它们，我们才能进一步分析游戏对象、函数和属性。

传统的手动逆向方法，就像在一片汪洋大海里捞针。你需要定位引擎版本，搜索特征码，分析复杂的初始化流程，整个过程既枯燥又容易出错。而UE4Dumper这个工具的出现，可以说彻底改变了游戏规则。它不是一个简单的内存扫描器，而是一个专门为Android平台UE4游戏设计的“外科手术刀”。它的核心价值在于：直接从游戏进程的内存中，精准地提取出我们需要的libUE4.so库文件，并利用已知的引擎结构信息，自动化地定位并导出GWorld和GNames的地址，甚至能生成一份结构化的SDK文件。

这意味着，你可以绕过IDA那痛苦的分析阶段，直接拿到最关键的“钥匙”。对于手游安全研究、外挂检测原理分析、或是单纯的引擎学习来说，这极大地提升了效率。标题中提到的“4.25版本实战”，正是因为这个版本的UE4在手游中应用广泛，但其内存布局和数据结构与早期版本（如4.18）有显著差异，手动分析门槛更高，因此使用UE4Dumper这类工具的优势就更加明显。

2. 核心概念解析：GWorld与GNames到底是什么？

在深入使用工具之前，我们必须理解我们要找的这两个“指针”究竟是什么，以及它们在UE4引擎中扮演的角色。这能帮助我们在后续分析结果时，知道自己在看什么。

2.1 GNames：虚幻引擎的“姓名簿”

你可以把GNames想象成一个全局的、巨大的字符串表，或者一个“姓名簿”。在UE4中，几乎所有的东西都有名字：类名（UObject，AActor）、函数名、属性名、甚至是资源路径。这些名字并不是以普通的C++字符串形式散落在内存各处，而是被统一管理在一个叫做FName的结构中。

FName本身并不存储完整的字符串，它存储的是一个索引（FNameEntryId）和一个实例编号。这个索引就指向GNames这个全局数组中的某一个条目。GNames本质上是一个TNameEntryArray，即一个存储了所有唯一字符串条目（FNameEntry）的数组。

为什么它如此重要？因为当我们从内存中找到一个对象的虚表（vtable）指针，或者一个函数的地址时，我们往往只能得到一个数字。通过这个数字（通常是对象的UClass*指针），我们可以找到其类信息，进而通过GNames查询到它的类名。没有GNames，我们看到的只是一堆毫无意义的地址和数字，无法理解对象的类型和层次关系。UE4Dumper在生成SDK时，就是利用GNames来为所有导出的类、函数、属性赋予可读的名称。

2.2 GWorld：游戏世界的“总控制器”

如果说GNames是姓名簿，那么GWorld就是整个游戏世界的总控制器和入口点。它是一个UWorld对象的全局指针。在UE4中，一个UWorld代表了一个独立的游戏世界实例，它包含了当前关卡的所有信息。

GWorld的核心职责包括：

• 管理关卡（Level）：当前加载的所有地图、场景资源。
• 维护对象列表：通过PersistentLevel和Levels数组，管理着场景中所有的AActor（游戏中的实体，如角色、武器、道具）和UActorComponent（组件）。
• 游戏模式与状态：指向当前的AGameModeBase和AGameStateBase，定义了游戏的规则和全局状态。
• 玩家控制器：存储本地玩家控制器（APlayerController）列表，这是我们与游戏世界交互的接口。

对于逆向分析而言，GWorld是我们遍历游戏内所有实体的起点。例如，通过GWorld->PersistentLevel->Actors数组，我们可以枚举出场景中所有的敌人、物品、载具等。标题中强调提取GWorld指针，正是因为它是后续进行动态分析（如读取玩家坐标、实体列表）的基石。

2.3 指针的指针：理解间接寻址

在搜索热词中频繁出现的“指针的指针”，是理解UE4Dumper工作原理和手动寻找这些地址时的关键。在UE4的二进制文件中，GWorld和GNames通常不是以一个固定的、直接可读的地址值存储的。

更常见的情况是，代码中会通过一个固定的偏移去访问一个全局变量，而这个全局变量里存储的才是GWorld或GNames的真实地址。有时，为了增加逆向难度（反作弊），引擎或游戏可能会对这两个指针进行一层甚至多层加密或间接寻址。

例如，你可能会在IDA中看到这样的模式：

LDR R1, =_GWorld ; 加载_GWorld符号的地址到R1 LDR R0, [R1] ; 从_GWorld地址处读取内容，这个内容才是真正的GWorld指针

这里的_GWorld就是一个存储着GWorld指针的静态变量地址。UE4Dumper的--derefgname和--derefguobj选项，就是为了处理这种情况而设计的。当设置为true时，工具会认为你提供的地址是“指针的指针”，它会自动进行一次解引用操作，取出最终的有效地址。

3. UE4Dumper工具深度解析与实战准备

了解了目标，我们再来深入看看UE4Dumper这把“手术刀”的构造和用法。根据GitHub仓库的信息，这个项目已经停止更新（Deprecated），但这并不影响其核心功能的强大和实用性，尤其是在对付4.25等经典版本时。

3.1 工具特性与工作原理

UE4Dumper并非通过暴力扫描内存来寻找特征，它采用了一种更聪明、更稳定的方式：

1. 内存库转储（--lib）：它首先会附加到目标游戏进程，然后在内存中找到libUE4.so的映射区域。这个区域包含了引擎代码和数据的完整镜像，但由于Android系统的ASLR（地址空间布局随机化），其加载地址每次启动都不同。工具会读取这个内存区域，并将其重建为一个标准的ELF文件（即可执行的.so文件格式）。这个重建过程修复了ELF文件头和一些节区信息，使其能够被IDA、Ghidra等静态分析工具正确加载。

2. 偏移量系统：工具内部维护了一套针对不同UE4版本的偏移量数据库。这些偏移量定义了关键数据结构（如UObject、UClass、FNamePool）内部成员的相对位置。例如，“UObject.OuterPrivate在UObject结构体开头的第0x10字节处”。当工具处理特定版本的游戏时，会应用对应的偏移量来正确解析内存布局。

3. 指针定位与SDK生成：这是核心功能。当你提供了GWorld或GNames的地址（或存储它们指针的地址），工具会利用上述偏移量，遍历游戏内存中的对象数组（GUObjectArray）或世界对象，解析出每一个UObject的类信息、属性、函数等。最终，它将这些信息输出为一个结构化的文本文件（通常是.hpp或.cs格式的SDK），里面包含了类的继承关系、成员变量偏移、函数签名等，极大地方便了后续的编程交互。

3.2 环境准备与前置条件

在开始实战前，必须确保环境就绪。重要提示：以下所有操作仅用于安全研究、引擎学习等合法目的，请严格遵守相关法律法规和服务条款。

硬件与基础环境：

• 一部已Root的Android设备：这是最直接的方式。因为UE4Dumper需要读取其他进程的内存空间，这通常需要ptrace系统调用权限，而Root权限可以绕过限制。也可以使用Magisk等工具管理Root。
• 或一个带Root的Android模拟器：如雷电模拟器、夜神模拟器，并开启其Root功能。这在测试阶段非常方便。
• ADB（Android Debug Bridge）：确保电脑上安装了ADB，并能通过adb devices命令连接到你的设备或模拟器。
• 目标游戏：一个基于UE4 4.25版本的手游。你可以通过解压游戏的APK文件，查看lib/目录下libUE4.so的版本信息来确认。

工具获取与部署：

1. 从UE4Dumper的GitHub Release页面下载与你的游戏架构（arm64-v8a对应64位，armeabi-v7a对应32位）匹配的预编译二进制文件，或者按照仓库说明使用Android NDK自行编译。
2. 将下载的ue4dumper可执行文件通过ADB推送到设备的/data/local/tmp目录。切勿放在/sdcard，因为Android通常不允许直接执行存储卡上的二进制文件。

   adb push ue4dumper /data/local/tmp/

3. 通过ADB shell进入设备，并切换到该目录，赋予文件执行权限。

   adb shell su # 获取Root权限，如果已Root会提示`#`号 cd /data/local/tmp chmod 755 ue4dumper

关键准备：获取游戏包名与进程信息运行UE4Dumper需要指定目标游戏的包名。默认是com.tencent.ig（国际版PUBG Mobile）。你需要替换成你的目标游戏包名。

• 可以通过adb shell pm list packages列出所有包名来寻找。
• 更准确的方法是，在游戏运行时，通过adb shell ps | grep ue4或adb shell ps -A | grep <游戏名>来查看进程名，进程名通常与包名相关。

4. 实战：针对UE4 4.25版本提取GWorld与GNames

假设我们的目标是一款使用UE4 4.25引擎的64位手游，包名为com.example.ue4game。整个实战流程分为两大步：首先是获取指针地址，然后是使用指针进行信息导出。

4.1 第一步：获取GWorld与GNames的地址

这是最具挑战性的一步，因为UE4Dumper本身不负责自动搜索这些地址，它需要你提供。有几种常见方法：

方法A：从社区或已有资源中查找对于热门游戏，其GWorld和GNames的偏移或查找方法可能在相关论坛、GitHub仓库或逆向社区中已有分享。这是最快的方法。

方法B：通过IDA静态分析寻找（传统方法）

1. 转储libUE4.so：即使为了找指针，先转储一份干净的库文件也是好的起点。

   ./ue4dumper --package com.example.ue4game --lib --output /sdcard/libUE4_dumped.so

   将转储的so文件拉取到电脑，用IDA加载。
2. 搜索字符串：在IDA的字符串窗口（Shift+F12）搜索GWorld或GNames。在4.25版本中，它们可能不是直接以全局变量符号存在，但可能会在函数中被引用，或者有相关的日志字符串。
3. 查找引用：找到引用这些字符串的代码，分析其附近的逻辑。通常，初始化这些全局指针的函数（如UEngine::Init相关）会将其地址写入某个固定的内存位置。你需要找到这个写操作的指令，并定位目标地址。
4. 计算最终地址：在IDA中看到的地址是相对于基址的偏移（如0x12345678）。游戏运行时，libUE4.so会被加载到一个随机基址（假设为0x70000000）。那么GWorld指针的运行时地址就是模块基址 + 偏移量。你可以通过adb shell cat /proc/<pid>/maps | grep libUE4来获取游戏进程中libUE4.so的加载基址。

方法C：结合动态调试与特征码（推荐）对于4.25版本，一个相对稳定的方法是搜索GUObjectArray。因为GNames在较新版本中已并入FUObjectArray（即GUObjectArray）的一部分，或者在其附近。

1. 在IDA中，搜索字节序列或特征码来定位GUObjectArray。不同版本特征码不同，需要参考针对4.25的逆向资料。
2. 找到GUObjectArray后，根据其结构定义（FUObjectArray内部包含TUObjectArray* ObjObjects等），可以计算出GNames（在4.25中可能是FUObjectArray::GetGlobalNames()返回的地址）和GWorld（通常需要通过UEngine::GEngine再到GWorld）的相对位置。

实操心得：对于4.25版本，由于字符串池实现的变化，GNames的直接静态定位比早期版本更复杂。很多时候，社区流传的偏移量是相对于libUE4.so基址的一个固定偏移。例如，GWorld偏移可能是0x12345678。你只需要在游戏运行时，用模块基址 + 0x12345678得到地址A，再用UE4Dumper时，可能需要将地址A作为--gworld的参数，并视情况启用--derefgname true。

假设我们通过某种方法，最终确定了以下信息（均为虚拟地址，需替换为真实值）：

• libUE4.so基址：0x70000000
• GNames指针存储的静态地址偏移：0xABCD1234-> 运行时地址 =0x70000000 + 0xABCD1234 = 0x7ABCD1234
• GWorld指针存储的静态地址偏移：0xDEF5678-> 运行时地址 =0x70000000 + 0xDEF5678 = 0x70DEF5678

4.2 第二步：使用UE4Dumper进行信息导出

拿到地址后，我们就可以开始使用UE4Dumper的强大功能了。以下命令均在设备的/data/local/tmp目录下，已获取Root权限的shell中执行。

场景1：转储内存中的libUE4.so这是基础步骤，可以获得一份可用于静态分析的二进制文件。

./ue4dumper --package com.example.ue4game --lib --output /sdcard/ue4game_dumped.so

• --package: 指定目标游戏包名。
• --lib: 执行库转储操作。
• --output: 指定输出文件路径。这里输出到SD卡，方便后续通过ADB拉取到电脑。
• --fast（可选）：加速转储，但可能丢失少量数据，首次尝试可不加。
• --raw（可选）：输出原始内存数据，不进行ELF重建。除非你知道自己在做什么，否则不建议使用。

场景2：使用GWorld和GNames导出SDK（核心操作）这是标题中提到的核心功能。我们假设找到的地址是需要解引用的指针（即地址里存的是真正的指针值）。

./ue4dumper --package com.example.ue4game --sdkw --gworld 0x70DEF5678 --gname 0x7ABCD1234 --derefgname true --output /sdcard/ue4game_sdk.hpp

• --sdkw: 使用GWorld模式来生成SDK。这是最常用的模式，因为它能更好地构建出基于游戏世界的对象关系。
• --gworld/--gname: 传入我们找到的地址。
• --derefgname true: 告诉工具，我们传入的0x7ABCD1234这个地址，其存储的值才是真正的GNames指针，需要解引用一次。对于GWorld，工具默认可能不解引用，具体行为需参考工具帮助。如果发现生成的SDK中类名全是乱码或空，可以尝试不加此选项，或改为false。
• --output: 输出SDK头文件。

场景3：仅导出字符串或对象列表有时我们只需要快速查看游戏内的所有字符串（用于找UI文本、配置项）或对象列表。

# 导出所有FName字符串 ./ue4dumper --package com.example.ue4game --strings --gname 0x7ABCD1234 --derefgname true --output /sdcard/ue4game_strings.txt # 导出所有UObject列表 ./ue4dumper --package com.example.ue4game --objs --gname 0x7ABCD1234 --guobj 0x7ABCD1234 --derefgname true --output /sdcard/ue4game_objects.txt # 注意：--guobj 参数在某些版本/模式下可能需要提供GUObjectArray的地址，而非GNames地址。

场景4：显示当前世界的Actor列表这是一个非常实用的动态分析功能，可以实时查看游戏场景里有哪些实体。

./ue4dumper --package com.example.ue4game --actors --gworld 0x70DEF5678 --gname 0x7ABCD1234 --derefgname true

命令执行后，会在终端输出当前PersistentLevel中所有AActor的地址、对象索引和名称。这对于验证GWorld指针是否正确，以及快速了解游戏场景构成非常有帮助。

5. 常见问题、排查技巧与实战心得

即使按照步骤操作，你也可能会遇到各种问题。下面是我在多次使用中总结的一些常见坑点和解决思路。

5.1 工具执行失败与权限问题

• 问题：./ue4dumper: not executable: 32-bit ELF file或No such file or directory。

• 排查：

  1. 架构不匹配：确认你下载的ue4dumper二进制文件与游戏进程的架构一致（32位还是64位）。用file ue4dumper命令检查，用adb shell cat /proc/<pid>/maps | head -1查看游戏进程的架构。
  2. 权限不足：确保在/data/local/tmp目录下，并且已执行chmod 755 ue4dumper。如果使用模拟器，确认已开启Root权限，并且ADB shell提示符是#而不是$。
  3. 路径错误：确保在正确的目录下执行命令。

• 问题：工具执行后立刻退出，无任何输出，或提示ptrace相关错误。

• 排查：

  1. 游戏进程未启动或包名错误：用adb shell ps | grep <包名>确认游戏进程是否存在。
  2. 反调试或内存保护：一些游戏有较强的反调试机制。尝试在游戏训练模式、单机模式或刚启动的登录界面下执行。UE4Dumper宣称能绕过部分反调试，但并非万能。
  3. SELinux限制：在某些严格定制的ROM上，即使Root了，SELinux也可能阻止ptrace。可以尝试临时关闭SELinux：setenforce 0（重启后失效）。注意：这会降低系统安全性。

5.2 SDK生成失败或内容异常

• 问题：使用--sdkw或--sdku命令后，工具卡住不动，或者生成的SDK文件非常小，里面类名全是None、Invalid或乱码。
• 排查：
  1. 指针地址错误：这是最常见的原因。GWorld或GNames地址不正确。首先用--actors命令验证。如果--actors能正确输出一长串有意义的Actor名字（如BP_Player，BP_Weapon等），说明GWorld和GNames地址基本正确。如果--actors也失败，则需重新寻找指针。
  2. 解引用选项（--derefgname/--derefguobj）设置错误：这是第二大常见原因。你提供的地址可能是“指针的指针”，也可能是直接的指针。需要尝试不同的组合：
     • 假设你找到的地址是0x7ABCD1234。
     • 尝试命令：--gname 0x7ABCD1234 --derefgname true（假设它是存储指针的地址）。
     • 如果失败，尝试：--gname 0x7ABCD1234 --derefgname false（假设它本身就是指针）。
     • 更进阶的方法是，用调试器或内存查看工具（如GameGuardian），在游戏运行时查看0x7ABCD1234地址处的值。如果这个值看起来像另一个指向代码段或数据段的指针（例如0x7Fxxxxxxx），那么就需要解引用（true）。如果这个值看起来像是一个巨大的、结构化的数据块的起始地址，那可能不需要解引用（false）。
  3. 引擎版本模式错误：对于UE4 4.23及以上版本，可能需要添加--newue参数。我们的目标是4.25，务必加上--newue。命令变为：

     ./ue4dumper --package com.example.ue4game --sdkw --gworld 0x... --gname 0x... --newue --derefgname true --output /sdcard/sdk.hpp

  4. 偏移量不匹配：UE4Dumper内置的偏移量是针对特定版本PUBG Mobile的。其他游戏，尤其是使用修改版引擎的，其内部结构偏移可能不同。这会导致工具解析内存时错位。如果上述方法都无效，可能需要手动为工具提供正确的偏移量，但这需要深厚的逆向功底，通常需要修改源码并重新编译工具。

5.3 性能与稳定性优化

• 问题：生成SDK过程非常缓慢，甚至导致游戏卡顿或崩溃。
• 技巧：
  1. 选择合适时机：在游戏非战斗状态、场景简单（如训练场、大厅）时进行Dump操作。
  2. 使用--fast模式（谨慎）：在转储lib（--lib）时使用--fast可以加速，但可能造成转储的so文件不完整，影响后续静态分析。生成SDK时没有fast选项。
  3. 分步操作：不要一上来就生成完整SDK。先--actors验证指针，再--strings或--objs看看数据是否正常，最后再运行耗时的--sdkw。
  4. 输出到内存文件系统：如果设备支持，输出到/dev/shm或/tmp这类内存文件系统，速度会比SD卡快很多。

5.4 实战心得与高级技巧

1. 指针验证黄金法则：--actors命令是你的最佳验证工具。一个正确的GWorld和GNames组合，应该能稳定输出当前场景中数十甚至上百个有明确命名的Actor。如果输出很少、重复或乱码，100%是指针或选项有问题。

2. 地址的动态性：记住，libUE4.so的加载基址每次游戏启动都会变。因此，你通过静态分析得到的偏移量是固定的，但运行时地址是变化的。你需要写一个简单的脚本或手动计算：运行时地址 = 本次启动的模块基址 + 静态偏移量。

3. 结合Frida进行动态拦截：对于寻找指针，可以结合Frida框架。Hook一些引擎的初始化函数，如UWorld::InitializeActorsForPlay或FName::Init，直接打印或导出GWorld和GNames的地址。这种方法比纯静态分析更精准，但需要一定的Frida使用经验。

4. 生成的SDK的使用：生成的.hpp文件包含了成千上万的类、属性和函数。不要被它吓到。你可以用文本编辑器的搜索功能，快速定位你关心的类，比如APlayerController、ACharacter、APawn。查看它们的属性偏移，这些偏移是相对于对象实例起始地址的。在编写外部读写工具时，这些偏移就是你的“地图”。

5. 关于“指针的指针”的再理解：在逆向中，你可能会看到多级指针。例如，GWorld的实际存储位置可能是一个全局变量UWorld** GWorld。你找到的地址0x70DEF5678存放的是UWorld*的地址。UE4Dumper的--derefgname true就是帮你做那一次解引用（*操作）。如果游戏做了更多层封装或加密，工具可能就无能为力了，需要你手动在内存中跟踪或解密。

最后，记得UE4Dumper项目已归档，对于更新版本的UE4引擎（如4.27， 5.0+），其内存布局和数据结构发生了更大变化，此工具很可能失效。此时需要寻找更新的工具（如UE4Dumper的衍生版本或全新工具）或回归到传统的IDA静态分析与动态调试相结合的方法。但对于像4.25这样的经典版本，掌握UE4Dumper的使用，无疑能让你在逆向UE4手游的效率上获得质的飞跃。