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.

CollisionFidelity

Determines behavior of the collision hitbox for MeshPart and PartOperation instances. See here for a visual representation of the various options.

Items

NameValueDescription
Default0Collision model uses a voxel-based convex-hull decomposition that is relatively fast but may not be highly accurate, especially for holes, doorways, and cavities in general.
Hull1Collision model uses the convex hull of the visual mesh.
Box2Collision model uses a bounding box that encompasses the visual mesh.
PreciseConvexDecomposition3Collison model uses a convex-hull decomposition of the visual mesh which is computed by a variation of an algorithm called HACD. This option is the most accurate representation of collision geometry for complex objects with built-in tolerances to reduce the total number of convex-hulls by compromising on accuracy when justified.
Tunable4Collision model that supports precision tuning of convex decomposition fidelity.

Default

Collision model uses a voxel-based convex-hull decomposition that is relatively fast but may not be highly accurate, especially for holes, doorways, and cavities in general.

FieldValue
value0

Hull

Collision model uses the convex hull of the visual mesh.

FieldValue
value1

Box

Collision model uses a bounding box that encompasses the visual mesh.

FieldValue
value2

PreciseConvexDecomposition

Collison model uses a convex-hull decomposition of the visual mesh which is computed by a variation of an algorithm called HACD. This option is the most accurate representation of collision geometry for complex objects with built-in tolerances to reduce the total number of convex-hulls by compromising on accuracy when justified.

FieldValue
value3

Tunable

Collision model that supports precision tuning of convex decomposition fidelity.

FieldValue
value4