Sensor

Detect nearby entities, cast rays, and configure collision handling.

Feature: Events

What do you want to do?

llSensor(string name, key id, integer type, float radius, float arc)Performs a single scan from the prim's forward vector for name and id of type within radius meters and arc radians. Results trigger a sensor or no_sensor event. Passing empty filters (blank name, 0 type, or NULL_KEY id) disables that filter.llSensorRepeat(string name, key id, integer type, float radius, float arc, float rate)Sets up a repeating periodic scan every rate seconds for name and id of type within radius meters and arc radians of the forward vector. Results trigger sensor or no_sensor events.list llCastRay(vector start_pos, vector end_pos, list options)Casts a ray into the physics world from start to end and reports collision data for intersections with objects based on options. Returns a list of strided values [UUID_1, {link_number_1}, hit_position_1, {hit_normal_1}, ..., status_code]. A negative status_code indicates an error; otherwise, it represents the number of hits.

Reference

Find topic entries

12 topic entries

• list llCastRay(vector start_pos, vector end_pos, list options)function

  Casts a ray into the physics world from start to end and reports collision data for intersections with objects based on options. Returns a list of strided values [UUID_1, {link_number_1}, hit_position_1, {hit_normal_1}, ..., status_code]. A negative status_code indicates an error; otherwise, it represents the number of hits.

• llCollisionFilter(string name, key id, integer accept)function

  Sets the collision filter, either exclusively or inclusively. If accept is TRUE, only collisions matching name and id are processed; if FALSE, matches are excluded. Pass an empty string or NULL_KEY to name or id to skip filtering on that parameter.

• llPassCollisions(integer pass)function

  Sets the pass-collisions attribute. If pass is TRUE, collision events are passed from child prims to the root; if FALSE (default), they only trigger events in the affected child prim.

• llSensor(string name, key id, integer type, float radius, float arc)function

  Performs a single scan from the prim's forward vector for name and id of type within radius meters and arc radians. Results trigger a sensor or no_sensor event. Passing empty filters (blank name, 0 type, or NULL_KEY id) disables that filter.

• llSensorRemove()function

  Removes the periodic sensor previously configured by llSensorRepeat.

• llSensorRepeat(string name, key id, integer type, float radius, float arc, float rate)function

  Sets up a repeating periodic scan every rate seconds for name and id of type within radius meters and arc radians of the forward vector. Results trigger sensor or no_sensor events.

• llVolumeDetect(integer detect)function

  If detect is TRUE, enables VolumeDetect (object becomes phantom and physical objects/avatars can pass through it). Triggers collision_start on initial intersection and collision_end when intersection stops (standard collision events are suppressed while intersecting).

• collision_start(integer num_detected)event

  Triggered when an avatar or another object first begins colliding with the object containing the script. Passes num_detected, representing the number of detected collisions.

• collision(integer num_detected)event

  Triggered continuously while an avatar or another object is colliding with the object containing the script. Passes num_detected, representing the number of detected collisions.

• collision_end(integer num_detected)event

  Triggered when an avatar or another object stops colliding with the object containing the script. Passes num_detected, representing the number of detected collisions.

• sensor(integer num_detected)event

  Triggered when objects matching constraints of llSensor or llSensorRepeat are successfully detected. Passes num_detected, representing the number of detected targets.

• no_sensor()event

  Triggered when active sensors (from llSensor or llSensorRepeat) complete a scan without finding any matching targets.