EbxAssetEntry

Overview

The EbxAssetEntry class represents entity assets in the Frostbite engine. EBX assets are the primary data format for game entities, containing blueprints, levels, and gameplay data.

Class Definition

public class EbxAssetEntry : AssetEntry
{
    public Guid Guid;
    public List<Guid> DependentAssets;
    public override string AssetType => "ebx";
}

Location: FrostySdk/Managers/AssetManager.cs:353

Properties

Guid

Unique identifier for the EBX asset. Used for cross-referencing and dependency tracking.

DependentAssets

List<Guid>

List of asset GUIDs that this EBX asset depends on. Represents import references.

AssetType

string

Returns "ebx" to identify this as an entity asset entry.

Inherited Properties

Show Base AssetEntry Properties

Name

string

Full path name of the asset (e.g., "characters/hero/mesh")

Type

string

Type name of the root object (e.g., "MeshAsset", "BlueprintBundle")

Filename

string

Asset filename extracted from the full path

Path

string

Directory path portion of the asset name

DisplayName

string

Filename with asterisk suffix if dirty (modified but not saved)

Sha1

SHA-1 hash of the asset data

BaseSha1

Sha1

Base SHA-1 for patched assets

Size

long

Compressed size of the asset in bytes

OriginalSize

long

Uncompressed size of the asset in bytes

IsInline

bool

True if asset data is embedded inline in the bundle

Location

AssetDataLocation

Storage location: Cas, SuperBundle, Cache, or CasNonIndexed

Bundles

List<int>

List of bundle indices containing this asset

IsAdded

bool

True if this asset was added via modding (not in base game)

IsModified

bool

True if this asset or any linked asset is modified

IsDirectlyModified

bool

True if only this asset is modified (not through linked assets)

HasModifiedData

bool

True if the asset has modified data in memory

IsDirty

bool

True if this asset has unsaved changes

LinkedAssets

List<AssetEntry>

Other assets linked to this one (resources, chunks)

ModifiedEntry

ModifiedAssetEntry

Contains modified asset data if the asset has been changed

Methods

ContainsDependency

public bool ContainsDependency(Guid guid)

Checks if this EBX asset depends on another asset.

guid

Guid

required

GUID of the asset to check for dependency

return

bool

True if the specified GUID is in the dependency list

EnumerateDependencies

public IEnumerable<Guid> EnumerateDependencies()

Iterates through all asset dependencies. Returns modified dependencies if the asset has been modified.

return

IEnumerable<Guid>

Enumerable collection of dependent asset GUIDs

Inherited Methods

Show Base AssetEntry Methods

LinkAsset

public void LinkAsset(AssetEntry assetToLink)

Links another asset (resource or chunk) to this EBX asset.

assetToLink

AssetEntry

required

Asset to link (typically ResAssetEntry or ChunkAssetEntry)

AddToBundle

public virtual bool AddToBundle(int bid)

Adds this asset to the specified bundle.

bid

int

required

Bundle index to add the asset to

return

bool

True if successfully added, false if already in bundle

AddToBundles

public bool AddToBundles(IEnumerable<int> bundles)

Adds this asset to multiple bundles.

bundles

IEnumerable<int>

required

Collection of bundle indices

return

bool

True if added to any bundle

IsInBundle

public bool IsInBundle(int bid)

Checks if the asset is in the specified bundle.

bid

int

required

Bundle index to check

return

bool

True if asset is in the bundle

EnumerateBundles

public IEnumerable<int> EnumerateBundles(bool addedOnly = false)

Iterates through all bundles containing this asset.

addedOnly

bool

default:"false"

If true, only returns bundles added via modding

return

IEnumerable<int>

Enumerable collection of bundle indices

Usage Examples

Reading an EBX Asset

EbxAssetEntry entry = assetManager.GetEbxEntry("characters/hero/mesh");
if (entry != null)
{
    Console.WriteLine($"Type: {entry.Type}");
    Console.WriteLine($"GUID: {entry.Guid}");
    Console.WriteLine($"Dependencies: {entry.DependentAssets.Count}");
}

Checking Dependencies

Guid targetGuid = /* ... */;
if (entry.ContainsDependency(targetGuid))
{
    Console.WriteLine("Asset depends on target");
}

// Enumerate all dependencies
foreach (Guid depGuid in entry.EnumerateDependencies())
{
    var depEntry = assetManager.GetEbxEntry(depGuid);
    Console.WriteLine($"Depends on: {depEntry?.Name}");
}

Linking Resources

EbxAssetEntry ebx = assetManager.GetEbxEntry("textures/ui/icon");
ResAssetEntry res = assetManager.GetResEntry("textures/ui/icon");

// Link the resource to the EBX
ebx.LinkAsset(res);

EBX-Specific Types

EBX assets use specialized reference types for linking:

PointerRef

References to other EBX objects (internal or external).

public struct PointerRef
{
    public EbxImportReference External;  // External asset reference
    public object Internal;              // Internal object reference
    public PointerRefType Type;          // Internal, External, or Null
}

ResourceRef

References to resource assets by resource ID.

public struct ResourceRef
{
    public ulong resourceId;  // Resource identifier
}

TypeRef

References to type definitions.

public class TypeRef
{
    public string Name;  // Type name
    public Guid Guid;    // Type GUID
}

FileRef

References to external files.

public struct FileRef
{
    public string fileName;  // File path
}

ResAssetEntry - Resource assets linked to EBX
ChunkAssetEntry - Chunk assets for texture/mesh data
BundleEntry - Bundle containers
AssetManager - Asset management operations

Core APIs

Asset Types

Plugin APIs

Data Structures

Overview

Class Definition

Properties

Inherited Properties

Methods

ContainsDependency

EnumerateDependencies

Inherited Methods

LinkAsset

AddToBundle

AddToBundles

IsInBundle

EnumerateBundles

Usage Examples

Reading an EBX Asset

Checking Dependencies

Linking Resources

EBX-Specific Types

PointerRef

ResourceRef

TypeRef

FileRef

Build docs developers (and LLMs) love

Core APIs

Asset Types

Plugin APIs

Data Structures

​Overview

​Class Definition

​Properties

​Inherited Properties

​Methods

​ContainsDependency

​EnumerateDependencies

​Inherited Methods

​LinkAsset

​AddToBundle

​AddToBundles

​IsInBundle

​EnumerateBundles

​Usage Examples

​Reading an EBX Asset

​Checking Dependencies

​Linking Resources

​EBX-Specific Types

​PointerRef

​ResourceRef

​TypeRef

​FileRef

​Related Types

Build docs developers (and LLMs) love

Overview

Class Definition

Properties

Inherited Properties

Methods

ContainsDependency

EnumerateDependencies

Inherited Methods

LinkAsset

AddToBundle

AddToBundles

IsInBundle

EnumerateBundles

Usage Examples

Reading an EBX Asset

Checking Dependencies

Linking Resources

EBX-Specific Types

PointerRef

ResourceRef

TypeRef

FileRef

Related Types