Radar

Category: Listener Tier: Basic

Purpose

Detects objects within a cone-shaped field of view (FOV), like a radar or vision cone.

Visual Reference

As added to your scene
Radar brick as it appears in the GDLink editor

When To Use

1. Enemy AI Vision Cone

Radar Listener (Angle: 60 deg , Distance: 15.0, Group: "player", Expose Data: true)
-> AND Gate
-> Animation Executor (Play: "alert")
-> Property Executor (Set Global "enemy_alerted" = true)

Enemy detects player when in 60 deg FOV, plays alert animation.

2. Security Camera

Radar Listener (Angle: 90 deg , Distance: 20.0, Axis: +Z, LOS: true, Group: "intruders")
-> AND Gate
-> Sound Executor (Play: "alarm.wav")
-> Message Executor (Send: "INTRUDER_DETECTED")

Camera detects intruders in its cone, triggers alarm.

3. Stealth Game - Stay Out of Sight

Radar Listener (Angle: 90 deg , Distance: 10.0, Target: "Player", Invert: true)
-> AND Gate
-> Property Executor (Set Global "is_hidden" = true)

Check if player is NOT in guard’s vision (stealth success).

4. Auto-Aim System

Radar Listener (Angle: 30 deg , Distance: 50.0, Group: "enemies", Expose Data: true)
-> Expression Gate (radar_count > 0)
-> Track To Executor (Target: from Local Variable "radar_closest")

Turret aims at nearest enemy in narrow cone.

5. Peripheral Vision (Wide Cone)

Radar Listener (Angle: 180 deg , Distance: 5.0, Target: "Enemy")
-> AND Gate
-> PRINT Executor ("Enemy behind me!")

Detect enemies in 180 deg hemisphere (front half).

Runtime Behavior

Evaluates: TRUE when any/specific object is within the detection cone

Generated UI Mockup — showing expanded properties
Radar
-
x
Name:
Label this brick...
Target:
Any
Obj Name:
v
Group:
v
Prop:
v
Value:
v
Axis:
+Z
Scope:
Local
Prefix:
radar
v
Angle
90.0
v
Dist
20.0
v
LOS
Expose
Verbose
Invert

Properties

Property

Type

Default

Notes

Target

option

Any

Detection filter

Obj Name

string

[Object Name] Name of specific object

Group

string

[Group] Group name to detect

Prop

string

[Property] Metadata property name

Value

string

[Property] Expected property value

Axis

option

+Z

Cone direction (local axis)

Angle

float

90.0

FOV cone angle in degrees

Dist

float

20.0

Maximum detection range

LOS

bool

True

Require clear raycast (Line of Sight)

Expose

bool

True

Store radar detection data in variables

Scope

option

Local

Where exposed radar variables are written

Count Var

variable_name

Variable that receives detected object count

Closest Var

variable_name

Variable that receives the closest object name

Dist Var

variable_name

Variable that receives closest object distance

Angle Var

variable_name

Variable that receives closest object angle

List Var

variable_name

Variable that receives detected object names

Prefix

string

radar

Compatibility fallback when explicit output variables are empty

Invert

bool

False

Trigger when NO objects detected

Verbose

bool

False

Log detection results each tick via ladybug