Reference Types

public struct ResourceRef
{
    private readonly ulong resourceId;
}

var resourceRef = new ResourceRef(0x123456789ABCDEF0);

// ulong to ResourceRef
ResourceRef resRef = 0x123456789ABCDEF0;

// ResourceRef to ulong
ulong id = resRef;

public override bool Equals(object obj)

public override int GetHashCode()

public override string ToString()

var resRef = new ResourceRef(0x123456789ABCDEF0);
Console.WriteLine(resRef.ToString()); // "123456789ABCDEF0"

public static bool operator ==(ResourceRef a, ResourceRef b)
public static bool operator !=(ResourceRef a, ResourceRef b)

// Create resource reference
ResourceRef textureRef = 0x1A2B3C4D5E6F7890;

// Check if valid
if (textureRef != ResourceRef.Zero)
{
    var resource = resourceManager.GetResource(textureRef);
}

// Convert to string for logging
Console.WriteLine($"Resource ID: {textureRef}");

public struct FileRef
{
    private string fileName;
}

var fileRef = new FileRef("path/to/asset.bin");

// string to FileRef
FileRef fileRef = "weapons/assault_rifle.mesh";

// FileRef to string
string path = fileRef;

public override string ToString()

var fileRef = new FileRef("vehicles/tank.mesh");
Console.WriteLine(fileRef.ToString()); // "FileRef 'vehicles/tank.mesh'"

// Assign file reference to property
FileRef meshFile = "characters/soldier.mesh";
meshComponent.SetPropertyValue("MeshRef", meshFile);

// Read file reference from property
FileRef soundFile = soundComponent.GetPropertyValue<FileRef>("SoundFile");
Console.WriteLine($"Sound file: {soundFile}");

public class TypeRef
{
    public string Name { get; }
    public Guid Guid { get; }
    private Guid typeGuid;
    private readonly string typeName;
}

var typeRef = new TypeRef(); // Empty type

var typeRef = new TypeRef("MeshAsset");

var typeGuid = new Guid("A1B2C3D4-E5F6-7890-1234-56789ABCDEF0");
var typeRef = new TypeRef(typeGuid);
// Name is automatically looked up from TypeLibrary

// string to TypeRef
TypeRef typeRef = "SoundAsset";

// TypeRef to string (returns GUID string if GUID is set, otherwise name)
string typeStr = typeRef;

// Guid to TypeRef
TypeRef typeRef2 = typeGuid;

public bool IsNull()

var emptyRef = new TypeRef();
if (emptyRef.IsNull())
{
    Console.WriteLine("Type reference is empty");
}

public override string ToString()

var typeRef = new TypeRef("MeshAsset");
Console.WriteLine(typeRef.ToString()); // "TypeRef 'MeshAsset'"

var nullRef = new TypeRef();
Console.WriteLine(nullRef.ToString()); // "TypeRef '(null)'"

// Filter assets by type
TypeRef meshType = "MeshAsset";
var meshAssets = assetManager.EnumerateEbx()
    .Where(entry => entry.Type == meshType.Name);

var assetType = new TypeRef(asset.RootObject.GetType().Name);
if (!assetType.IsNull())
{
    Console.WriteLine($"Asset is of type: {assetType.Name}");
}

// Look up type by GUID
var typeGuid = new Guid("...");
var typeRef = new TypeRef(typeGuid);
Console.WriteLine($"Type GUID {typeGuid} maps to {typeRef.Name}");

// Convert between name and GUID
TypeRef namedType = "TextureAsset";
if (namedType.Guid != Guid.Empty)
{
    Console.WriteLine($"Type GUID: {namedType.Guid}");
}