2D Sensors

12 sensors available for 2D 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 sensors fit into a chain

Sensors 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 sensor to a Controller , then to one or more Actuators.
sensor • 2d

Collision 2D

2D

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

Menu Add Logic Brick → Sensors
Source sensors/2d/collision_2d_sensor.gd

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 Area2D node located by name.\n\nType the node name (not the full path) into 'Area Node Name'.
  • Gate an action through a Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Collision 2D Controller Choose an actuator
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 sensor. Test the narrowest useful filter first.

Related bricks

Collision Object Flash Object Shake Raycast 2D
Collision 2D screenshot placeholder
Collision 2D screenshot
sensor • 2d

Movement 2D

2D

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

Menu Add Logic Brick → Sensors
Source sensors/2d/movement_2d_sensor.gd

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
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 a 2D 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 Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Movement 2D Controller Choose an actuator
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake A sensor only detects a condition. It does not perform an action until it is connected through a Controller to an Actuator.

Related bricks

Movement Raycast 2D Animation Tree Collision 2D
Movement 2D screenshot placeholder
Movement 2D screenshot
sensor • 2d

Physics 2D

2D

Checks CharacterBody2D 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 → Sensors
Source sensors/2d/physics_2d_sensor.gd

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 CharacterBody2D 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 Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

Physics 2D Controller Choose an actuator
Tip Use Invert when the opposite condition is easier to express than rebuilding the chain with different logic.
Common mistake A sensor only detects a condition. It does not perform an action until it is connected through a Controller to an Actuator.

Related bricks

Physics Raycast 2D Actuator Character Jump 2D
Physics 2D screenshot placeholder
Physics 2D screenshot
sensor • 2d

Proximity 2D

2D

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

Menu Add Logic Brick → Sensors
Source sensors/2d/proximity_2d_sensor.gd

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 Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

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

Related bricks

Proximity Raycast 2D Raycast Movement 2D
Proximity 2D screenshot placeholder
Proximity 2D screenshot
sensor • 2d

Raycast 2D

2D

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

Menu Add Logic Brick → Sensors
Source sensors/2d/raycast_2d_sensor.gd

Options

Property Details
raycast_node_name Raycast Node Name
Default: RayCast2D
RayCast2D 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 RayCast2D. This can be used for objects, groups, walls, ground, or ledges.\nThe RayCast2D's direction, length, and collision mask are set on the RayCast2D node itself.
  • Gate an action through a Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

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

Related bricks

Raycast Proximity 2D Collision 2D Movement 2D
Raycast 2D screenshot placeholder
Raycast 2D screenshot
sensor • 2d

Always

3D 2D

Always logic brick.

Menu Add Logic Brick → Sensors
Source sensors/common/always_sensor.gd

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 Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

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

Related bricks

State Always Character Jump 2D Character Physics
Always screenshot placeholder
Always screenshot
sensor • 2d

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 → Sensors
Source sensors/common/variable_sensor.gd

Options

Property Details
variable_name Variable Name
evaluation_type Evaluation Type
Choices: Equal,Not Equal,Interval,Changed,Greater Than,Less Than,Greater or Equal,Less or Equal
Default: equal
value Value
min_value Min Value
max_value Max Value
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 Controller so multiple conditions can be combined.
  • Capture or compare a value as part of variable-driven gameplay logic.

Example chain

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

Related bricks

Modify Variable Variable Animation Animation Tree
Compare Variable screenshot placeholder
Compare Variable screenshot
sensor • 2d

Delay

3D 2D

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

Menu Add Logic Brick → Sensors
Source sensors/common/delay_sensor.gd

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 Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

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

Related bricks

Random Always Always Compare Variable
Delay screenshot placeholder
Delay screenshot
sensor • 2d

Input Map

3D 2D

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

Menu Add Logic Brick → Sensors
Source sensors/common/input_map_sensor.gd

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: ui_accept
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 detects input actions from Project > Input Map.\nSupports button presses, any-action checks, and analog joystick axis input.
  • Gate an action through a Controller so multiple conditions can be combined.
  • Capture or compare a value as part of variable-driven gameplay logic.

Example chain

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

Related bricks

Input Map Button Compare Variable Mouse
Input Map screenshot placeholder
Input Map screenshot
sensor • 2d

Mouse

3D 2D

Detects mouse buttons, wheel, movement, and object hover

Menu Add Logic Brick → Sensors
Source sensors/common/mouse_sensor.gd

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 Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

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

Related bricks

Input Map Mouse Movement Movement 2D
Mouse screenshot placeholder
Mouse screenshot
sensor • 2d

Random

3D 2D

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

Menu Add Logic Brick → Sensors
Source sensors/common/random_sensor.gd

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 Sensor to control how often it rolls.\\nUseful for random behaviors, AI variation, and loot rolls.
  • Gate an action through a Controller so multiple conditions can be combined.
  • Capture or compare a value as part of variable-driven gameplay logic.

Example chain

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

Related bricks

Random Delay Always Animation
Random screenshot placeholder
Random screenshot
sensor • 2d

Signal

3D 2D

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

Menu Add Logic Brick → Sensors
Source sensors/common/message_sensor.gd

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 Actuator.\nListens for a specific subject.
  • Gate an action through a Controller so multiple conditions can be combined.
  • Use it as the event or condition at the beginning of a reusable chain.

Example chain

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

Related bricks

Input Map Mouse Movement Movement 2D
Signal screenshot placeholder
Signal screenshot