游戏内存结构详解

核心概念速查表

解密类型说明

ImageBase 根节点

ImageBase 是 TslGame.exe 可执行文件加载到内存中的起始地址，也称为模块基址。这是所有静态偏移量的计算起点。

为什么需要 ImageBase？

操作系统将程序加载到内存时，每次启动的加载地址可能不同（ASLR 随机化）。通过使用相对偏移，我们可以计算出在任何加载地址下都能正确访问的目标地址：

例如：ImageBase + 0x10A5F8 = UWorld 指针的实际内存地址

GameBase 下的核心指针

UWorld 核心枢纽

UWorld 是 Unreal Engine 4 的核心对象，代表一个游戏"世界"或"地图"。它包含当前游戏会话的所有信息：当前级别、所有Actors、持久数据等。从 UWorld 可以访问游戏的几乎所有重要组件。

UWorld 访问路径

GameInstance (GI)

GameInstance 是一个跨会话持久存在的对象，从主菜单一直存活到游戏结束。它是管理全局游戏状态和本地玩家数据的主要入口点。

包含内容

• LocalPlayers - 本地玩家数组指针
• GameState - 游戏状态引用
• OnlineSubsystem - 多人在线子系统
• SplashScreen - 启动画面

LocalPlayer (LP)

LocalPlayer 代表本地机器上的玩家数据。它包含了访问玩家控制器所需的信息，以及一些本地特定的设置（如控制方案、音频设置等）。

关键属性

PlayerController (PC)

PlayerController 是处理玩家输入和控制游戏角色的核心类。它连接玩家的输入设备（键盘、鼠标、手柄）与游戏中的 Pawn（角色实体）。

主要职责

• 输入处理 - 接收并解析键盘/鼠标/手柄输入
• 相机控制 - 管理相机的位置和旋转
• 角色控制 - 控制 Pawn 的移动和动作
• 视角同步 - 在多人游戏中同步其他玩家的视角

PlayerCameraManager (PCM)

相机管理器负责计算和存储最终的相机状态。它综合考虑多种因素（玩家输入、角色动画、瞄准状态等）来生成最终的相机参数。

相机缓存数据

Pawn（角色/Pawn）

Pawn 是游戏世界中可以被控制的实体。对于玩家来说，Pawn 就是操控的角色；对于敌人来说，Pawn 是 AI 控制的 NPC 或其他玩家。Pawn 包含实体的所有物理和视觉属性。

核心组件

角色属性

Health 系统 未使用

以下是完整的生命值系统结构，但当前代码中并未启用。

SkeletalMesh (Mesh)

SkeletalMesh（骨骼网格体）是具有骨骼动画的 3D 模型。每个角色、武器、载具都有对应的 SkeletalMesh。它不仅用于渲染，还提供了访问骨骼位置的能力。

骨骼相关属性

渲染相关属性

AnimScriptInstance

动画脚本实例是运行中的动画系统的数据容器。它存储了角色的当前动画状态、动作轨迹、旋转信息等。对于读取后坐力控制、左右倾斜等数据至关重要。

关键动画数据

WeaponProcessor (WP)

武器处理器是管理角色当前装备和使用的武器的核心组件。它追踪当前武器索引、武器库、以及弹道数据。

WeaponTrajectoryData 弹道数据

弹道数据包含子弹的物理飞行参数，用于计算弹道轨迹和击中点。

VehicleRiderComponent (VRC)

载具骑乘组件附加在角色身上，当角色进入载具时激活。它追踪角色与载具的交互状态，包括坐在哪个座位、当前驾驶的载具等。

载具相关属性

VehiclePawn (VP)

载具 Pawn 是载具本身的数据容器，包含载具的位置、油量、耐久度等信息。

GameState (GS)

GameState 是服务器权威的游戏状态管理器，在多人游戏中由服务器维护。它包含游戏会话的全局信息，对所有玩家可见。

核心属性

Actors 数组

Actors 是场景中所有实体的动态数组，包含玩家、Bot、AI、物品、载具、投掷物等一切游戏对象。通过遍历这个数组，可以访问场景中的任何实体。

Actors 数据结构

Actor 实体结构

每个 Actor 实体都包含以下关键信息：

GNames 名称解析

GNames 是全局名称表，存储了所有游戏对象的字符串名称。通过 ObjID 可以在 GNames 中查找任意对象的名称。

例如：ObjID=12345 → GNames[12345] = "BP_PlayerMale_A_C"

Vec3 三维向量

用于表示 3D 空间中的点或方向，包含 X, Y, Z 三个浮点数。

struct Vec3 {
    float X;  // 左右 (右为正)
    float Y;  // 前后 (前为正)
    float Z;  // 上下 (上为正)
}

Rotator 旋转角度

表示 3D 空间中的旋转，使用欧拉角。

struct Rotator {
    float Pitch;  // 俯仰 (-90° ~ +90°)
    float Yaw;    // 偏航 (0° ~ 360°)
    float Roll;   // 翻滚 (-90° ~ +90°)
}

FTransform 变换矩阵

包含位置、旋转、缩放的完整变换信息。

struct FTransform {
    Rotator  Rotation;    // 旋转
    Vec3     Translation; // 位置
    Vec3     Scale3D;     // 缩放
}

TArray 动态数组

Unreal Engine 的动态数组类型。

struct TArray<T> {
    uintptr Data;   // 数据指针
    int      Count;  // 元素数量
    int      Max;    // 分配的数组大小
}

交互式内存访问路径图

橙色节点 = 需要 XeDecrypt 解密    绿色节点 = 直接读取