Version: 2023.2
Language : English
Mesh colliders
Prepare a Mesh for Mesh colliders

Mesh colliders

Mesh collidersA free-form collider component which accepts a mesh reference to define its collision surface shape. More info
See in Glossary
match the shape of a MeshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary
exactly, for extremely accurate collisionA collision occurs when the physics engine detects that the colliders of two GameObjects make contact or overlap, when at least one has a Rigidbody component and is in motion. More info
See in Glossary
simulation.

The Mesh colliderAn invisible shape that is used to handle physical collisions for an object. A collider doesn’t need to be exactly the same shape as the object’s mesh - a rough approximation is often more efficient and indistinguishable in gameplay. More info
See in Glossary
builds its collision geometry to match an assigned Mesh, including its shape, position and scale. The benefit of this is that you can make the shape of the collider exactly the same as the shape of the visible Mesh for the GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary
, which creates more precise and realistic collisions.

The precision of a Mesh collider comes with a higher processing overhead than primitive colliders (such as the Sphere, Box, and Capsule colliders). For this reason, it is best practice to only use Mesh colliders for colliders that do not otherwise require a high amount of processing power, or for collisions where primitive colliders or a compound collider would have a greater overhead. A good approach is to use Mesh colliders for static sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary
geometry, and compound colliders for moving GameObjects.

Benefits and limitations of Mesh colliders

In most cases, Mesh colliders offer a similar solution to compound colliders: their primary purpose is to provide accurate collisions for items with complex shapes. When considering the benefits and limitations of Mesh colliders, you are usually comparing them to compound colliders.

The main benefits of Mesh colliders are:

  • Mesh colliders are extremely accurate, because they perfectly match the shape of the item.
  • Mesh colliders require less manual development time than compound colliders, because Unity handles their shape automatically based on the shape of the Mesh.
  • In some cases, Mesh colliders can be less computationally demanding than compound colliders. This is often the case for very complex shapes which would require a high number of compound colliders to approximate. One Mesh collider might be more efficient than several primitive colliders.

However, Mesh colliders also have some significant limitations:

  • Mesh colliders cannot provide accurate collisions between concave shapes. For details, see Concave and convex Mesh colliders, below.
  • In some cases, compound colliders can be less computationally demanding than Mesh colliders. This is often the case for simpler shapes which only require a few colliders to approximate, or for shapes that don’t need to be too accurate. For example, a Mesh collider might generate hundreds of polygons in order to precisely match a complex shape, but an approximation with primitive colliders might require far fewer.
  • Mesh colliders are not a good option for Meshes that change shape at runtime. For details, see Meshes that change shape at runtime, below.

The decision is always unique to your project, so you should test each configuration and use the Physics ProfilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating, or in your game logic. More info
See in Glossary
to understand the efficiency of your collider setup.

Concave and convex Mesh colliders

Mesh colliders behave differently based on whether they are marked as concave or convex. By default, PhysX considers Mesh colliders to be concave.

In mathematics, “concave” and “convex” are terms used to describe shapes:

A convex shape only has lines that curve outward (for example, a ball). Any line segment connecting two points on its boundary remains entirely within the shape. A concave shape has at least one “cave” or indentation where the boundary curves inward (for example, a banana). Line segments connecting two points on its boundary might sometimes cross space outside the shape.

Concave colliders have some limitations: Concave Mesh colliders can only be static (that is, they have no physics body) or kinematic (they have a kinematic physics body). See Collider types for more details. Concave Mesh colliders can only collide with convex colliders. If two concave colliders make contact, no collision occurs.

If you have two concave Mesh colliders that need to collide, you can do one of the following, depending on how accurate your collision needs to be:

If you do not need accurate collisions to take place in the concave parts of the shape, mark one of the Mesh colliders as convex in the InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary
(enable Is Convex). This generates a new convex collider shape called a “hull”, which is like the assigned concave Mesh but with any concave lines filled in, to make them convex.

A concave Mesh collider on a banana-shaped GameObject.
A concave Mesh collider on a banana-shaped GameObject.
A convex Mesh collider on the same banana-shaped GameObject.
A convex Mesh collider on the same banana-shaped GameObject.

If you need accurate collisions to take place in the concave parts of the shape, use a compound collider made of convex colliders.

Meshes that change shape at runtime

The Mesh that you have assigned to the Mesh collider should ideally not change shape at runtime.

Every time the Mesh changes shape, the physics engineA system that simulates aspects of physical systems so that objects can accelerate correctly and be affected by collisions, gravity and other forces. More info
See in Glossary
needs to recalculate the Mesh collider geometry, which causes a substantial performance overhead. For this reason, you should not modify the geometry of a Mesh that a Mesh collider is using. If a Mesh needs to both collide and change shape at runtime, it is usually better to approximate the Mesh shape with primitive colliders or compound colliders.

Directional mesh facing

Faces in collision meshes are one-sided. This means GameObjects can pass through them from one direction, but collide with them from the other.

For details about the underlying algorithms and data structures that Mesh colliders use, see the Nvidia PhysX documentation on Geometry.

Mesh colliders
Prepare a Mesh for Mesh colliders