Trigger

Trigger     Trigger is a blueprint to run special tasks when overlap it or when trigger it manually.

It’s fully support turning on/off Advanced Control Points System, run any Action, manage all Actors belonging to selected Spawn Point and more.

When you put Trigger on the level first time – it is without collision. If you wish to use Trigger with collision – simply click Button Adapt Collision button.
If you wish to use Trigger only by manual launching, simply ignore Configuration Collision category.

Trigger Details 1.8.0

Trigger details panel.



Trigger has parameters in two categories Configuration and Configuration Collision.

Configuration category has general parameters which are responsible for the essential functionality.

Configuration Collision category has parameters and buttons dedicated to Collision shape and its parameters. Also LOD settings can be found here.

Max TriggeredMaximum possible number of triggers.
When -1 then unlimited.

Every Trigger launched by collision or manually run by event Try Do Perform – reduces the value of this parameter by one.
You can manually change this parameter for your needs – also runtime.
TasksSequentially lanuched Tasks when this Triggers is activated.
Trigger Tasks launched sequentially but instantly in the same frame. If some Trigger Tasks are not instant – then the next Trigger Task will be started immediately anyway.
You can control launching time of Trigger Task by Time to Activate parameter existed in every Trigger Task configuration.

Every Trigger Task has its own specific configuration when you add it to the list.

There are seven default Trigger Tasks you can choose:
  • Start – Start Advanced Control Points system on selected Actors and/or all Actors belonging to selected Spawn Points
    Stop – Stop Advanced Control Points system on selected Actors and/or all Actors belonging to selected Spawn Points
    Destroy – Destroy selected Actors and/or all Actors belonging to selected Spawn Points
    Player Enable Input – Enable/Disable player input
    Print String – Print debug string to Screen and/or console
    Run Action – Run Concurrent Action on selected Actors and/or all Actors belonging to selected Spawn Points
    Settings Override – Stop and then change all settings of Advanced Control Points Component on selected Actors and/or all Actors belonging to selected Spawn PointsModify Trigger – Runtime modify any selected Trigger setting. Be aware that Action with the same name exist and can modify Trigger also.
Trigger Task is designed to be easly created for your needs. To create new kind of Trigger Task which cover your needs, simply create child from CP_TriggerTask or duplicate one of existing Trigger Task objects and modify. Its structure is simple and intuitive.

More specific information of Trigger Task and more about create your own Trigger Task you can find in Trigger Task page.
Collision TypeCollision shape. Special type of function which permanently create chosen collision shape.

There are two default Collision Types you can choose:
  • Box – Box Collision
    Sphere – Sphere Collision
Collision Type is designed to be easly created for your needs. To create new kind of Collision Type which cover your needs, simply create child from CP_TriggerCollision or duplicate one of existing Trigger Collision objects and modify. Its structure is simple and intuitive.

More specific information of Trigger Collision and more about create your own Trigger Collision you can find in Trigger Collision page.
LOD MaxMaximum distance to camera in centimeters for rendering frame of collision shape of this Trigger.
When 0 then always render.
Is only relevant if Is Visible in Game is set true.
Button Adapt CollisionButton to approve changes in the Configuration Collision category.

Some parameters in Configuration Collision category must be manually confirmed and implemented by click this button.
Simply rememeber to always click this button when change anything in Configuration Collision category.
It is safe to click this button anytime you wish.
Button Remove CollisionButton for remove current collision.

If you want to run this Trigger manually only, you can completly remove collision for better performance.

Event Dispatchers

Trigger has event dispatchers you can bind when need to design some special functionality.

On Trigger PerformEvent fired when Trigger perform.
On Trigger Cannot PerformEvent fired when Trigger try to perform, but cannot. Eg. End up of Max Triggered parameter.

External Called Events

Trigger has dedicated Graph External Called Events which hold events for managing selected Trigger manually.

Event Try Do PerformEvent Try Do Perform gives you possibility to manually perform this Trigger in the same way as it is launched by collision.

Running this event check whether Max Triggered parameter will allow its execution. If allow, then Max Triggered value is reduces by one.
Event Try Do Run TasksEvent Try Do Run Tasks gives you possibility to manually perform this Trigger in similar way as it launched by collision.

The different is when running this event then Max Triggered parameter will not be checked and will not be reduces.
Event - Set Collision StateEvent Set Collision State gives you possibility to enable or disable collision of Trigger.