Skip to main content

Genies Web SDK v0.1.27

Updated: April 15, 2026

What's New

  • Multi-Avatar Shader System: ShaderManager is now multi-avatar aware.
    • All avatars hold their shader materials simultaneously — no detach/reattach cache management needed.
    • Effects (toon, outline) can be enabled/disabled independently per avatar.
    • Shader lifecycle (attach, detach, texture sync, rebuild material swaps) is handled automatically by the SDK — consumers only call setActiveAvatar(avatarId) to select which avatar receives UI-driven changes.
  • Combinable Wearables: Ability to equip and unequip wearables.
    • handle.equipAsset({ id, version?, lod? }) — adds a wearable and rebuilds the avatar in place.
    • handle.unequipAsset(assetId) — removes a wearable and rebuilds.
  • NafAvatarHandle
    • Added userData — consumer-defined metadata bag (SDK never reads/writes it). Useful for display names, slot tracking, etc.
    • Added getEquippedAssets() — returns the current asset list.
    • status lifecycle: 'loading' | 'ready' | 'unloaded' with isReady / isUnloaded helpers.

Improvements

  • Progressive Loading Improvements
    • In-memory LOD cache tracking — skips redundant loads when assets are already cached.
    • Faster cache lookups for LOD resolution.