Difference between revisions of "LlTeleportAgentHome"

From Second Life Wiki
Jump to navigation Jump to search
m
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{LSL_Function/avatar|avatar}}{{LSL Function
{{LSL Function
|inject-2={{Issues/SVC-212}}{{Issues/SVC-6360}}{{LSL_Function/avatar|avatar|sim=*}}{{LSL_Function/security|avatar}}
|func_id=158
|func_id=158
|func_sleep=5.0
|func_sleep=5.0
Line 6: Line 7:
|p1_type=key
|p1_type=key
|p1_name=avatar
|p1_name=avatar
|func_desc=Teleports '''avatar''' on owner's land to their home location without any warning, similar to a [[God Summons]] or [[death|dying]].
|func_desc=Teleports {{LSLP|avatar}} on owner's land to their home location without any warning, similar to a [[God Summons]] or [[death|dying]].
|func_footnote=The object owner must also be the land owner. If the land is deeded to a group the object will need to be deeded to the same group for this function to work.
|func_footnote
|spec
|spec
|caveats
|caveats
|constants
|constants
|examples=<lsl>default
|examples=
<source lang="lsl2">
default
{
{
state_entry()
    state_entry()
{
    {
llSetText("Don't touch me!", <1,0,0>, 5.0);
        // floattext is red and opaque
}
        llSetText("Don't touch me!", <1.0, 0.0, 0.0>, 1.0);
touch_start(integer total_number)
    }
{
 
llTeleportAgentHome(llDetectedKey(0)); // Teleports the Agent home
    touch_start(integer num_detected)
}
    {
}</lsl>
        key id = llDetectedKey(0);
 
        llTeleportAgentHome(id);
    }
}
</source>
|helpers
|helpers
|also_functions
|also_functions=
{{LSL DefineRow||[[llEjectFromLand]]|}}
{{LSL DefineRow||[[llTeleportAgent]]|}}
{{LSL DefineRow||[[llTeleportAgentGlobalCoords]]|}}
|also_tests
|also_tests
|also_events
|also_events

Latest revision as of 12:24, 22 January 2015

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

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);
    }
}

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 );