Jolt Trigger Component
The Jolt trigger component is a special kind of actor that determines whether other actors overlap with its volume. If so, it sends a trigger event message. Other components or script code can react to this message to implement their game logic.
Triggers are often used to open and close doors, to check whether a character walked over a pickup item and to detect when the player reached some location.
A trigger is set up the same way as a static actor or a dynamic actor, by attaching collision shapes to it. Which other physics objects activate the trigger is determined through the collision layers on the attached shapes.
Since triggers are not simulated like rigid bodies, they don't require much configuration.
Triggers can be moved around at runtime and they will fire, when an object enters a trigger because the trigger moved into the object.
When a trigger fires, it sends the event message plMsgTriggerTriggered
. The message states which other object was involved, and whether it entered or left the trigger volume. It will also pass along the TriggerMessage
string. This can be used to identify which (kind of) trigger was just triggered.
To achieve more complex trigger behavior, for instance to only activate something after a delay, you can utilize the trigger delay modifier component.
Component Properties
CollisionLayer
: The collision layer to use.TriggerMessage
: The string that should be sent along with theplMsgTriggerTriggered
.
See Also
Trigger Delay Modifier Component
Jolt Shapes
Spatial System
Marker Component