3D Triggers

14 triggers available for 3D workflows.

◷ 24 min read Phase 5 enhanced
Guidance panels
Source of truth This page lists only bricks registered by the uploaded addon. Legacy aliases and compatibility script shims are not presented as separate menu entries.
Chapter guide

How triggers fit into a chain

Triggers detect input, state , collisions, timing, and other conditions. They begin a chain but do not perform gameplay actions by themselves.

  1. Choose the event or condition to detect.
  2. Configure filters, thresholds, or stored values.
  3. Connect the trigger to a Gate , then to one or more Actions.
trigger • 3d

Action Active

3D

Fires TRUE when the named action on this node matches the chosen state.\nThe action must have an instance name set.

Menu Add Logic Brick → Triggers

Options

Property Details
actuator_name Action Name
trigger_on Trigger On
Choices: Active,Inactive
Default: active
Using this brick

Typical uses

  • Start a logic chain when fires TRUE when the named action on this node matches the chosen state.\nThe action must have an instance name set.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Action Triggered Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Animation Tree Raycast Gate Collision
trigger • 3d

Animation Tree

3D

The AnimationTree is found by typed node name Modes: Current State: True when the state machine is in a specific state Condition: True when a boolean condition matches Parameter Compare: True when a parameter meets a comparison condition

Menu Add Logic Brick → Triggers

Options

Property Details
animation_tree_node_name Animation Tree Node Name
Default: AnimationTree
AnimationTree node name
mode Mode
Choices: Current State,Condition,Parameter Compare
Default: current_state
state_name State Name
state_machine_path State Machine Path
Default: parameters/playback
condition_name Condition Name
condition_expected Condition Expected
Default: true
parameter_path Parameter Path
compare_op Compare Op
Choices: Equal,Not Equal,Greater,Less,Greater Equal,Less Equal
Default: equal
compare_value Compare Value
Default: 0.0
Using this brick

Typical uses

  • Start a logic chain when the AnimationTree is found by typed node name Modes: Current State: True when the state machine is in a specific state Condition: True when a boolean condition matches Parameter Compare: True when a parameter meets a comparison condition.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Animation Tree Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Action Triggered Progress Bar Color / Transparency Movement Detected
Animation Tree screenshot placeholder
Animation Tree screenshot
trigger • 3d

Collision

3D

Detects collisions via an Area3D node located by name.\n\nType the node name (not the full path) into 'Area Node Name'.

Menu Add Logic Brick → Triggers

Options

Property Details
area_node_name Area Node Name
detection_mode Detection Mode
Choices: Entered,Exited,Overlapping
Default: entered
detect_bodies Detect Bodies
Default: true
detect_areas Detect Areas
Default: false
filter_type Filter Type
Choices: Any,Group,Name
Default: any
filter_value Filter Value
invert Invert
Default: false
Using this brick

Typical uses

  • Start a logic chain when detects collisions via an Area3D node located by name.\n\nType the node name (not the full path) into 'Area Node Name'.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Collision Gate Choose an action
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake Leaving filters too broad can make unrelated nodes activate the trigger. Test the narrowest useful filter first.

Related bricks

Collision 2D Collision Object Flash Object Shake
Collision screenshot placeholder
Collision screenshot
trigger • 3d

Movement Detected

3D

Detects if the node is moving in specific directions.\nCheck which directions to monitor.\nActive when any checked direction moves past the threshold.

Menu Add Logic Brick → Triggers

Options

Property Details
all_axis All Axis
Default: false
pos_x Pos X
Default: false
neg_x Neg X
Default: false
pos_y Pos Y
Default: false
neg_y Neg Y
Default: false
pos_z Pos Z
Default: false
neg_z Neg Z
Default: false
threshold Threshold
Default: 0.1
use_local_axes Use Local Axes
Default: false
ignore_platform_motion Ignore Platform Motion
Default: true
invert Invert
Default: false
Using this brick

Typical uses

  • Start a logic chain when detects if the node is moving in specific directions.\nCheck which directions to monitor.\nActive when any checked direction moves past the threshold.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Movement Detected Gate Choose an action
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Movement Detected Animation Tree Raycast Action Triggered
trigger • 3d

Surface Check

3D

Checks CharacterBody3D collision state: on floor, on wall, or on ceiling.\nUse this for jump checks, wall checks, ceiling bumps, and platformer logic.

Menu Add Logic Brick → Triggers

Options

Property Details
contact_type Contact Type
Choices: On Floor,On Wall,On Ceiling
Default: On Floor
invert Invert
Default: false
require_contact_loss_first Require Contact Loss First
Default: false
Using this brick

Typical uses

  • Start a logic chain when checks CharacterBody3D collision state: on floor, on wall, or on ceiling.\nUse this for jump checks, wall checks, ceiling bumps, and platformer logic.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Surface Check Gate Choose an action
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Surface Check Surface Check Action Triggered Raycast
trigger • 3d

Proximity

3D

Detects objects within a distance and optional angle.\nUses groups to filter which objects are detected.

Menu Add Logic Brick → Triggers

Options

Property Details
target_group Target Group
distance Distance
Default: 10.0
angle Angle
Default: 360.0
axis Axis
Choices: All,+X,-X,+Y,-Y,+Z,-Z
Default: all
detection_mode Detection Mode
Choices: Any,All,None
Default: any
inverse Inverse
Default: false
store_object Store Object
Default: false
object_variable Object Variable
Using this brick

Typical uses

  • Start a logic chain when detects objects within a distance and optional angle.\nUses groups to filter which objects are detected.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Proximity Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Proximity 2D Raycast Raycast 2D Movement Detected
Proximity screenshot placeholder
Proximity screenshot
trigger • 3d

Raycast Hit

3D

Detects along a RayCast3D. This can be used for objects, groups, walls, ground, or ledges.\nThe RayCast3D's direction, length, and collision mask are set on the RayCast3D node itself.

Menu Add Logic Brick → Triggers

Options

Property Details
raycast_node_name Raycast Hit Node Name
Default: RayCast3D
RayCast3D node name
detect_mode Detect Mode
Choices: Any,Group,Nothing
Default: any
group_filter Group Filter
invert Invert
Default: false
Using this brick

Typical uses

  • Start a logic chain when detects along a RayCast3D. This can be used for objects, groups, walls, ground, or ledges.\nThe RayCast3D's direction, length, and collision mask are set on the RayCast3D node itself.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Raycast Gate Choose an action
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Raycast 2D Proximity Action Triggered Collision
Raycast screenshot placeholder
Raycast screenshot
trigger • 3d

Always

3D 2D

Always logic brick.

Menu Add Logic Brick → Triggers

Options

Property Details
enabled Enabled
Default: true
Using this brick

Typical uses

  • Start a logic chain when always logic brick.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Always Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

State Always Character Jump 2D Surface Check
Always screenshot placeholder
Always screenshot
trigger • 3d

Compare Variable

3D 2D

Compares a variable 's value.\nWorks with local , exported, and global variables.\nAutomatically checks GlobalVars if not found locally.

Menu Add Logic Brick → Triggers

Options

Property Details
variable_name Variable Name
evaluation_type Evaluation Type
Standard variable choices: Equal, Not Equal, Interval, Changed, Greater Than, Less Than, Greater or Equal, Less or Equal.
Array choices (selected automatically for Array variables): Contains, Does Not Contain, Is Empty, Is Not Empty, Size Equals, Size Greater Than, Size Less Than, Changed.
Default: equal
value Value
min_value Min Value
max_value Max Value
item_type Array Item Type
Shown for Contains and Does Not Contain. Choices: bool, int, float, String, Vector2, Vector3.
Array comparisons When variable_name matches an Array variable, the Evaluation Type menu changes automatically. Use Contains or Does Not Contain to test for an item, the empty checks to test whether the Array has any items, or the size checks to compare the number of items. The selected Array Item Type determines how the entered value is interpreted.
Using this brick

Typical uses

  • Start a logic chain when compares a variable's value.\nWorks with local, exported, and global variables.\nAutomatically checks GlobalVars if not found locally.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Capture or compare a value as part of variable-driven gameplay logic.

Example chain

Compare Variable Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Modify Variable Variable Animation Animation Tree
Compare Variable screenshot placeholder
Compare Variable screenshot
trigger • 3d

Delay

3D 2D

Waits for Delay seconds, then stays active for Duration seconds.\nRepeat cycles the whole sequence.

Menu Add Logic Brick → Triggers

Options

Property Details
delay Delay
Default: 0.0
duration Duration
Default: 0.0
repeat Repeat
Default: false
Using this brick

Typical uses

  • Start a logic chain when waits for Delay seconds, then stays active for Duration seconds.\nRepeat cycles the whole sequence.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Delay Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Random Always Always Compare Variable
Delay screenshot placeholder
Delay screenshot
trigger • 3d

Input

3D 2D

Detects input actions from Project > Input Map.\nSupports button presses, any-action checks, and analog joystick axis input.

Menu Add Logic Brick → Triggers

Options

Property Details
input_mode Input Mode
Choices: Pressed,Just Pressed,Just Released,Any Pressed,Any Just Pressed,Any Just Released,Axis
Default: pressed
action_name Action Name
Default: (blank)
negative_action Negative Action
positive_action Positive Action
invert Invert
Default: false
store_in Store In
deadzone Deadzone
Default: 0.1
Using this brick

Typical uses

  • Start a logic chain when an Input action is detected from Project > Input Map.\nSupports button presses, any-action checks, and analog joystick axis input.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Capture or compare a value as part of variable-driven gameplay logic.

Example chain

Input Gate Choose an action
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Input Button Compare Variable Mouse
trigger • 3d

Mouse

3D 2D

Detects mouse buttons, wheel, movement, and object hover

Menu Add Logic Brick → Triggers

Options

Property Details
detection_type Detection Type
Choices: Button,Wheel,Movement,Hover Object,Hover Any
Default: button
mouse_button Mouse Button
Choices: Left,Right,Middle
Default: left
button_state Button State
Choices: Pressed,Released,Held
Default: pressed
wheel_direction Wheel Direction
Choices: Up,Down
Default: up
movement_threshold Movement Threshold
Default: 0.1
target_node_name Target Node Name
Default: self
Using this brick

Typical uses

  • Start a logic chain when detects mouse buttons, wheel, movement, and object hover.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Mouse Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Input Mouse Movement Detected Movement Detected
Mouse screenshot placeholder
Mouse screenshot
trigger • 3d

Random Chance

3D 2D

Activates randomly each time it is evaluated.\\nPair with a Delay Trigger to control how often it rolls.\\nUseful for random behaviors, AI variation, and loot rolls.

Menu Add Logic Brick → Triggers

Options

Property Details
trigger_mode Trigger Mode
Choices: Chance,Value,Range
Default: chance
chance_percent Chance Percent
Choices: 0.0,100.0,0.1
Default: 10.0
target_value Target Value
Default: 0
target_min Target Min
Default: 0
target_max Target Max
Default: 100
use_seed Use Seed
Default: false
seed_value Seed Value
Default: 0
store_value Store Value
Default: false
value_variable Value Variable
Using this brick

Typical uses

  • Start a logic chain when activates randomly each time it is evaluated.\\nPair with a Delay Trigger to control how often it rolls.\\nUseful for random behaviors, AI variation, and loot rolls.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Capture or compare a value as part of variable-driven gameplay logic.

Example chain

Random Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Random Delay Always Animation
Random screenshot placeholder
Random screenshot
trigger • 3d

Signal Receive

3D 2D

Detects signals sent by a Signal Action.\nListens for a specific subject.

Menu Add Logic Brick → Triggers

Options

Property Details
subject Subject
match_mode Match Mode
Choices: Exact,Contains,Starts With
Default: exact
response_delay Response Delay
Default: 0.0
Using this brick

Typical uses

  • Start a logic chain when detects signals sent by a Signal Action.\nListens for a specific subject.
  • Gate an action through a Gate so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Signal Receive Gate Choose an action
Tip Connect the trigger to a Gate even when only one condition is needed; this keeps the chain easy to expand later.
Common mistake A trigger only detects a condition. It does not perform an action until it is connected through a Gate to an Action.

Related bricks

Input Mouse Movement Detected Movement Detected