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
| Name | Value | Description |
|---|---|---|
| Default | 0 | 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. |
| SingleCollider | 1 | 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. |
| Legacy | 2 | Collision 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.
| Field | Value |
|---|---|
| value | 0 |
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.
| Field | Value |
|---|---|
| value | 1 |
Legacy
Collision geometry is determined by LegacyCollisionMode, which selects either inner-box colliders or R6-style colliders.
| Field | Value |
|---|---|
| value | 2 |