llTeleportAgent

From Second Life Wiki
Revision as of 16:35, 8 December 2007 by Argent Stonecutter (talk | contribs)
Jump to navigation Jump to search
Emblem-important-yellow.png LSL Feature Request
The described function does not exist. This article is a feature request.

Summary

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

Teleports agent id to location pos.

• key id
• string simname
• vector pos
• vector look_at

Caveats

  • This function causes the script to sleep for 0.1 seconds.Agent must be the script owner or must be on script owner's land (or the script owner is a member of the land group for group-owned land). Repeated teleports within a short period should be suppressed.
All Issues ~ Search JIRA for related Bugs

Examples

Notes

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

Deep Notes

Search JIRA for related Issues

Signature

//function void llTeleportAgent( key id, string simname, vector pos, vector look_at );

Notes

  • Target agent should ignore subsequent calls to llTeleportAgent within a modest time limit (5 seconds, say), to prevent it from being used for a repeat-teleport trap. This timeout should be per-agent, applied to any script attempting to teleport the agent using this call within that period, and the script need not be informed.
  • If the sim name is empty, target is the same sim, and the "teleporting" screen is not interposed (ie, it's equivalent to WarpMove, except without sitting on a prim).