Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.
AvatarSettingsAppearanceMode
Used by AppearanceMode to control whether players retain their own avatar body parts or the experience overrides them with custom assets. Defaults to AvatarSettingsAppearanceMode.PlayerChoice.
When set to AvatarSettingsAppearanceMode.CustomParts, individual body parts (head, face, torso, arms, legs, eyebrows, eyelashes, mood) can each be independently enabled and assigned a custom asset ID. When set to AvatarSettingsAppearanceMode.CustomBody, the entire body is replaced as a single unit using CustomBodyType and CustomBodyBundleId.
Items
| Name | Value | Description |
|---|---|---|
| PlayerChoice | 0 | Players keep their own avatar body parts; the experience does not override any body-part assets. |
| CustomParts | 1 | The experience overrides individual body parts (head, face, torso, arms, legs) using per-part asset IDs and enablement settings on AvatarBodyRules. |
| CustomBody | 2 | The experience replaces the avatar's entire body as a single unit, using CustomBodyType and CustomBodyBundleId. |
PlayerChoice
Players keep their own avatar body parts; the experience does not override any body-part assets.
| Field | Value |
|---|---|
| value | 0 |
CustomParts
The experience overrides individual body parts (head, face, torso, arms, legs) using per-part asset IDs and enablement settings on AvatarBodyRules.
| Field | Value |
|---|---|
| value | 1 |
CustomBody
The experience replaces the avatar's entire body as a single unit, using CustomBodyType and CustomBodyBundleId.
| Field | Value |
|---|---|
| value | 2 |