View source for User:Haravikk Mistral/llTeleportAgent

{{Issues/VWR-23580}}
{{Issues/SCR-16}}
{{LSL_Function
|func_id|mode=request
|func_sleep=0.0
|func_energy=10.0
|func=llTeleportAgent
|sort=TeleportAgent
|p1_type=key|p1_name=avatar|p1_desc=The key of the avatar for which to request a teleport.
|p2_type=string|p2_name=region|p2_desc=The region to teleport the avatar to. Provide with an empty string, or the name of the current region, for a local teleport.
|p3_type=vector|p3_name=pos|p3_desc=The position within the region to teleport the avatar to. If the value of the X or Y component is less than 0.0 or greater than or equal to 256.0, then a local teleport will become a global one.
|p4_type=vector|p4_name=look_at|p4_desc=The position within the region that the avatar should be turned to face upon arrival.
|func_desc=Requests a teleport of <code>avatar</code> to location <code>pos</code> within <code>region</code>, turning the avatar to face the position given by <code>look_at</code>. Providing an empty string for <code>region</code> requests a local teleport, and is identical to explicitly providing the name of the current region.
|return_text
|spec
|caveats=* This function sends requests to an agent's viewer, compatible with calls to [[llMapDestination]]() in unsupported viewers.
* By default, viewers that permit automatic teleportation will do so if:
** The scripted object is worn by the avatar being teleported.
** The scripted object belongs to the land-owner of the parcel that the avatar is currently within, and the requested teleport is a local one.
* Other requests, or all requests for viewers that have disabled automatic teleportation, will trigger a dialogue giving details of the teleport request.
* This function is throttled at 10 requests per every 30 seconds by the simulator, and 1 per every 20 seconds in supported viewers.
|examples=<lsl>default {
    key teleportedAgent;

    touch_start(integer x) {
        llTeleportAgent(teleportedAgent = llDetectedKey(0), "", <128.0, 128.0, 25.0>, <129.0, 128.0, 25.0>);
        llSetTimerEvent(30.0);
    }

    timer() {
        // Is the teleported avatar still nearby?
        vector pos = llList2Vector(llGetObjectDetails(teleportedAgent, [OBJECT_POS]), 0);
        if ((pos == ZERO_VECTOR) || (llVecDist(llGetPos(), pos) > 10.0)) {
            // Teleport request appears to have been accepted
        } else {
            // Teleport request appears to have been refused
        }

        llSetTimerEvent(0.0);
    }
}</lsl>
|helpers
|related
|also
|notes=Please see [[User:Haravikk Mistral/llTeleportAgent/Draft]] for the full draft specification.
}}