FMT.Models.Assets 2026.13.2

FMT.Models.Assets

FMT.Models.Assets provides the shared Frostbite asset models used by Frostbite Modding Tool (FMT) and its external plugins. It represents the assets and metadata discovered by an asset manager; parsing game files, loading asset data, and writing mods are handled by the consuming FMT services and plugins.

Contents

• Core asset-entry model: AssetEntry, including asset names, SHA-1 values, sizes, data locations, bundle membership, linked assets, and modification state.
• Typed asset entries: EbxAssetEntry, ResAssetEntry, and ChunkAssetEntry for EBX, resource, and chunk assets.
• Bundle and catalog metadata: bundle entries, superbundles, catalogs, CAT entries, and data-location information.
• EBX in-memory model: EbxAsset tracks EBX objects, dependencies, reference counts, and supports rebuilding references with Update().
• Additional resource models, including morph-blend resources and BIG-file entries.

The models implement the contracts defined by FMT.PluginInterfaces, so plugins can work with a consistent view of game assets without depending on a specific asset manager implementation.

Installation

Install the package from NuGet:

dotnet add package FMT.Models.Assets

The package targets .NET 10.0. It brings in the asset-model dependencies needed by FMT, including FMT.Ebx; plugin projects will normally also reference FMT.PluginInterfaces for the related interfaces and services.

Usage

Use the typed entries when a plugin needs to inspect or describe assets supplied by FMT:

using FMT.Models.Assets.AssetEntry.Entries;

var entry = new EbxAssetEntry
{
    Id = ebxGuid,
    Name = "content/example_asset",
    Sha1 = assetSha1
};

entry.AddBundle(bundleId);

Use EbxAsset when working with an already-deserialized EBX object graph. After changing its objects or references, call Update() to recalculate dependencies and reference counts before it is saved by the host tooling.

Scope

This package defines data models only. To enumerate game assets, retrieve their bytes, deserialize or serialize EBX data, or create mod output, use the appropriate FMT asset manager, compiler, or plugin APIs.

Project

FMT is developed by FMTDev. Releases are available at github.com/FMTDev/FMT.Releases.