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.

AvatarSettingsCollisionMode

Determines the collision geometry mode for avatars managed by AvatarCollisionRules. AvatarSettingsCollisionMode.Default uses each body part's native collision geometry. AvatarSettingsCollisionMode.SingleCollider replaces per-part collision with a single box collider welded to the HumanoidRootPart. AvatarSettingsCollisionMode.Legacy delegates to the LegacyCollisionMode setting.

Items

NameValueDescription
Default0Each body part uses its native collision geometry. The HumanoidRootPart, UpperTorso, and LowerTorso collide while other parts do not. This is the default value for CollisionMode.
SingleCollider1A single box-shaped collider part replaces all per-part collision. The collider is welded to the HumanoidRootPart and sized by SingleColliderSize (default 2, 3, 1). All other parts become non-collidable and massless.
Legacy2Collision geometry is determined by LegacyCollisionMode, which selects either inner-box colliders or R6-style colliders.

Default

Each body part uses its native collision geometry. The HumanoidRootPart, UpperTorso, and LowerTorso collide while other parts do not. This is the default value for CollisionMode.

FieldValue
value0

SingleCollider

A single box-shaped collider part replaces all per-part collision. The collider is welded to the HumanoidRootPart and sized by SingleColliderSize (default 2, 3, 1). All other parts become non-collidable and massless.

FieldValue
value1

Legacy

Collision geometry is determined by LegacyCollisionMode, which selects either inner-box colliders or R6-style colliders.

FieldValue
value2