Physics Visualization

The physics visualization view can be toggled by clicking the button in the infobar under the viewport. This will render only the physics collision geometry. You can click the button to toggle between each view. The physics view is useful for debugging physics-related issues.

The physics collider meshes are rendered in different colors, depending on both the state and type of the collider:

  • Green - Box colliders.
  • Yellow - Sphere colliders.
  • Orange - Convex colliders.
  • Purple - Custom physics colliders.
  • Black - Plane colliders.
  • Blue - Kinematic and Nonconvex body colliders.
  • Red - Sleeping rigid bodies.

Kinematic rigid bodies are colored blue, regardless of the collider type. Kinematic and sleeping bodies take precedence over the collider type when determining the color of the physics geometry, except for planes.

If an entity with a dynamic rigid body has very small kinetic energy for a certain period of time then the physics engine will assume that it will not move in the future until acted on by an external force. These rigid bodies are excluded from the physics engine solver, improving both performance and stability. We refer to rigid bodies that are in this state as sleeping.

Entities in the physics visualization view are still selectable, unless in navigate mode. You can select entities with custom physics colliders to see the number of convex hulls that decompose the mesh.