Skip to main content
Advanced AI behaviors for scanning fields of view and patrolling.

​
👁️ Activity Library

Static Vision

Stationary scanning (Field of View).

Patrol Vision

Scan while walking a path.

Random Wander

Scan while wandering randomly.

Spin Vision

Scan while spinning 360°.

Target Chase

Scan while moving to target.

Look At

Scan while tracking players.

​
⚙️ Configuration

​
visibility_detection_activity

Base activity for scanning for players within a cone or sphere.
​
radius
Double
default:"10.0"
Max view distance.
​
fov
Double
default:"90.0"
Field of View angle (degrees).
​
shape
VisionShape
default:"CONE"
Detection shape: CONE or SPHERE.
​
showDisplay
Boolean
default:"false"
Debug: Visualize the view cone (Client-side).

​
patrol_visibility_detection_activity

Patrols a road network while scanning.
​
roadNetwork
RoadNetworkEntry
The path to patrol.
​
nodeIds
List<Int>
Specific nodes to visit.

​
spin_visibility_detection_activity

Spins the NPC while scanning.
​
duration
Duration
default:"2s"
Time for one full rotation.
​
axis
SpinAxis
default:"YAW"
Axis: YAW (horizontal) or PITCH (vertical).

​
look_close_visibility_detection_activity

Stares at nearby entities while scanning.
​
lookRange
Double
default:"5.0"
Distance to start tracking heads.

​
💻 Example

spin_visibility_detection_activity:
  duration: 5s
  radius: 20
  fov: 45
  triggers:
    - sound_action:
        sound: BLOCK_NOTE_BLOCK_PLING