llTeleportAgent

Warning: This function is still under development and is subject to change at any time.

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

TeleportAgent

llTeleportAgent

Summary

Function: llTeleportAgent( key avatar, string landmark, vector position, vector look_at );

	Forced Delay
	Energy

Requests a teleport of avatar to a landmark stored in the object's inventory. If no landmark is provided (an empty string), the avatar is teleported to the location position in the current region. In either case, the avatar is turned to face the position given by look_at in local coordinates.

• key	avatar	–	The key of the avatar for which to request a teleport.
• string	landmark	–	The name of a landmark in the object's inventory; landmarks may be used to teleport to any valid location in Second Life. This string may be left blank for teleporting within the same region.
• vector	position	–	The position within the local region to teleport the avatar to if no landmark was provided.
• vector	look_at	–	The position within the target region that the avatar should be turned to face upon arrival.

This call requires PERMISSION_TELEPORT, which must be requested with llRequestPermissions.

Caveats

• Use of this call requires the target avatar to have granted PERMISSION_TELEPORT, which must be requested using llRequestPermissions.
• Sitting avatars cannot be teleported using this function.

Examples

Without a landmark in the object's inventory <lsl>key teleportee;

default {

   state_entry()
   {
       llSay(0, "Touch to teleport");
   }

   touch_start(integer total_num)
   {
       teleportee = llDetectedKey(0);
       llRequestPermissions(teleportee, PERMISSION_TELEPORT);
   }
   
   run_time_permissions(integer perm)
   {
       if(PERMISSION_TELEPORT & perm)
       {
           llTeleportAgent(teleportee, "", <13.0, 38.0, 23.5>, <13.0, 12.0, 23.5>);
       }
   }

} </lsl> With a landmark in the objects inventory <lsl> key teleportee;

default {

   state_entry()
   {
       llSay(0, "Touch to teleport");
   }

   touch_start(integer total_num)
   {
       teleportee = llDetectedKey(0);
       llRequestPermissions(teleportee, PERMISSION_TELEPORT);
   }
   
   run_time_permissions(integer perm)
   {
       if(PERMISSION_TELEPORT & perm)
       {
           llTeleportAgent(teleportee, "Experience Tools 1", <0.0, 0.0, 0.0>, <0.0, 0.0, 0.0>);
       }
   }

}

</lsl>

See Also

Functions

• llRequestPermissions

Deep Notes

Signature
function void llTeleportAgent( key avatar, string landmark, vector position, vector look_at );