Difference between revisions of "LlTeleportAgent"

From Second Life Wiki
Jump to navigation Jump to search
Line 8: Line 8:
|p2_type=string|p2_name=region
|p2_type=string|p2_name=region
|p3_type=vector|p3_name=pos
|p3_type=vector|p3_name=pos
|p4_type=rotation|p4_name=rot
|p4_type=vector|p4_name=look_at
|func_desc=Teleports agent <code>avatar</code> to location <code>pos</code> within <code>region</code>, with a rotation given by <code>rot</code>.
|func_desc=Teleports agent <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>.
|return_text
|return_text
|spec
|spec

Revision as of 11:14, 13 October 2010

Emblem-important-yellow.png LSL Feature Request
The described function does not exist. This article is a feature request.

Summary

Function: llTeleportAgent( key avatar, string region, vector pos, vector look_at );
REQUEST Function ID
0.1 Forced Delay
10.0 Energy

Teleports agent avatar to location pos within region, turning the avatar to face the position given by look_at.

• key avatar
• string region
• vector pos
• vector look_at

Caveats

  • This function causes the script to sleep for 0.1 seconds.
  • This function requires PERMISSION_TELEPORT to be granted, this permission is auto-granted when requested for an avatar wearing or sat upon the scripted object, or if the requested avatar is on land owned by the scripted object's owner. Do not rely on the auto-grant feature of the permission, instead always make proper use of the run_time_permissions() event.
    • This function will silently fail if requested for an avatar that is no longer on land with the same owner as the scripted object. This is a special case for objects on land only; attachments and sat upon objects will teleport normally.
  • Same-region teleports are instantaneous, however all teleports are throttled such that a request will silently fail if made within 5 seconds of a previous teleport completing.
  • Upon completion of a teleport the user will receive a teleport complete notice in chat as normal, this will include a "Block" link that will revoke an object's teleport permissions, detaching if necessary, allowing avatars to quickly and easily block malicious teleport requests.
All Issues ~ Search JIRA for related Bugs

Examples

Notes

This would be extremely useful in complex builds such as Stargates, HUDS and other teleportation creations. NOTE: look_at is included to match llMapDestination's look_at possible future functionality, which currently does nothing.

  • See SVC-212 for the JIRA listing for this function.

Deep Notes

Search JIRA for related Issues

Signature

//function void llTeleportAgent( key avatar, string region, vector pos, vector look_at );