Description
USMAP File (Proper)
A full mapping file (.usmap) for Phantom Blade Zero, for modders: every native type plus every Blueprint class,
struct and enum of the game's packages.
What it is
- Modding tools such as FModel and UAssetGUI need a mapping file to read this game's assets. The game saves asset values without their names (unversioned properties); the mapping file gives each value its name and type.
- This file holds all of them: 30,477 structs and classes (14,632 of them Blueprint classes) and 3,247 enums, with the package path of each type (PPTH) and the flags (EATR), in the format UE4SS writes.
- The Blueprint types come from the game's packages, so the file holds every one of them, not only the ones that
are loaded at some moment in the game: all 3,036
BP_Blueprint classes (the one otherBP_package holds data, not a class), 5,778GA_abilities (the otherGA_packages we looked at hold bullet data or animations), all 208 Animation Blueprints. - Made for the game update of 2026-11-04, Steam build 26367565. The update changed some types, so use this file for
that build. For the first release of the game (Steam build 26266538) use the release
v1.0of this repository.
Screenshots
How to use
- FModel: in the settings, turn on the local mapping file and choose
ProjectPBZ-5.7.4-302256-full.usmap. - UAssetGUI: copy the file into
%LOCALAPPDATA%\UAssetGUI\Mappings\and chooseProjectPBZ-5.7.4-302256-fullin the mappings list. UAssetGUI 1.1.0 knows UE 5.6 at most: useVER_UE5_6for this UE 5.7.4 game. - Other tools that take a
.usmap(CUE4Parse and the tools built on it) work the same way.
Measured
- UAssetGUI 1.1.0 (one run at a time), 425 game assets (all data tables of
Content/PBZContent/DataTable/and the item Blueprints ofPBZContent/Blueprint/Item/), 2,914 exports: 416 assets fully read, 77 of 78 data tables read. The 9 exports left are 8 spline components and one editor table, which UAssetGUI 1.1.0 does not read. - CUE4Parse (the library of FModel): 31,772 exports of 1,750 gameplay packages read with no error.
How it was made
- Native types: read from the running game, read-only, by
src/usmap_live.py --native-only, with the same objects, types and rules as UE4SS's mapping generator. - Blueprint types: read from all 252,268 packages of the game with CUE4Parse
(
src/usmap_offline/, no error), turned into usmap types by UE4SS's rules (src/usmap_offline.py). Checked against the running game (src/usmap_live.py) on the 3,380 Blueprint types that were loaded: 3,266 equal, 110 different only in the upper or lower case of a name (Unreal ignores it), 4 in an enum that the game does not have (Known issues). - Merged into one file with every name once (
src/usmap_merge.py), and measured (src/usmap_quality.py).
Compatibility
- Game version: Steam build 26367565 (
CL-302256_JKS-17280), Unreal Engine 5.7.4. - After a game update the file can be out of date for the types the update changes. A new version follows; this page names the game version it was made for.
Changes
- 1.1 (2026-11-04): made again for Steam build 26367565. The update added 4 native structs and changed 6
(
BasicAttributeSet,PBZCharacterAttributeData,PBZCharacterAttributeTableData,PBZSettingsShared,BellDataStruct,GA_ThunderSpearParalyzeAchievementPassive), changed the enumEBellType, and added and removed some Blueprint classes. The file name now holds the new changelist, 302256. - 1.0 (2026-10-29): first version, for Steam build 26266538.
Known issues
- A mapping file holds each type name once. 32 names exist in several packages with different content (for
example
AnimBlueprintGeneratedConstantDataof each Animation Blueprint, or two copies of the Ultra Dynamic Sky plugin): the file keeps the native type, else the most common one. FModel reads such types from the asset itself. - 10 enum properties (in AI conditions such as
Condition_Distance_C) point to the enumEComparisonMethod, which the game does not have. The file gives them their number type (Byte), which reads the same data. - One property (
BPDA_SeqConfigData_C.ActorCollectDatas) points to a struct that is missing in the game; its struct name isNone. One editor-only widget (WBP_DefaultQuestNode_C, its parent class exists only in the editor) is left out.
How to build
Anyone can make this file again from the game and check it against the download. README.md has the details.
- Windows with PowerShell 5.1, Python 3.11 or newer, the .NET 10 SDK, and
oo2core_9_win64.dll(Oodle, for example from the retoc release). - The game, its AES key, and a mapping file of its native types (
src/usmap_live.py --native-onlywhile the game runs, or UE4SS'sDumpUSMAP(false)). powershell -ExecutionPolicy Bypass -File .\build.ps1 -PaksDir <game>\ProjectPBZ\Content\Paks -AesKey <key> -Native <native.usmap> -Oodle <oo2core_9_win64.dll>- The file:
dist\ProjectPBZ-5.7.4-302256-full.usmap, anddist\SHA256SUMS.txt.
Credits
- Made by Kintaro. MIT license: you may use, change and share the file and the code.
- CUE4Parse by FabianFG and its contributors (Apache-2.0) reads the packages.
- The format and its rules follow the mapping generator of UE4SS (MIT), a port of OutTheShade's UnrealMappingsDumper.
- Phantom Blade Zero and its files belong to S-GAME. The file holds only the names and layouts of the game's types.

