Difference between revisions of "LlTeleportAgentHome"

From Second Life Wiki
Jump to navigation Jump to search
(Object owner must be land owner. If land is deeded to group, object must be deeded to same group)
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(18 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{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 5: Line 6:
|func=llTeleportAgentHome
|func=llTeleportAgentHome
|p1_type=key
|p1_type=key
|p1_name=agent
|p1_name=avatar
|func_desc=Teleports '''agent''' on owner's land to their home location without any warning, similar to a [[God Summon]] or dieing.
|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=<pre>
|examples=
// by Cory Bjornson
<source lang="lsl2">
 
default
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)
}
    {
        key id = llDetectedKey(0);
 
        llTeleportAgentHome(id);
    }
}
}
</pre>
</source>
|helpers
|helpers
|also_functions
|also_functions=
{{LSL DefineRow||[[llEjectFromLand]]|}}
{{LSL DefineRow||[[llTeleportAgent]]|}}
{{LSL DefineRow||[[llTeleportAgentGlobalCoords]]|}}
|also_tests
|also_tests
|also_events
|also_events
Line 35: Line 42:
|cat2=Security
|cat2=Security
|cat3=Avatar
|cat3=Avatar
|cat4
|cat4=Teleport
|}}
|}}

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