Choose a sensor from the gameplay question the graph must answer. Keep environmental measurement separate from target preference, memory, and response logic.

Distance

Distance measures separation from selected objects or points. Use it for interaction range, formation spacing, approach decisions, or safety distances. It can track multiple candidates, but the surrounding graph should decide which candidate has priority.

Luminance

Luminance measures registered light and optional ambient contribution. Use it for stealth exposure, light-seeking behavior, or environment-driven state. Configure Luminance emitters and the manager before treating a zero reading as darkness.

Surface

Surface identifies the type beneath or near an agent through texture mapping or an explicit Surface Identifier. Use it for terrain-dependent speed, footsteps, animation, or path choice.

Sound

Sound searches selected candidates for playing Audio Source components in their children. It compares the calculated sound level, based on volume and distance settings, with Audibility Threshold. Use candidate filters to exclude decorative sources that should not attract agents; no separate sound-emitter registration is required.

Temperature

Temperature combines scene temperature with absolute or relative volumes. Use it for environmental hazards, comfort-seeking, or zone selection. Define whether a branch reacts to the measured amount or merely entry into a volume.

Tracer

Tracer reads emitted samples such as scent, blood, footprints, or breadcrumbs. Trail quality depends on world bounds, emission spacing, and dissipation. Following the detected trail additionally requires the Movement Pack.

Visibility

Visibility checks range, horizontal field of view, vertical field of view, and obstruction. When Debug Draw Ray is enabled, the first failed gate is shown by color:

  • Red: target is beyond range.
  • Magenta: target is outside horizontal field of view.
  • Cyan: target is outside vertical field of view.
  • Yellow: another object blocks the target.
  • Green: the target is visible and within range.

Tune range first, then horizontal field of view, vertical field of view, and obstruction so one broad setting does not hide a later failure.

Match a sensor to a question

Question Sensor Important choice
Can the agent see that target? Visibility Offsets, field of view, and obstruction layers.
Is the target close enough? Distance Known target versus discovered candidates.
Should the agent investigate a noise? Sound Candidate AudioSources, playing state, calculated level, and audibility threshold.
Is this location bright enough? Luminance Registered lights, ambient contribution, and threshold.
What material is beneath the agent? Surface Texture mapping versus explicit identifier.
Is this zone dangerously hot or cold? Temperature Absolute, relative, and scene baseline.
Where does this trail continue? Tracer Bounds, spacing, freshness, and navigation.