User Manual

Compound Shapes

Compound shapes are custom collision shapes created out of multiple primitive shapes (full list of shapes here). This allows you to have more complex collision shapes without using a custom mesh model.

The main advantage is that you are able to have dynamic rigidbody collisions between compound shapes (shown below) which is not possible with mesh collision types.

PlayCanvas project link

The shape of a compound physics object is defined by the children's collision shapes as shown below.

The Chair entity (parent) has the collision component with type set to 'Compound'.

The children entities will form the shape of the physics object with collision components and the type set to a primitive shape and positioned relative to the parent.

The parent is also the center of mass of the physics object and it is recommended to have it within the bounds of the shape of the object (usually the center). If not, the object may show odd behavior when forces and torque are applied such as rotating around an invisible pivot in the world.