Assets
Assets are individual 3D components (heads, hair, clothing) that make up an avatar. Each asset has a unique asset_id.
Asset Entity Properties
| Property | Type | Status | Description |
|---|---|---|---|
gender | "male" | "female" | Required | Determines the base skeleton and model set. |
faceShape | asset_id | Required | ID of the base head mesh. |
eyeShape | asset_id | Required | ID of the eye socket and surrounding structure. |
noseShape | asset_id | Required | ID of the nose structure. |
lipShape | asset_id | Required | ID of the mouth and lip structure. |
skinColor | index | Optional | Index mapped to the skin color palette (0-indexed). |
hairStyle | asset_id | Optional | ID of the hair 3D model. |
hairColor | index | Optional | Index mapped to the hair color palette. |
eyebrowStyle | asset_id | Optional | ID of the eyebrow mesh. |
eyebrowColor | index | Optional | Index mapped to the eyebrow color palette (usually matches hair). |
beardStyle | asset_id | Optional | ID of the facial hair model. |
beardColor | index | Optional | Index mapped to the beard color palette. |
eyeColor | asset_id | Optional | ID of the iris/eye color asset. |
shirt | asset_id | Optional | ID of the upper-body clothing item. In assetData.json, refer to shirt_male or shirt_female. |
outfit | asset_id | Optional | ID of the full-body outfit (overrides shirt if present). In assetData.json, refer to outfitmale or outfitfemale. |
glasses | asset_id | Optional | ID of the eyewear accessory. |
faceMask | asset_id | Optional | ID of the face mask or covering accessory. |
faceWear | asset_id | Optional | ID of face-specific accessories (piercings, etc.). |
headWear | asset_id | Optional | ID of head accessories (hats, helmets, etc.). |
bottom | asset_id | Optional | ID of the lower-body clothing item (pants, shorts, etc.). |
footWear | asset_id | Optional | ID of the footwear items (shoes, boots, etc.). |
top | asset_id | Optional | ID of the outer-layer or additional upper-body clothing item (jackets, etc.). |
For a complete list of available assets and their IDs, refer to the assetData.json bundle provided with your integration package, or browse the Asset Library section.