What is the use of llTeleportAgent?

[Dora Gustafson]

What is the use of llTeleportAgent() ?
It can only teleport the object owner:(

It is true! I had to test it because I couldn't believe my eyes.

What is the use and what is the purpose?

[Sassy Romano]

If they own the object, such as a hud, then it works fine.

If they don't own the object, they'd need to accept permissions in any other implementation which could be done but sounds like it isn't.

[Innula Zenovka]

I'm still hoping -- possibly without much good cause -- that, once LL is satisfied all the bugs with permissions are sorted out, they'll revert to letting the object tp anyone who gives it permission.   That was, as I recall, how it worked on Magnum before they had to roll it back after the fiasco a few weeks ago.

 

[Jenni Darkwatch]

Right now it seems like it's fairly useless for any kind of public teleporter like for example the stargate network. Worse, you can't give people a temp HUD since it specifically excludes that as well.

I suppose in group RP it could be useful if everyone had a HUD/attachment that'd teleport the owner, and a central "server" that just communicates the target destinations.

My hope is that it's a temporary restriction. But since LL isn't talking... I'm not holding my breath. Classic communication fail - again.

[Loki Eliot]

Currently yud have to do a work around where llAttachToAvatarTemp attaches a HUD or object that contains the llTeleportAgent script then trigger the attached object by some means?

[Dora Gustafson]

---

Loki Eliot wrote:

Currently yud have to do a work around where llAttachToAvatarTemp attaches a HUD or object that contains the llTeleportAgent script then trigger the attached object by some means?

---

Temporary attach with llAttachToAvatarTemp will not work with llTeleportAgent

What we have got is this function:

llTeleportOwner( string landmark, vector position, vector look_at );

Agent == Owner; always

[Cerise Sorbet]

They are OK as placeholders for development. Remember that these functions are really made to go with the experience permission system that has not been released yet.

[Jenni Darkwatch]

There is actually one use for it at the moment... RLV teleports without the need of an RLV client. I've just used that to write a stargate-HUD that allows me to just walk through stargates, no clicky needed. All I did was listen for the RLV TP command. Not really a secure way to do it, good enough for testing though.

[Pat Perth]

Here's a use:

 

Rez a box.

Put a script in it that calls llTeleportAgent.

Open a door

Put the box next to the door

Viola. The door stays open!

[Mars Tamale]

I agree its of little use without allowing the obvious, but I'd like to throw in another "wish".  That is, if the landmark name is a region and not an inventory item then that region plus the co-ords are used to TP the av to that position in that region. That way we can teleport anywhere without the need to create a LM and update the object - I think that would be a requirement for the Stargate to work properly too.

[Qie Niangao]

See llTeleportAgentGlobalCoords() ... which reminds me: I don't see why I'd ever need llTeleportAgent when I have the -GlobalCoords() version, together with llRequestInventoryData() ... unless maybe at one time there was to have been some distinction in permissions required.

(ETA: Now thinking it may not be obvious: use llRequestSimulatorData() to get global coords for a sim name.)

[Innula Zenovka]

Yeah, there is a way but it's not pretty at all, and it's complicated by the fact that LL apparently broke the MapAPI cap (see also this discussion)

Anyway, here's how I ended up extracting the target vectors from a landmark, when I can't be sure what the landmark is going to be called:

 

key gLandmarkQuery;key gLocationCoordsQuery;key gWebQuery;vector gGlobalCoordinates;vector gRegionCoordinates;vector coordinates;default {    touch_start(integer num_detected) {        if (llGetInventoryNumber(INVENTORY_LANDMARK)) { // got a landmark?            gLandmarkQuery = llRequestInventoryData(llGetInventoryName(INVENTORY_LANDMARK, 0));        }    }    dataserver(key queryid, string data) {        if (queryid == gLandmarkQuery) {            coordinates = (vector)data + llGetRegionCorner();            gGlobalCoordinates = coordinates / 256;            string coordsX = (string)((integer)gGlobalCoordinates.x);            string coordsY = (string)((integer)gGlobalCoordinates.y);            gWebQuery = llHTTPRequest(//uses Tyche Shepherd's Gridsurvey.com API                "http://api.gridsurvey.com/simquery.php?xy="+coordsX+","+coordsY+"&item=name",                [],""                    );        }        else if (queryid == gLocationCoordsQuery){            llOwnerSay("location coords are "+data);            gGlobalCoordinates =(vector)data;            gRegionCoordinates.x = (integer)coordinates.x - (gGlobalCoordinates.x);            gRegionCoordinates.y = (integer) coordinates.y - (gGlobalCoordinates.y);            gRegionCoordinates.z = (integer) coordinates.z;            llOwnerSay("region coordinates are "+(string)gRegionCoordinates);            llRequestPermissions(llGetOwner(),PERMISSION_TELEPORT);        }    }    run_time_permissions(integer permissions)    {        if(permissions & PERMISSION_TELEPORT){            llTeleportAgentGlobalCoords(llGetOwner(),gGlobalCoordinates,gRegionCoordinates,ZERO_VECTOR);        }    }    http_response(key request_id, integer status, list metadata, string body) {        if (request_id == gWebQuery) {            llOwnerSay(body);            if(llGetSubString(body,0,4)=="Error"){                llOwnerSay("Unknown Region");                return;            }            string destination = llDumpList2String(llParseString2List(body,["+"],[])," ");            gLocationCoordsQuery = llRequestSimulatorData(destination,DATA_SIM_POS);        }    }}

 

[Qie Niangao]

Oh, I'm far too lazy for that.  How 'bout this?

key landmarkQueryID;key teleportee;vector globalCoords;vector regionCoords;default{    touch_start(integer total_number)    {        string landmarkName = llGetInventoryName(INVENTORY_LANDMARK, 0);        if ("" == landmarkName)            llWhisper(DEBUG_CHANNEL, "No landmark");        else        {            teleportee = llDetectedKey(0);  // as if it could be anybody but owner            landmarkQueryID = llRequestInventoryData(landmarkName);        }    }    dataserver(key queryid, string data)    {        if (landmarkQueryID != queryid)            return;        vector coords = (vector)data + llGetRegionCorner();        regionCoords = <(float)((integer)(coords.x) % 256), (float)((integer)(coords.y) % 256), coords.z>;        globalCoords = coords - regionCoords;        llRequestPermissions(teleportee, PERMISSION_TELEPORT);    }    run_time_permissions(integer perms)    {        if (PERMISSION_TELEPORT & perms)            llTeleportAgentGlobalCoords(teleportee, globalCoords, regionCoords, ZERO_VECTOR);    }}

 

(Embarrassed to ask at this late date: How do you all get the snazzy syntax highlighting on embedded code samples? I must have been out sick the day they taught that. :matte-motes-bashful-cute:)

[Innula Zenovka]

Thanks, Qie.   I was trying to do it your way, but I couldn't get the region coordinates to calculate properly.   I will take another look at my unsuccessful attempts and find out where I was going wrong.

The fancy highlighting is courtesy of Cerise and her LSL posting tool script for Greasemonkey.

[DanielWildcat]

These functions should probably be renamed to llTeleportOwner and llTeleportOwnerGlobalCoords since, "Agent" implies ANY agent.

[Jenni Darkwatch]

_Supposedly_ they'll be more useful with the "Experience permission system", whenever that comes and whatever that is. I would not hold my breath if I were you.