Events

at_rot_target

Triggered when the script's rotation (ourrot) comes within a defined angle (error) of the target rotation (targetrot) set by a call to llRotTarget (which returns the associated handle).

at_target

Triggered when the scripted object's position (ourpos) comes within the defined range of the target position (targetpos) set by llTarget (which returns the associated handle tnum).

attach

Triggered whenever the object is attached to or detached from an avatar. Passes the UUID key of the avatar if attached, or NULL_KEY if detached.

changed

Triggered when various properties of the object change. The parameter changes is a bitfield of CHANGED_* flags.

collision

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

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

collision_start

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.

control

Triggered to pass captured avatar control inputs into the script. The parameter level indicates held controls, and edge indicates change in controls (both are bitfields of CONTROL_* constants).

dataserver

Triggered when requested data is returned to the script (e.g., from llRequestAgentData, llRequestInventoryData, or llGetNotecardLine).

email

Receive an email requested by llGetNextEmail(). NumberRemaining indicates the number of emails remaining in the queue for llGetNextEmail() to retrieve.

experience_permissions

Triggered when the agent specified by agent_id approves an experience permissions request (interactively or automatically if previously approved).

experience_permissions_denied

Triggered when the agent specified by agent_id denies experience permissions, or when permission is blocked for other reasons (specified by the error code reason).

final_damage

Triggered after all on_damage events across all scripts have completed and damage is actively applied to the avatar or distributed among seated avatars. Collision detected functions (llDetected*) and llDetectedDamage are available.

game_control

Triggered when a compatible viewer sends game controller input changes for the avatar specified by id. Only triggers for scripts in attachments or seats.

http_request

Triggered when the script's registered URL receives an incoming HTTP request identified by request_id.

http_response

Triggered when an HTTP response body is received for a pending request_id, or if the request fails or times out.

land_collision

Triggered in the root prim when a physical object or attached avatar is colliding with the ground at position pos.

land_collision_end

Triggered in the root prim when a physical object or attached avatar stops colliding with the ground at position pos.

land_collision_start

Triggered in the root prim when a physical object or attached avatar first begins colliding with the ground at position pos.

link_message

Triggered when the script receives a link message from sender_num, containing the parameters num, str, and id sent via llMessageLinked.

linkset_data

Fires in all scripts in the linkset whenever the datastore has been modified via an llLinksetData function. Passes the action taken, the affected key name, and the new value.

listen

Triggered when a chat message matching active llListen filters is received on channel. Passes the sender's name and UUID key id, along with the spoken string msg.

money

Triggered when a resident specified by id pays an amount of Linden dollars (L$) to the prim.

moving_end

Triggered whenever the physical or moving object containing the script stops moving.

moving_start

Triggered whenever the physical or moving object containing the script starts moving.

no_sensor

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

not_at_rot_target

Triggered continuously while the object's rotation is outside the leeway angle of targets set via llRotTarget.

not_at_target

Triggered continuously while the object's position has not yet reached the range of targets set via llTarget.

object_rez

Triggered when this object successfully rezzes another object from its inventory. Passes the key (UUID) id of the newly rezzed object.

on_damage

Triggered when damage has been inflicted on an avatar or task, but before it is applied or distributed. Collision detected functions (llDetected*), llDetectedDamage, and llAdjustDamage are available. Passes num_detected, representing the number of pending damage events.

on_death

Triggered on all worn attachments when the wearing avatar's health reaches 0.

on_rez

Triggered when the object is rezzed into the world (by a script or user). Passes start_param from the rezzing call (or 0 if rezzed from inventory). Also triggers on attachments during login or when attached from inventory.

path_update

Triggered to inform the script of changes or failures in the pathfinding character's status.

run_time_permissions

Triggered when an agent grants or denies runtime permissions requested by llRequestPermissions. Passes the active integer permissions bitfield perm (returns 0 if no permissions are currently granted).

sensor

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

state_entry

Triggered immediately whenever a new state is entered (including at script start). It is always the first event handled.

state_exit

Triggered when the state command is used to transition out of the current state. Handled before entering the new state's state_entry.

timer

Triggered at regular periodic intervals configured by llSetTimerEvent.

touch

Triggered continuously while an avatar touches the object. Passes num_detected, representing the number of touching agents.

touch_end

Triggered when an avatar stops touching the object. Passes num_detected, representing the number of touching agents.

touch_start

Triggered when an avatar first touches the object. Passes num_detected, representing the number of touching agents.

transaction_result

Triggered when an asynchronous L$ transfer (such as llTransferLindenDollars) is completed. Passes transaction info id, success status, and CSV or error data.