Events

Description

Events are triggers to script execution. Each event has a specific format and parameters, and when triggered, it runs the corresponding code block in the script.

default
{
    // Event: triggered by the start of agent clicking on task
    touch_start(integer num_detected)
    {
        llResetTime();
    }

    // Event: triggered when agent stops clicking on task
    touch_end(integer num_detected)
    {
        llSay(0, "You held the mouse button down for " + (string)llGetTime() + " seconds");
    }
}

Events do not interrupt each other, but instead are queued first in first out, though the state_entry event can jump the queue. If more that 64 events are waiting, new events are discarded until free slots become available.

If the script is paused, such as when an object is taken to inventory, pending events are preserved and handled the next time the object is rezzed.

On state change, the event queue is cleared and any open listens are removed automatically. Reoccurring sensor events do not reoccur in the new state and must be manually re-enabled (via llSensorRepeat()), but timer events (from llSetTimerEvent()) do reoccur.

Table of contents

• attach( key id )
• at_rot_target( integer handle, rotation targetrot, rotation ourrot )
• at_target( integer tnum, vector targetpos, vector ourpos )
• changed( integer change )
• collision( integer num_detected )
• collision_end( integer num_detected )
• collision_start( integer num_detected )
• control( key id, integer level, integer edge )
• dataserver( key queryid, string data )
• email( string time, string address, string subject, string message, integer num_left )
• experience_permissions( key agent_id )
• experience_permissions_denied( key agent_id, integer reason )
• final_damage( integer num_detected )
• game_control( key id, integer button_levels, list axes )
• http_request( key request_id, string method, string body )
• http_response( key request_id, integer status, list metadata, string body )
• land_collision( vector pos )
• land_collision_end( vector pos )
• land_collision_start( vector pos )
• linkset_data( integer action, string name, string value )
• link_message( integer sender_num, integer num, string str, key id )
• listen( integer channel, string name, key id, string message )
• money( key id, integer amount )
• moving_end()
• moving_start()
• not_at_rot_target()
• not_at_target()
• no_sensor()
• object_rez( key id )
• on_damage( integer num_detected )
• on_death()
• on_rez( integer start_param )
• path_update( integer type, list reserved )
• remote_data( integer event_type, key channel, key message_id, string sender, integer idata, string sdata )
• run_time_permissions( integer perm )
• sensor( integer num_detected )
• state_entry()
• state_exit()
• timer()
• touch( integer num_detected )
• touch_end( integer num_detected )
• touch_start( integer num_detected )
• transaction_result( key id, integer success, string data )