USMAP 文件(正确)

USMAP 文件(正确)

一个完整/正式的PBZ源代码USMAP文件,已在“操作指南”中提供

[模组制作资源] ◆ [.USMAP V4 + PPTH + EATR] ◆ [包含源代码] ◆ [Steam 版本 26266538]

《影之刃零》所有类型,尽在一个映射文件中。

为 FModel、UAssetGUI 以及所有基于 CUE4Parse 构建的工具准备的一份完整 .usmap 文件:包含从运行中的游戏读取的全部 15,469 个原生类型,以及从游戏的 252,284 个包中读取的全部 15,002 个蓝图类型——即游戏随附的所有蓝图类、用户定义结构体和蓝图枚举。

▸ **程序代码也一并提供:**实时内存读取器、包读取器、转换器、合并工具和测量工具,全部开源。任何人都可以从游戏中重新生成该文件,并核对其中的每一个类型。

在 GitHub 上开源 ▸ 源代码、所有发行版、SHA-256 校验和

━━━━━━━━━━━━━━ ◆ ━━━━━━━━━━━━━━

◆ 概览

▸ **是什么:**用于模组工具(而非游戏模组)的映射文件 ▸ **文件:**ProjectPBZ-5.7.4-301524-full.usmap,7.3 MB,SHA-256 c7fb911b…6651 ▸ **格式:**usmap 版本 4(显式枚举值),未压缩,包含 PPTH 和 EATR 的 CEXT 块,与 UE4SS 写入的格式一致 ▸ **内容:**30,471 个结构体和类,3,247 个枚举,120,448 个属性 ▸ **引擎:**虚幻引擎 5.7.4,包含 S-GAME 对核心布局的自有修改 ▸ **适用版本:**Steam 版本 26266538(CL-301524_JKS-17219)

◆ 内容明细

  • **原生类型:**引擎、插件和游戏模块(ProjectPBZ、SGame、SGameAI 等)的 15,469 个结构体和类以及 2,984 个枚举。
  • **蓝图类:**14,639 个,来自游戏使用的每一种元类:BlueprintGeneratedClass、LegoAbilityBlueprintGeneratedClass(GA_ 技能)、AnimBlueprintGeneratedClass、WidgetBlueprintGeneratedClass、QuestBlueprintGeneratedClass、ControlRig 和 RigVM 类,以及游戏的 TypeScript 类。
  • **覆盖范围:**全部 3,034 个 BP_ 类、5,781 个 GA_ 技能、全部 208 个动画蓝图、353 个 W_ 控件中的 351 个。少数带有此类前缀但不含类的包用于存放数据或动画。
  • **用户定义结构体和蓝图枚举:**363 个结构体(DS_Player、DS_Weapon、AbilityCooldownData 等)和 263 个枚举,即数据表和数据资产用于其行的类型。
  • **PPTH:**每个类型的包路径(/Script/Engine、/PBZCombatAsset/…、/Game/…)。**EATR:**类和结构体的标志,以及每个属性的标志。

USMAP File (Proper) for Phantom Blade Zero.

USMAP File (Proper) for Phantom Blade Zero.

◆ 使用方法

  1. 下载主文件并解压 ProjectPBZ-5.7.4-301524-full.usmap。
  2. **FModel:**在设置中开启本地映射文件,并选择该文件。
  3. **UAssetGUI:**将文件复制到 %LOCALAPPDATA%\UAssetGUI\Mappings,并在映射列表中选择 ProjectPBZ-5.7.4-301524-full。UAssetGUI 1.1.0 最高仅支持 UE 5.6:请对该游戏使用 VER_UE5_6。
  4. **你自己的工具:**任何支持 usmap 版本 4 的读取器均可使用。PPTH 和 EATR 与 UE4SS 写入其自身映射文件的块相同。

◆ 制作方法

  1. **原生类型(来自运行中的游戏):**usmap_live.py 从外部读取游戏内存(仅使用 ReadProcessMemory,不写入任何内容)。它遍历 GUObjectArray 和 FName 池,并按照与 UE4SS 的 USMapGenerator 相同的规则,沿每个 UClass、UScriptStruct 和 UEnum 的 FField 链进行跟踪:相同的对象、相同的属性类型映射、相同的名称、PPTH 和 EATR。它按照游戏自身的核心布局读取:UStruct 在 ChildProperties 之后多出 0x50 字节,FField 的 Next 和 Owner 互换,FFieldClass 名称位于 0x30,TUObjectArray 的字段顺序不同,部分 UEnum 名称数组使用带标签的指针。
  2. **蓝图类型(来自包):**一个基于 CUE4Parse 1.2.2.202610(GAME_UE5_7)的 C# 控制台工具使用 AES 密钥挂载游戏的 IoStore 容器,并读取其类为类、结构体或枚举类型的每个导出。它们的属性以自描述形式存储,因此原生类型足以读取它们。结果:252,284 个包在 34 秒内完成,16,160 个类型,无错误。
  3. **按 UE4SS 的规则转换:**带枚举的 ByteProperty 变为 EnumProperty<Byte>;ClassProperty 和 ObjectPtrProperty 变为 ObjectProperty;SoftClassProperty 变为 SoftObjectProperty;内联和稀疏多播委托变为 MulticastDelegateProperty;schema 索引为 ArrayDim 的运行总和;名称会去掉其第一个 "::" 之前的所有内容。
  4. **合并:**每个名称只出现一次(优先原生类型;名称比较时忽略大小写,与虚幻引擎一致),加载类型的运行时标志来自实时读取,最后一遍确保每个引用都可读。转换器对其输入进行排序,因此每次构建都会生成相同的字节。
  5. **对照运行中的游戏检查:**在已加载的 2,380 个蓝图类型中,2,300 个完全匹配,76 个仅名称大小写不同。其余 4 个指向下方缺失的枚举。

◆ 测试情况

✔ **UAssetGUI 1.1.0:**425 个游戏资产(PBZContent/DataTable 中的每个数据表以及物品蓝图),2,914 个导出:416 个资产和 78 个数据表中的 77 个被完整读取。剩余的 9 个导出为 8 个样条组件和一个编辑器表,UAssetGUI 1.1.0 无法读取。 ✔ **CUE4Parse:**读取了 1,747 个玩法包的 32,510 个导出,无错误。

◆ 注意事项

○ **每个名称只保留一个条目:**usmap 仅按名称查找类型。有 32 个名称存在于多个包中且内容不同:每个动画蓝图的 AnimBlueprintGeneratedConstantData、Ultra Dynamic Sky 插件的两份副本、少数被复制到第二个文件夹的蓝图。文件保留原生类型,否则保留最常见的一个。FModel 会从资产本身读取此类类型。 ○ **一个缺失的枚举:**AI 条件和行为树装饰器中的 10 个枚举属性(Condition_Distance_C、BTDecorator_DistanceTo_C 等)指向 EComparisonMethod,而游戏中并不存在该枚举。文件为它们指定其底层类型 ByteProperty。读取的是相同的字节。 ○ **一个缺失的结构体:**BPDA_SeqConfigData_C.ActorCollectDatas 指向一个游戏中不存在的结构体;其结构体名称为 "None"。 ○ **已排除:**仅编辑器使用的控件 WBP_DefaultQuestNode_C;其父类仅存在于编辑器中。 ↻ **游戏更新后:**更新所更改的类型可能会过时。新版本会随后发布;本页面标明了该文件对应的游戏版本。

◆ 源代码

制作此文件的所有内容都在 GitHub 仓库中,MIT 许可证,以及发行版的源代码 zip 中:

  • src/usmap_live.py + process_memory.py:对运行中游戏的只读转储,采用上述引擎布局。
  • src/usmap_offline/:基于 CUE4Parse 的 C# 包读取器(.NET 10);还包括 --probe(列出包的导出)和 --readtest(使用给定映射文件读取每个导出)。
  • src/usmap_offline.py:按 UE4SS 的规则将包类型转换为 usmap。src/usmap_merge.py:合并及其最后一遍处理。src/usmap_quality.py:计数、完整性和覆盖率。src/usmap_io.py:读写 usmap 0 到 4,支持 PPTH 和 EATR。
  • build.ps1 运行整个链条;tests/test_usmap.py 离线测试脚本(22 项检查)。

**自行构建:**Windows、Python 3.11+、.NET 10 SDK、oo2core_9_win64.dll(Oodle)、游戏、其 AES 密钥以及其原生类型的转储。然后:

powershell -ExecutionPolicy Bypass -File .\build.ps1 -PaksDir <game>\ProjectPBZ\Content\Paks -AesKey <key> -Native <native.usmap> -Oodle <oo2core_9_win64.dll>

相同的输入每次都会生成相同的字节。你自己的原生转储会得到相同的类型;只有实时转储的运行时标志可能不同。

◆ 致谢

  • FabianFG 和 CUE4Parse 贡献者——感谢 CUE4Parse(Apache-2.0),它负责读取包。
  • UE4SS 团队——感谢 usmap 格式及其在 RE-UE4SS(MIT)中的规则,这是 OutTheShade 的 UnrealMappingsDumper 的移植版。
  • S-GAME——感谢《影之刃零》,一款值得制作模组的游戏。

━━━━━━━━━━━━━━ ◆ ━━━━━━━━━━━━━━

KINTARO 的更多《影之刃零》模组

由 Kintaro 制作。MIT 许可证:可自由使用、修改和分享。任何人都可以从其源代码构建该文件,并据此核对下载内容。《影之刃零》及其文件归 S-GAME 所有;该文件仅包含游戏类型的名称和布局。