VisionSensor - BVH raycast-based vision cone

Detects visible targets within a field of view using BVH raycasts. Writes perception data to State for use by Intents.

State Keys Written

• targetVisible - Whether any target is visible (boolean)
• targetPosition - Position of nearest visible target ({ x, y, z } | null)
• targetDistance - Distance to nearest visible target (number)
• targetBodyIndex - Body index of nearest visible target (number | null)
• visibleTargets - Array of all visible targets

Usage

Events Emitted

body.ai.addEventListener('targetAcquired', (event) => {
  console.log('Target spotted at distance:', event.distance);
});

body.ai.addEventListener('targetLost', (event) => {
  console.log('Lost target, last seen at:', event.lastPosition);
});