Stage Follow
stage_followMake a camera, light, or drone soft-follow a target live on the page with no code, tuning offset, lag, look, and orbit; stop it any time or read a target's pose.
Instructions
Make an object (a camera, a light, a drone) soft-follow a target every frame, live on the page, with no code (page command: follow); the same follow a behaviour starts with s.follow. target: an object's name, 'person' (the user's eyes: the headset in VR, the view on a desktop) or ':' (a joint of a body the scene shows, e.g. dell:head, dell:pelvis, dell:hand_r; a wrong bone lists some). offset: [right, forward, up] metres from the target, turning with where it faces (space 'target'; a body faces where its hips face), or [x, y, z] Blender metres (space 'world'). lag: seconds to close most of the gap (0 = locked on; 0.3 to 1 reads as a camera operator). look: True aims at the target (the default for cameras and lights), False keeps its turn, a target name or an [x, y, z] point aims there; look_offset [x, y, z] moves the aim point (aim at the chest, not the hips); look_lag smooths the turn. orbit: degrees a second around the target (a drone circling). snap: start on the spot. target=None stops the object's follow. While it follows, its keys on the clock wait. Live only, never saved: bake it into keys for the render with stage_camera_record(source='follow'), then keep. object=None lists what follows what; where= reads a target's pose {location, rotation, quaternion, forward, facing} (Blender metres and degrees) and changes nothing. A reload of behaviours.js ends agent follows. Page replies {object, target, following, waiting?}. Emits: follow {object, target, following, by?, why?}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lag | No | ||
| look | No | ||
| snap | No | ||
| orbit | No | ||
| scene | Yes | ||
| space | No | target | |
| where | No | ||
| object | No | ||
| offset | No | ||
| target | No | ||
| look_lag | No | ||
| look_offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |