Format:Unreal package (uasset)
| Magic | C1 83 2A 9E (uint32 0x9E2A83C1) |
|---|---|
| Extensions | .uasset, .umap, .uexp, .ubulk, .uptnl |
| Endianness | little endian (swapped tag C1832A9E marks a big-endian file) |
| On this wiki | Facts · Code · Notes · Topics |
Classic Unreal package files (.uasset/.umap with .uexp and .ubulk): begin with the tag C1 83 2A 9E, a negative legacy version (-7 to -9), the UE4 and UE5 object versions, licensee version and custom versions, then tables of names, imports and exports. The object versions identify the engine release.
Overview
A cooked asset is split into .uasset (summary, name table, import and export tables), .uexp (export data) and optional .ubulk/.uptnl (bulk data). In pak files they are separate entries (Format:Unreal Engine pak file); in IoStore containers they are merged into Zen packages (Format:Unreal IoStore).
Summary (FPackageFileSummary) start
From CUE4Parse UE4/Objects/UObject/FPackageFileSummary.cs: uint32 tag 0x9E2A83C1 (0xC1832A9E means swapped byte order), int32 LegacyFileVersion (negative: -2 enum custom versions, -3 GUID custom versions, -4 no UE3 version, -5/-6 custom version optimisation, -7 no texture allocations, -8 UE5 version added, -9 early-exit rule), int32 UE3 version (absent when -4), int32 FileVersionUE4, int32 FileVersionUE5 (only when legacy version is -8 or lower), int32 licensee version, custom version container (GUID + int32 per entry), then total header size, folder name, package flags, name count/offset, export and import counts and offsets, GUIDs, generations, saved-by engine version, compression flags and so on. Unversioned packages carry no version numbers and need the right version supplied by the reader.
Identifying the engine version
CUE4Parse maps engine releases to default object versions (EGame.cs, GetVersion). UE4 FileVersionUE4 by release: 4.0 342, 4.1 352, 4.2 363, 4.3 382, 4.4 385, 4.5 401, 4.6 413, 4.7 434, 4.8 451, 4.9 and 4.10 482, 4.11 498, 4.12 504, 4.13 505, 4.14 508, 4.15 510, 4.16 and 4.17 513, 4.18 514, 4.19 and 4.20 516, 4.21 to 4.23 517, 4.24 and 4.25 518, 4.26 and 4.27 522. UE5 keeps UE4 version 522 and adds FileVersionUE5: 5.0 1004 (some early 5.0 builds 1002), 5.1 1008, 5.2 and 5.3 1009, 5.4 1012, 5.5 1013, 5.6 1017. These are CUE4Parse defaults, one value per release range: the real version of a package is the one in its summary, and a game may use a custom engine fork. Use the numbers to pick the nearest release, not to prove the engine version.
Full enums: Fact:Unreal package (uasset)/enum/UE5 object versions (1000 to 1018, from CUE4Parse ObjectVersion.cs) and Fact:Unreal package (uasset)/enum/UE4 object version milestones (the UE4 enum is declared in order after 108 with a few explicit numbers, so values were computed by counting; 522 matches the known final value). Handy thresholds when parsing: 214 is the oldest loadable package, 336 is ENGINE_VERSION_OBJECT, 400 CASE_PRESERVING_FNAME, 504 NAME_HASHES_SERIALIZED, 507 PRELOAD_DEPENDENCIES_IN_COOKED_EXPORTS, 516 ADDED_PACKAGE_SUMMARY_LOCALIZATION_ID (Unverified: the exact serialization each one gates is inferred from its name and comment, not read in the summary code). From UE5 1004 core math types are doubles; from 1012 property tags carry the complete type name tree (affects every tagged-property reader). A cooked UE5 package inside an IoStore carries these numbers in its Zen summary instead (Format:Unreal IoStore).
Related
The tag also appears at the end of FPackageTrailer (payload trailer) files. Property data inside exports is tagged-property serialized or, for unversioned packages, a bitmask against a usmap mappings file (CUE4Parse reads .usmap). See Library:Unreal Engine.
Code & repositories
- https://github.com/FabianFG/CUE4Parse @
7353666098ece8ed8799fe467a33e7f68b11d688· license: Apache-2.0
C# parser of Unreal Engine 4/5 archives and assets (basis of FModel). Useful without running: UE4/Pak/Objects/FPakInfo.cs, UE4/IO/Objects/FIoStoreTocHeader.cs, FIoChunkId.cs, UE4/Objects/UObject/FPackageFileSummary.cs, UE4/Versions/EGame.cs.
Tested on: source read, not run: source read, not run: read the pak footer, utoc header and package summary code; not built · checked 2026-10-18; last activity 2026-10-17; Note: the latest release ships binaries; the wiki links only the source, never the binaries