BeyondImmersion.Bannou.AssetLoader.Server 2.0.0

Bannou Asset Loader Server

Mesh-based asset source for game servers and backend services.

Overview

This package provides BannouMeshAssetSource, an IAssetSource implementation that uses the generated IAssetClient for URL resolution via the service mesh.

Important: Most server use cases don't need this package. If you only need:

• Asset metadata queries
• Download URLs to pass to clients/workers
• Bundle validation

Then use the generated IAssetClient directly (see "Direct API Access" below).

Use this package when your server needs to actually load bundle contents into memory.

Installation

dotnet add package BeyondImmersion.Bannou.AssetLoader.Server

When to Use This Package

Direct API Access (Most Common)

For metadata and URL queries, use the generated client directly:

public class AssetQueryService
{
    private readonly IAssetClient _assetClient;

    public AssetQueryService(IAssetClient assetClient)
    {
        _assetClient = assetClient;
    }

    public async Task<AssetWithDownloadUrl> GetAssetInfoAsync(string assetId)
    {
        var request = new GetAssetRequest { AssetId = assetId, Version = "latest" };
        return await _assetClient.GetAssetAsync(request);
    }

    public async Task<string> GetBundleUrlAsync(string bundleId)
    {
        var request = new GetBundleRequest { BundleId = bundleId };
        var response = await _assetClient.GetBundleAsync(request);
        return response.DownloadUrl;  // Pre-signed URL
    }
}

Full Asset Loading (When Needed)

When your server needs actual asset bytes:

With Dependency Injection

// Service registration
services.AddSingleton<IAssetSource>(sp =>
{
    var assetClient = sp.GetRequiredService<IAssetClient>();
    var logger = sp.GetService<ILogger<BannouMeshAssetSource>>();
    return new BannouMeshAssetSource(assetClient, Realm.Arcadia, logger);
});

// Optional: memory cache for containers (or FileAssetCache for VMs)
services.AddSingleton<IAssetCache>(sp =>
    new MemoryAssetCache(maxSizeBytes: 256 * 1024 * 1024));

services.AddSingleton<AssetLoader>();

Direct Usage

using BeyondImmersion.Bannou.AssetLoader;
using BeyondImmersion.Bannou.AssetLoader.Server;
using BeyondImmersion.Bannou.AssetLoader.Cache;

// Create source from injected client
var source = new BannouMeshAssetSource(assetClient, Realm.Arcadia);

// Optional cache
var cache = new MemoryAssetCache(maxSizeBytes: 256 * 1024 * 1024);

// Create loader
var loader = new AssetLoader(source, cache);

// Load assets
var result = await loader.EnsureAssetsAvailableAsync(new[]
{
    "polygon-adventure/level-1",
    "polygon-adventure/enemies"
});

// Get raw bytes
var levelData = await loader.GetAssetBytesAsync("polygon-adventure/level-1");

Caching Recommendations

Features

Comparison with Client SDK

Further Reading

• Asset SDK Guide - Comprehensive documentation
• Asset Loader Core - Engine-agnostic core SDK
• Asset Loader Client - Game client SDK

License

MIT