llTeleportAgentGlobalCoords

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

TeleportAgentGlobalCoords

llTeleportAgentGlobalCoords

	Pre-release Documentation Warning!
	This function is only available in RC LeTigre channel. This documentation was written prior to its final release so it may not match the final implementation.

Summary

Function: llTeleportAgentGlobalCoords( key agent, vector global_coordinates, vector region_coordinates, vector look_at );

	Forced Delay
	Energy

Teleports an agent to set of a region_coordinates within a region at the specified global_coordinates. The agent lands facing the position defined by look_at local coordinates. A region's global coordinates can be retrieved using llRequestSimulatorData(region_name, DATA_SIM_POS)

• key	agent	–	avatar UUID that is in the same region (avatar to be teleported)
• vector	global_coordinates	–	Global coordinates of the destination region. Can be retrieved by using llRequestSimulatorData(region_name, DATA_SIM_POS).
• vector	region_coordinates	–	Destination position inside the target region, given in local coordinates.
• vector	look_at	–	Location avatar will face after completing the teleport, given in local coordinates.

To run this function the script must request the PERMISSION_TELEPORT permission with llRequestPermissions and it must be granted by agent. The combination of llRequestSimulatorData and llTeleportAgentGlobalCoords allows agents to be teleported to regions by region name.

Caveats

Permissions

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. If the script lacks the permission PERMISSION_TELEPORT, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). If PERMISSION_TELEPORT is granted by anyone other than agent, then when the function is called an error will be shouted on DEBUG_CHANNEL. Once the PERMISSION_TELEPORT permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.

• This function cannot be used in a script in an object attached using llAttachToAvatarTemp.
• Sitting avatars cannot be teleported using this function. You must llUnSit them first.

Examples

<lsl> string simName = "Help Island Public"; vector landingPoint = <128.0, 128.0, 24.0>;

key avatarToBeTeleported; vector globalSimCoordinates;

default {

   on_rez(integer start_param)
   {
       llResetScript();
   }

   state_entry()
   {
       llRequestSimulatorData(simName, DATA_SIM_POS);
   }

   touch_start(integer total_number)
   {
       avatarToBeTeleported = llDetectedKey(0);

       if (globalSimCoordinates == ZERO_VECTOR)
       {
           llRegionSayTo(avatarToBeTeleported, PUBLIC_CHANNEL, "Configuration error, teleport request has been denied. Please try again!");
           llResetScript();
       }
       else
       {
           llRegionSayTo(avatarToBeTeleported, PUBLIC_CHANNEL, "Teleporting you to: http://maps.secondlife.com/secondlife/" + llEscapeURL(simName) + "/" + (string)llRound(landingPoint.x) + "/" + (string)llRound(landingPoint.y) + "/" + (string)llRound(landingPoint.z) + "/");
           llRequestPermissions(avatarToBeTeleported, PERMISSION_TELEPORT);
       }
   }

   run_time_permissions(integer perms)
   {
       if (perms & PERMISSION_TELEPORT)
           llTeleportAgentGlobalCoords(avatarToBeTeleported, globalSimCoordinates, landingPoint, ZERO_VECTOR);
       else
           llRegionSayTo(avatarToBeTeleported, PUBLIC_CHANNEL, "Teleport failed, you didn't grant permissions. Please try again!");

       llResetScript();
   }

   dataserver(key query_id, string data)
   {
       globalSimCoordinates = (vector)data;
   }

}

</lsl>

See Also

Events

•

run_time_permissions

–

Permission receiving event

Functions

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llRequestSimulatorData	–	Useful for requesting simulator position
•	llTeleportAgent	–	Teleporting agents to a landmark or position in the region.

Articles

•

Script permissions

Deep Notes

Signature
function void llTeleportAgentGlobalCoords( key agent, vector global_coordinates, vector region_coordinates, vector look_at );