Static colliders

BeginnerDesigner

Static colliders aren't moved by forces such as gravity and collisions, but other physics objects can bump into them. Typical static colliders are strong immovable objects like walls, floors, large rocks, and so on.

Static and rigidbody colliders

Add a static collider

  • Select the entity you want to make a static collider.

  • In the Property Grid, click Add component and select Static Collider.

Add Static collider component

  • Set the collider shape to match the shape of the entity. To do this, in the Property Grid, expand the Static Collider component to view its properties.

  • Next to Collider Shapes, click Green plus button (Add) and select the shape you want.

Add Static collider component

Static collider properties

You can adjust the static collider properties in the Property Grid.

Static collider properties

PropertyDescription
Collision GroupSets which collision group the object belongs to.
Can Collide WithSets which groups the object collides with.
Collision EventsIf this is enabled, the object reports collision events, which you can use in scripts. It has no effect on physics. If you have no scripts using collision events for the object, disable this option to save CPU.
Can SleepIf this is enabled, the physics engine doesn't process physics objects when they're not moving. This saves CPU.
RestitutionSets the amount of kinetic energy lost or gained after a collision. A typical value is between 0 and 1. If the restitution property of colliding entities is 0, the entities lose all energy and stop moving immediately on impact. If the restitution is 1, they lose no energy and rebound with the same velocity they collided at. Use this to change the "bounciness" of rigidbodies.
FrictionSets the surface friction.
Rolling FrictionSets the rolling friction.
CCD Motion ThresholdSets the velocity at which continuous collision detection (CCD) takes over. CCD prevents fast-moving entities (such as bullets) erroneously passing through other entities.
CCD Swept Sphere RadiusSets the radius of the bounding sphere containing the position between two physics frames during continuous collision detection.
Is TriggerToggles whether the static collider is a trigger.

Move a static collider at runtime

If you need to move a static collider at runtime, you can do it with a script:

  1. PhysicsComponent.Entity.Transform.Position += PhysicsComponent.Entity.Transform.Position + Vector3.UnitX;
  2. PhysicsComponent.Entity.Transform.UpdateWorldMatrix();
  3. PhysicsComponent.UpdatePhysicsTransformation();

See also