llTeleportAgentHome

From Second Life Wiki
Revision as of 19:38, 3 October 2012 by Strife Onizuka (talk | contribs)
Jump to navigation Jump to search

Summary

Function: llTeleportAgentHome( key avatar );

Teleports avatar on owner's land to their home location without any warning, similar to a God Summons or dying.

• key avatar avatar UUID that is in the same region

Generally, the object owner must also be the land owner but there is an exception for land deeded to a group for group members with the "Eject and freeze Residents on parcels" ability. See #Ownership Limitations for details.

Specification

Ownership Limitations

  • If the land under the object is owned by an individual, the script must be owned by the same individual.
  • If the land under the object is deeded to a group the object will need to satisfy one of the following:
    • The object is deeded to the same group.
    • The object owner must have "Eject and freeze Residents on parcels" ability in the group and be connected to the sim[1].

Caveats

  • This function causes the script to sleep for 5.0 seconds.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> default {

   state_entry()
   {
       // floattext is red and opaque
       llSetText("Don't touch me!", <1.0, 0.0, 0.0>, 1.0);
   }
   touch_start(integer num_detected)
   {
       key id = llDetectedKey(0);
       llTeleportAgentHome(id);
   }

}

</lsl>

See Also

Deep Notes

All Issues

~ Search JIRA for related Issues
   New Feature Request - llTeleportAgent
   Estate managers should be able to use llTeleportAgentHome()

Footnotes

  1. ^ The script owner need not be in the region, they can be a child agent of the region.

Signature

function void llTeleportAgentHome( key avatar );