UAsset

Namespace: UAssetAPI

Represents an Unreal Engine asset.

public class UAsset : UnrealPackage, UAssetAPI.IO.INameMap

Inheritance Object → UnrealPackage → UAsset
Implements INameMap

The lower 16 bits stores the UE3 engine version, while the upper 16 bits stores the UE4/licensee version. For newer packages this is -7. VersionDescription-2indicates presence of enum-based custom versions-3indicates guid-based custom versions-4indicates removal of the UE3 version. Packages saved with this ID cannot be loaded in older engine versions-5indicates the replacement of writing out the "UE3 version" so older versions of engine can gracefully fail to open newer packages-6indicates optimizations to how custom versions are being serialized-7indicates the texture allocation info has been removed from the summary-8indicates that the UE5 version has been added to the summary

DataResourceVersion

The version to use for serializing data resources.

public EObjectDataResourceVersion DataResourceVersion;

DataResources

List of serialized UObject binary/bulk data resources.

public List<FObjectDataResource> DataResources;

UsesEventDrivenLoader

Whether or not this asset is loaded with the Event Driven Loader.

public bool UsesEventDrivenLoader;

WillSerializeNameHashes

Whether or not this asset serializes hashes in the name map. If null, this will be automatically determined based on the object version.

public Nullable<bool> WillSerializeNameHashes;

Imports

Map of object imports. UAssetAPI used to call these "links."

public List<Import> Imports;

DependsMap

List of dependency lists for each export.

public List<Int32[]> DependsMap;

SoftPackageReferenceList

List of packages that are soft referenced by this package.

public List<FString> SoftPackageReferenceList;

AssetRegistryData

Uncertain

public Byte[] AssetRegistryData;

BulkData

Any bulk data that is not stored in the export map.

public Byte[] BulkData;

ValorantGarbageData

Some garbage data that appears to be present in certain games (e.g. Valorant)

public Byte[] ValorantGarbageData;

SeaOfThievesGarbageData

Some garbage data that appears to be present in certain games (e.g. Sea of Thieves) null = not present empty array = present, but serialize as offset = 0, length = 0

public Byte[] SeaOfThievesGarbageData;

Generations

Data about previous versions of this package.

public List<FGenerationInfo> Generations;

PackageGuid

Current ID for this package. Effectively unused.

public Guid PackageGuid;

PersistentGuid

Current persistent ID for this package.

public Guid PersistentGuid;

RecordedEngineVersion

Engine version this package was saved with. This may differ from CompatibleWithEngineVersion for assets saved with a hotfix release.

public FEngineVersion RecordedEngineVersion;

RecordedCompatibleWithEngineVersion

Engine version this package is compatible with. Assets saved by Hotfix releases and engine versions that maintain binary compatibility will have a CompatibleWithEngineVersion.Patch that matches the original release (as opposed to SavedByEngineVersion which will have a patch version of the new release).

public FEngineVersion RecordedCompatibleWithEngineVersion;

ChunkIDs

Streaming install ChunkIDs

public Int32[] ChunkIDs;

PackageSource

Value that is used by the Unreal Engine to determine if the package was saved by Epic, a licensee, modder, etc.

public uint PackageSource;

FolderName

The Generic Browser folder name that this package lives in. Usually "None" in cooked assets.

public FString FolderName;

OverrideNameMapHashes

A map of name map entries to hashes to use when serializing instead of the default engine hash algorithm. Useful when external programs improperly specify name map hashes and binary equality must be maintained.

public Dictionary<FString, uint> OverrideNameMapHashes;

LocalizationId

Localization ID of this package

public FString LocalizationId;

UASSET_MAGIC

Magic number for the .uasset format

public static uint UASSET_MAGIC;

ACE7_MAGIC

Magic number for Ace Combat 7 encrypted .uasset format

public static uint ACE7_MAGIC;

Info

Agent string to provide context in serialized JSON.

public string Info;

FilePath

The path of the file on disk that this asset represents. This does not need to be specified for regular parsing.

public string FilePath;

Mappings

The corresponding mapping data for the game that this asset is from. Optional unless unversioned properties are present.

public Usmap Mappings;

CustomSerializationFlags

List of custom serialization flags, used to override certain optional behavior in how UAssetAPI serializes assets.

public CustomSerializationFlags CustomSerializationFlags;

UseSeparateBulkDataFiles

Should the asset be split into separate .uasset, .uexp, and .ubulk files, as opposed to one single .uasset file?

public bool UseSeparateBulkDataFiles;

IsUnversioned

Should this asset not serialize its engine and custom versions?

public bool IsUnversioned;

FileVersionLicenseeUE

The licensee file version. Used by some games to add their own Engine-level versioning.

public int FileVersionLicenseeUE;

ObjectVersion

The object version of UE4 that will be used to parse this asset.

public ObjectVersion ObjectVersion;

ObjectVersionUE5

The object version of UE5 that will be used to parse this asset. Set to ObjectVersionUE5.UNKNOWN for UE4 games.

public ObjectVersionUE5 ObjectVersionUE5;

CustomVersionContainer

All the custom versions stored in the archive.

public List<CustomVersion> CustomVersionContainer;

GatherableTextData

Map of the gatherable text data.

public List<FGatherableTextData> GatherableTextData;

Exports

Map of object exports. UAssetAPI used to call these "categories."

public List<Export> Exports;

SearchableNames

List of Searchable Names, by object containing them. Sorted to keep order consistent.

public SortedDictionary<FPackageIndex, List<FName>> SearchableNames;

Thumbnails

Map of object full names to the thumbnails

public Dictionary<string, FObjectThumbnail> Thumbnails;

WorldTileInfo

Tile information used by WorldComposition. Defines properties necessary for tile positioning in the world.

public FWorldTileInfo WorldTileInfo;

MapStructTypeOverride

In MapProperties that have StructProperties as their keys or values, there is no universal, context-free way to determine the type of the struct.

To that end, this dictionary maps MapProperty names to the type of the structs within them (tuple of key struct type and value struct type) if they are not None-terminated property lists.

public Dictionary<string, Tuple<FString, FString>> MapStructTypeOverride;

ArrayStructTypeOverride

IN ENGINE VERSIONS BEFORE ObjectVersion.VER_UE4_INNER_ARRAY_TAG_INFO:

In ArrayProperties that have StructProperties as their keys or values, there is no universal, context-free way to determine the type of the struct. To that end, this dictionary maps ArrayProperty names to the type of the structs within them.

public Dictionary<string, FString> ArrayStructTypeOverride;

Properties

PackageFlags

The flags for this package.

public EPackageFlags PackageFlags { get; set; }

Property Value

EPackageFlags

HasUnversionedProperties

Whether or not this asset uses unversioned properties.

public bool HasUnversionedProperties { get; }

Property Value

Boolean

IsFilterEditorOnly

Whether or not this asset has PKG_FilterEditorOnly flag.

public bool IsFilterEditorOnly { get; }

Property Value

Boolean

Constructors

UAsset(String, EngineVersion, Usmap, CustomSerializationFlags)

Reads an asset from disk and initializes a new instance of the UAsset class to store its data in memory.

public UAsset(string path, EngineVersion engineVersion, Usmap mappings, CustomSerializationFlags customSerializationFlags)

UAssetAPI Documentation