AssetManager API

Overview

The AssetManager class provides comprehensive functionality for enumerating, loading, and modifying game assets including EBX, resources, and chunks.

using FrostySdk.Managers;

AssetManager am = new AssetManager(fileSystem, resourceManager);
am.Initialize();

Constructor

constructor

Creates a new AssetManager instance

AssetManager am = new AssetManager(FileSystem fs, ResourceManager rm);

FileSystem

required

Initialized FileSystem instance

ResourceManager

required

Initialized ResourceManager instance

Initialization

void

Initializes the asset manager and loads all asset metadata

am.Initialize(additionalStartup: true);

bool

default:"true"

Perform additional initialization like EBX indexing

AssetManagerImportResult

default:"null"

Optional result object for tracking patch changes

Asset Retrieval

EBX Assets

EbxAssetEntry

Gets an EBX asset entry by name or GUID

// By name
EbxAssetEntry entry = am.GetEbxEntry("content/characters/player");

// By GUID
EbxAssetEntry entry = am.GetEbxEntry(guid);

string

Asset path (case-insensitive)

Guid

Asset GUID

EbxAsset

Loads and deserializes an EBX asset

EbxAsset asset = am.GetEbx(entry);
// Or
EbxAsset asset = am.GetEbx("content/characters/player");

EbxAssetEntry

Asset entry to load

bool

default:"false"

If true, returns original data ignoring modifications

T where T : EbxAsset

Loads an EBX asset as a specific type

MeshAsset mesh = am.GetEbxAs<MeshAsset>(entry);

Resource Assets

ResAssetEntry

Gets a resource entry by name or resource ID

// By name
ResAssetEntry entry = am.GetResEntry("textures/character_diffuse");

// By resource ID
ResAssetEntry entry = am.GetResEntry(resRid);

string

Resource name

ulong

Resource runtime ID

Stream

Gets the raw resource data stream

Stream resData = am.GetRes(resEntry);

T where T : Resource

Loads and deserializes a resource as a specific type

Texture texture = am.GetResAs<Texture>(entry);

ResAssetEntry

required

Resource entry to load

ModifiedResource

default:"null"

Optional modified resource data

Chunk Assets

ChunkAssetEntry

Gets a chunk entry by its GUID

ChunkAssetEntry entry = am.GetChunkEntry(chunkId);

Stream

Gets the raw chunk data stream

Stream chunkData = am.GetChunk(chunkEntry);

Asset Enumeration

Enumerate EBX

IEnumerable<EbxAssetEntry>

Enumerates EBX assets with optional filtering

// All EBX assets
foreach (EbxAssetEntry entry in am.EnumerateEbx())
{
    Console.WriteLine(entry.Name);
}

// Filter by type
foreach (EbxAssetEntry entry in am.EnumerateEbx("MeshAsset"))
{
    // Process mesh assets
}

// Modified assets only
foreach (EbxAssetEntry entry in am.EnumerateEbx("", modifiedOnly: true))
{
    // Process modified assets
}

string

default:""

Filter by asset type (supports inheritance)

bool

default:"false"

Only return modified assets

bool

default:"false"

Include indirectly modified linked assets

string

default:""

Filter by bundle path

Enumerate Resources

IEnumerable<ResAssetEntry>

Enumerates resource assets

// All resources
foreach (ResAssetEntry entry in am.EnumerateRes())
{
    Console.WriteLine($"{entry.Name} - {entry.Type}");
}

// Filter by resource type
foreach (ResAssetEntry entry in am.EnumerateRes((uint)ResourceType.Texture))
{
    // Process textures
}

uint

default:"0"

Filter by ResourceType (0 = all types)

bool

default:"false"

Only return modified resources

Enumerate Chunks

IEnumerable<ChunkAssetEntry>

Enumerates chunk assets

foreach (ChunkAssetEntry entry in am.EnumerateChunks())
{
    Console.WriteLine($"Chunk: {entry.Id}");
}

bool

default:"false"

Only return modified chunks

Enumerate Bundles

IEnumerable<BundleEntry>

Enumerates bundle entries

foreach (BundleEntry bundle in am.EnumerateBundles())
{
    Console.WriteLine($"Bundle: {bundle.Name} ({bundle.Type})");
}

// Filter by type
foreach (BundleEntry bundle in am.EnumerateBundles(BundleType.BlueprintBundle))
{
    // Process blueprint bundles
}

BundleType

default:"BundleType.None"

Filter by bundle type

bool

default:"false"

Only return modified bundles

Asset Modification

Modify EBX

void

Marks an EBX asset as modified with new data

EbxAsset asset = am.GetEbx(entry);
// Modify asset properties...
asset.RootObject.SetValue("SomeProperty", newValue);

// Save modification
am.ModifyEbx(entry.Name, asset);

string

required

Asset name

EbxAsset

required

Modified asset object

Modify Resource

void

Marks a resource as modified

// Modify by resource ID
am.ModifyRes(resRid, modifiedData, metaData);

// Modify by name
am.ModifyRes("textures/player_diffuse", modifiedData, metaData);

// Modify with Resource object
Texture texture = am.GetResAs<Texture>(entry);
// Modify texture...
am.ModifyRes(entry.ResRid, texture);

ulong

Resource runtime ID

string

Resource name

byte[]

Raw resource data

byte[]

default:"null"

Resource metadata

Resource

Resource object

Modify Chunk

bool

Modifies a chunk’s data

byte[] newChunkData = GetModifiedChunkData();
bool success = am.ModifyChunk(chunkId, newChunkData);

// For texture chunks
Texture texture = GetTexture();
am.ModifyChunk(chunkId, textureData, texture);

Guid

required

Chunk GUID

byte[]

required

New chunk data

Texture

default:"null"

Texture metadata for texture chunks

Adding Assets

Add EBX

EbxAssetEntry

Adds a new EBX asset to the manager

EbxAsset newAsset = CreateNewAsset();
EbxAssetEntry entry = am.AddEbx(
    "content/custom/myasset",
    newAsset,
    bundleId1, bundleId2
);

string

required

Asset name/path

EbxAsset

required

Asset object

params int[]

Bundle IDs to add asset to

Add Resource

ResAssetEntry

Adds a new resource to the manager

byte[] textureData = LoadTextureData();
byte[] metadata = CreateMetadata();

ResAssetEntry entry = am.AddRes(
    "textures/custom_texture",
    ResourceType.Texture,
    metadata,
    textureData,
    bundleId
);

string

required

Resource name

ResourceType

required

Resource type

byte[]

required

Resource metadata

byte[]

required

Resource data

params int[]

Bundle IDs

Add Chunk

Guid

Adds a new chunk and returns its GUID

byte[] chunkData = GetChunkData();
Guid chunkId = am.AddChunk(chunkData, bundles: bundleId);

// For textures
Texture texture = CreateTexture();
Guid texChunkId = am.AddChunk(textureData, texture: texture, bundles: bundleId);

byte[]

required

Chunk data

Guid?

default:"null"

Optional specific GUID to use

Texture

default:"null"

Texture metadata for texture chunks

params int[]

Bundle IDs

Asset Management

Revert Asset

void

Reverts modifications to an asset

am.RevertAsset(entry);

// Revert data only (keep bundle assignments)
am.RevertAsset(entry, dataOnly: true);

AssetEntry

required

Asset entry to revert

bool

default:"false"

Only revert data, not bundle assignments

bool

default:"true"

Suppress modification event

Reset All

void

Reverts all modifications across all assets

am.Reset();

Get Counts

uint

Gets the total number of modified assets

uint modCount = am.GetModifiedCount();
Console.WriteLine($"{modCount} assets modified");

uint

Gets count of EBX assets

// All EBX
uint total = am.GetEbxCount();

// Specific type
uint meshCount = am.GetEbxCount("MeshAsset");

Usage Example

using FrostySdk;
using FrostySdk.Managers;
using FrostySdk.IO;

// Initialize
FileSystem fs = new FileSystem(@"C:\Games\FIFA20");
fs.Initialize();

ResourceManager rm = new ResourceManager(fs);
rm.Initialize();

AssetManager am = new AssetManager(fs, rm);
am.Initialize();

// Find and modify an asset
EbxAssetEntry entry = am.GetEbxEntry("content/characters/player");
if (entry != null)
{
    EbxAsset asset = am.GetEbx(entry);
    
    // Modify asset
    dynamic obj = asset.RootObject;
    obj.Health = 100;
    
    // Save modification
    am.ModifyEbx(entry.Name, asset);
    
    Console.WriteLine($"Modified: {entry.Name}");
}

// Enumerate all modified assets
foreach (EbxAssetEntry modified in am.EnumerateEbx("", modifiedOnly: true))
{
    Console.WriteLine($"Modified: {modified.Name}");
}

Console.WriteLine($"Total modifications: {am.GetModifiedCount()}");

Core APIs

Asset Types

Plugin APIs

Data Structures

Overview

Constructor

Initialization

Asset Retrieval

EBX Assets

Resource Assets

Chunk Assets

Asset Enumeration

Enumerate EBX

Enumerate Resources

Enumerate Chunks

Enumerate Bundles

Asset Modification

Modify EBX

Modify Resource

Modify Chunk

Adding Assets

Add EBX

Add Resource

Add Chunk

Asset Management

Revert Asset

Reset All

Get Counts

Usage Example

See Also

​Overview

​Constructor

​Initialization

​Asset Retrieval

​EBX Assets

​Resource Assets

​Chunk Assets

​Asset Enumeration

​Enumerate EBX

​Enumerate Resources

​Enumerate Chunks

​Enumerate Bundles

​Asset Modification

​Modify EBX

​Modify Resource

​Modify Chunk

​Adding Assets

​Add EBX

​Add Resource

​Add Chunk

​Asset Management

​Revert Asset

​Reset All

​Get Counts

​Usage Example

​See Also

Overview

Constructor

Initialization

Asset Retrieval

EBX Assets

Resource Assets

Chunk Assets

Asset Enumeration

Enumerate EBX

Enumerate Resources

Enumerate Chunks

Enumerate Bundles

Asset Modification

Modify EBX

Modify Resource

Modify Chunk

Adding Assets

Add EBX

Add Resource

Add Chunk

Asset Management

Revert Asset

Reset All

Get Counts

Usage Example

See Also