Version: Unity 6.7 Alpha (6000.7)
Language : English
Primitive collider shapes
Box collider component reference

Introduction to primitive collider shapes

Primitive colliders are the most computationally efficient type of collider in Unity. They are called “primitive” because they are defined by simple geometric shapes such as boxes, spheres, and capsules. They match the Primitive Objects, which are built-in GameObject shapes.

There are three primitive collider shapes in Unity:

  • Box colliderA cube-shaped collider component that handles collisions for GameObjects like dice and ice cubes. More info
    See in Glossary
    : A rectangular box-shaped collider that is suitable for most rectangular objects.
  • Sphere colliderA sphere-shaped collider component that handles collisions for GameObjects like balls or other things that can be roughly approximated as a sphere for the purposes of physics. More info
    See in Glossary
    : A spherical collider that is suitable for most circular objects.
  • Capsule colliderA capsule-shaped collider component that handles collisions for GameObjects like barrels and character limbs. More info
    See in Glossary
    : A cylindrical collider that is suitable for objects that have a cylindrical shape, or for rounding out the collision edges on sharp corners. Capsule colliders are also useful for player and non-player characters.

Primitive colliders are efficient, but they have limitations. For example, you cannot change or deform their shape, only their scale. Unlike Mesh colliders, they are not made up of triangles; their shape is fixed (note that the Physics Debug visualization does indicate a triangle-based mesh on primitive colliders, but these are for visualization purposes only and do not reflect the collider’s construction).

Primitive colliders are usually not the best option for complex shapes, wheels, or Terrain collision. Unity has specific colliders available for more complex collider shapes (see Mesh collidersA free-form collider component which accepts a mesh reference to define its collision surface shape. More info
See in Glossary
, Terrain collidersA terrain-shaped collider component that handles collisions for collision surface with the same shape as the Terrain object it is attached to. More info
See in Glossary
, and Wheel collidersA special collider for grounded vehicles. It has built-in collision detection, wheel physics, and a slip-based tire friction model. It can be used for objects other than wheels, but it is specifically designed for vehicles with wheels. More info
See in Glossary
). However, if you need a collider shape that fits a complex shape, but does not need to be too accurate, you can use primitive colliders to create a Compound collider. A Compound collider is a collection of primitive colliders in an arrangement that fits the collider shape you need.

In summary, primitive colliders are an efficient but sometimes inaccurate way to add collision detection to objects in Unity. They are suitable for primitive-shaped GameObjects with regular shapes. However, for more complex objects with irregular shapes, or for more accurate collision detection, you should use a more complex collider shape.

Primitive collider shapes
Box collider component reference