Crate uasset

  

The Rust uasset Library

uasset is a pure Rust implementation of the Unreal Engine .uasset file format. It gives you direct access to fields & values in the uasset format, and is intended to allow you to build tools outside of the Unreal Editor to work with uassets.

Usage

To use uasset, first add this to your Cargo.toml:

[dependencies]
uasset = "^0.2"

Then import AssetHeader into your program:

use uasset::AssetHeader;

Finally, parse a file using AssetHeader::new.

Example

let file = File::open(path)?;
let package = AssetHeader::new(&file)?;
for import in package.package_import_iter() {
    println!("Import: {}", import);
}

Crate features

• commandline-tool - Allows the building of a uasset command line tool that can be used to inspect specific assets.

Structs

• Archive
• AssetHeader
  A table of contents for a uasset loaded from disk, containing all the shared package summary information. This roughly maps to FPackageFileSummary in Engine/Source/Runtime/CoreUObject/Public/UObject/PackageFileSummary.h, except we load some of the indirectly referenced data (i.e. names, imports, exports).
• ImportIterator
  Iterator over the imported packages in a given AssetHeader
• InvalidNameIndexError
  Error when attempting to resolve an index
• NameReference
  A reference to a name in the AssetHeader::names name table. You can use AssetHeader::resolve_name to get a human-readable string from a NameReference. It only makes sense to compare NameReferences from the same AssetHeader.
• ObjectImport
  A reference to an object in another package. Typically accessed through AssetHeader::package_import_iter, but you can also manually resolve the NameReferences. (C++ name: FObjectImport)
• ThumbnailInfo
  Represents the metadata about a thumbnail for an asset, stored behind [AssetHeader::thumbnail_table_offsets] (see ThumbnailTools::LoadThumbnailsFromPackageInternal)

Enums

• CustomVersionSerializationFormat
  The format of an asset’s custom versions, derived from legacy_version (see FCustomVersionContainer::Serialize)
• Error
  Errors from parsing an asset
• ObjectImportOuter
  A reference to either an import or an export in the asset.
• ObjectVersion
  Maps to EUnrealEngineObjectUE4Version in Engine/Source/Runtime/Core/Public/UObject/ObjectVersion.h – this tracks the various versions to the core serialized object format.
• ObjectVersionUE5
  Maps to EUnrealEngineObjectUE5Version in Engine/Source/Runtime/Core/Public/UObject/ObjectVersion.h – this tracks the various versions to the core serialized object format.
• PackageFlags
  Maps to EPackageFlags in Engine/Source/Runtime/CoreUObject/Public/UObject/ObjectMacros.h. The UnusedN entries exist for completeness, presumably those entries were used in the past.

Type Aliases

• Result
  Results from parsing a uasset