punkfuncgames/asset-module

AssetModule Reference

Package: com.punkfuncgames.asset | Define: PUNKFUNC_ASSET Location: Packages/com.punkfuncgames.asset/Runtime/PunkFuncGames.Asset/ Namespace: PunkFuncGames.Asset

IAssetService : IAsyncInitializable, IDisposable

Loading:

• UniTask<T> LoadAssetAsync<T>(string key, ct) — load by Addressable address (cached)
• UniTask<T> LoadAssetAsync<T>(AssetReference reference, ct) — load by AssetReference (cached by GUID)
• UniTask<IList<T>> LoadAssetsAsync<T>(string label, ct) — load all by label

Instantiation:

• UniTask<GameObject> InstantiateAsync(string key, Transform parent, ct)
• UniTask<GameObject> InstantiateAsync(AssetReference reference, Transform parent, ct)

Release:

• Release<T>(T asset) — release loaded asset
• ReleaseInstance(GameObject instance) — release instantiated object

Preloading:

• UniTask PreloadAssetsAsync(string label, IProgress<float> progress, ct) — download + preload by label

Cleanup:

• UniTask UnloadUnusedAssetsAsync() — Resources.UnloadUnusedAssets() + GC.Collect()

Implementation: AssetService

No dependencies. Caching via Dictionary<string, AsyncOperationHandle>.

• Cache keys: address string, GUID (for AssetReference), or "label:{label}"
• Instantiated objects tracked in separate dictionary for proper release
• Preload pipeline: GetDownloadSize → DownloadDependencies → LoadAssets
• Returns null on failure (error swallowing with Debug.LogError)
• Dispose releases all tracked handles and instances

Installer

AssetInstaller.Install(builder);
// Registers: AssetService (Singleton) as IAssetService

Usage Pattern

// Load asset by key
GameObject prefab = await _assetService.LoadAssetAsync<GameObject>("EnemyPrefab", ct);

// Load by AssetReference (from inspector)
Sprite sprite = await _assetService.LoadAssetAsync<Sprite>(spriteReference, ct);

// Instantiate
GameObject enemy = await _assetService.InstantiateAsync("EnemyPrefab", parent, ct);

// Release when done
_assetService.ReleaseInstance(enemy);
_assetService.Release(prefab);

// Preload with progress
Progress<float> progress = new Progress<float>(p => Debug.Log($"Loading: {p:P0}"));
await _assetService.PreloadAssetsAsync("GameplayAssets", progress, ct);