Notch Notch
Manual 1.0 Manual 0.9.23
 Light | Dark
Collision Mesh

Collision Mesh

Updated: 2 Jun 2025

Allows rigid bodies to collide with a static mesh.

Method #

The Rigid Body Collision Mesh node is used to allow rigid bodies to collide with a static, complex mesh - such as a displaced floor. Collisions with a Collision Mesh node use tests against polygons treated as thin planes. This is less robust than collisions with convex hulls as used when 3D Object or Primitive nodes are set up as static colliders. A high frame rate on the Rigid Body Root is recommended to reduce the chance of bodies falling through. Wherever possible, use a 3D Object or 3D Primitive node as a static rigid body should be used instead.

Parameters

These properties control the physical properties of the rigid bodies, changing how each object interacts with one another.

ParameterDetails
Static Friction How much resistance there will be for rigid bodies that are at rest relative to each other to begin moving.
Friction How much other rigid bodies will be able to slide along side this rigid body. When two rigid bodies of different frictions interact, the minimum value is used.
Bounciness How much this rigid body will bounce off of other rigid bodies in the scene.
Density The density of the rigid body. The density is scaled by the area of the shape to determine the mass of the body.
Collision Radius The radius of collision shape if applicable.
Collision Mode Mode for calculating collision if applicable.
  • Volumetric : Calculate collisions inside the object.
  • Surface : Only calculate collisions on the surface of the object.

These properties set the visibility of debug items in the viewport.

ParameterDetails
Show Collision Distances TBC

Inputs

NameDescriptionTypical Input
ObjectsThe 3D objects used for the collision mesh.3D Object nodes
Transform ModifiersApply the transforms of another node to this node.Null
Target NodeModifiy the rotations of the node to always direct the z axis towards the input.Null
Local Transform OverrideApply the transforms of another node to this node, relative to its parent.Null