Table of Contents

(NOTE) Recommended Reading: The Collider page should be read before this page.

MultiConvexMeshCollider defines a collection of convex hulls for collision detection based upon a MultiConvexMesh resource.

WARNING: A future version will likely combine all physics mesh types together.

MultiConvexMeshCollider allows more complicated shapes to be represented than a ConvexMeshCollider while still retaining performance. Physics needs convex shapes for efficiency so this Collider represents non-convex shapes as a collection of sub convex meshes.

Currently, the editor for this mesh type only works for 2D shapes (sprites). 3D meshes can be made, but only through script. Future plans include implementing 3D approximate convex decomposition.

Troubleshooting

As the MultiConvexMeshCollider contains multiple convex pieces, seams can exist between the pieces. This can cause edge catching issues when objects slide across the surface. Additionally, an object can get sandwiched in the interior between two sub-meshes.


Related Materials

Manual

Reference