2 min read

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

NameValueDescription
PlayerChoice0Players keep their own avatar body parts; the experience does not override any body-part assets.
CustomParts1The experience overrides individual body parts (head, face, torso, arms, legs) using per-part asset IDs and enablement settings on AvatarBodyRules.
CustomBody2The 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.

FieldValue
value0

CustomParts

The experience overrides individual body parts (head, face, torso, arms, legs) using per-part asset IDs and enablement settings on AvatarBodyRules.

FieldValue
value1

CustomBody

The experience replaces the avatar's entire body as a single unit, using CustomBodyType and CustomBodyBundleId.

FieldValue
value2