Genies SDK Avatar v2.8.2
Updated: March 2, 2026
Breaking Changes
- Updating to this version requires a clean import or else it will break projects. See the Update the SDK page for instructions.
What's New
- Avatar Customization APIs allow developers to modify avatars and create custom avatar editors.
- Equip and un-equip wearables, hair, makeup, and tattoos on a live Avatar.
- Read and set colors for hair, eyebrows, and eyelash categories using curated default presets and user-saved custom colors.
- Read and set colors for skin, eyes, facial hair, and makeup categories using curated default presets.
- Adjust facial and body feature sliders (nose shape, lip size, jaw, eye proportions, body stats, etc.) with per-stat control.
- Browse available inventory by category: default wearables, user-owned wearables, hair assets, facial features, makeup, and tattoos.
- Save the Avatar back to the user's profile on the server.
- Avatar Load APIs allows developers to load an Avatar from a JSON definition string or from a user's ID.
- Asset Pre-caching APIs allows developers to download and cache Avatar assets which reduces the visible load time for an Avatar appearing on the screen.
- Two new sample scenes located in the Sample Starter Scenes folder:
- Demo Mode scene loads a test Avatar without requiring the developer to create a Genies account or configure API credentials.
- Creating an Avatar Editor scene demonstrates how to build a custom Avatar Editor UI using the new Avatar Editor APIs.
What's Fixed
- Fixed an error when trying to save remotely with anonymous users.
Improvements
- Avatar load performance is significantly faster due to core system improvements, pre-cached assets, and reduced textures overhead.
LoadUserAvatarAsync()always fetches the latest definition from the server on each call. If you're loading the same user's avatar multiple times, the new pattern of fetching the definition once and reusing it via definition-based loading will perform better.- The Bootstrap Wizard has been improved with clearer directions and the sample scenes can now be imported with the click of a button.
Deprecations
The following methods are being deprecated and will be removed in a future release:
| Deprecated | Replacement |
|---|---|
| EquipOutfitAsync(avatar, wearableId) | EquipWearableByWearableIdAsync(avatar, wearableId) |
| UnEquipOutfitAsync(avatar, wearableId) | UnEquipWearableByWearableIdAsync(avatar, wearableId) |
| GetWearableAssetInfoListAsync() | GetDefaultWearablesByCategoryAsync() / GetUserWearablesByCategoryAsync() |
| GetUsersAssetsAsync() | GetUserWearablesByCategoryAsync() |
| SetSkinColorAsync(avatar, color) | SetColorAsync(avatar, CreateSkinColor(color)) |