Vi3W
Skip to content

Guides

Roblox CollisionFidelity explained: Box, Hull, Default, Precise and Tunable

What each Roblox CollisionFidelity setting does, what it costs, and which one to use for props, floors, vehicles and decorations.

3 min read

A curvy low-poly teapot wrapped in four translucent collision shells, from a simple box to a tight fit
Illustration. Four ways to wrap the same mesh for physics.

Quick answer

What does CollisionFidelity do in Roblox?

It sets how closely a MeshPart's physics shape follows its visible mesh. Box is a simple bounding box and the cheapest. Hull wraps the mesh in a convex shell. Default allows some concave shapes. PreciseConvexDecomposition is the closest and the most expensive. Tunable gives you a precision slider in between.

Collision isn't the same as what you see

When you import a mesh, Roblox doesn't use every triangle for physics. That would be far too slow. Instead it builds a simpler collision shape, and CollisionFidelity controls how simple.

A ball rolling against a curved ramp mesh with a glowing translucent collision outline
Illustration. Players collide with the outline, not the visible surface.

The five options

From Roblox's meshes documentation:

  • Box: Shape: Bounding box; Cost: Lowest; Use it for: Small or non-interactive objects, clutter, decorations
  • Hull: Shape: Convex hull, like shrink-wrap; Cost: Low; Use it for: Rocks, barrels, vehicles, shapes without deep dents
  • Default: Shape: Approximate shape that supports concavity; Cost: Medium; Use it for: Complex objects with some interaction
  • PreciseConvexDecomposition: Shape: Closest fit, though still not 1:1; Cost: Highest; slower to compute; Use it for: Use sparingly: a ramp or bowl players actually move through
  • Tunable: Shape: Precision set by a CollisionPrecision slider; Cost: Your choice; Use it for: Fine-tuning between the others

Roblox's performance guide adds that Box has the lowest memory overhead, and that setting small anchored parts to Box is generally safe.

Quick rules

  • Decoration players never touch? Turn CanCollide off. Turn CanTouch and CanQuery off too if nothing needs to detect it.
  • Small prop they might bump into? Box.
  • Round or chunky shape? Hull.
  • Something players walk into, like an arch, a tunnel or a hollow? Default. Hull would fill in the opening.
  • A curved ramp, half-pipe or bowl where exact shape matters? Precise, and only on that object.
  • Big building players walk inside? Use simple invisible parts for walls and floors, and set the visible mesh to Box with CanCollide off.

See what you're colliding with

Turn on collision visualisation in Studio to see the collision shapes. Recent Studio versions have it under the view options. You'll often find a doorway blocked by a Hull, or a tree whose leaves have collision.

Common problems

  • "I can't walk through the doorway." The mesh is on Hull or Box, which fills the opening. Switch to Default, or use separate invisible wall parts.
  • "Players get stuck on small bumps." The collision follows tiny detail. Use Hull, or a smooth invisible floor part.
  • "The game lags with lots of physics objects." Too many Precise meshes. Downgrade to Hull or Box wherever you can.
  • "Collision doesn't match after I resize." Collision is rebuilt when the shape changes. Check it again after scaling.

Collision for vehicles and moving parts

Moving objects pay for collision every frame. Give cars, boats and pets a simple Box or Hull, or a single invisible collision part, and set the detailed visual mesh to CanCollide = false and Massless = true. See Roblox car models.

Start with a lighter mesh

Collision shapes are cheaper to build from clean, low-poly meshes. Vi3W retopologises every model from high poly to low poly and exports GLB, FBX or OBJ for the Studio Importer. You still choose the CollisionFidelity in Studio. Make a mesh in Vi3W.

Last reviewed