# llTeleportAgentHome

*LSL function*

```lsl
void llTeleportAgentHome(key avatar);
```

- `key avatar`: UUID of the avatar to teleport.

- Delay: 5 s
- Energy: 100

Teleports the avatar (who must be standing on land owned by the script owner) directly to their designated home location without warning (similar to a God Summons).

Teleports **avatar** on owner's land to their home location without any warning, similar to a [God Summons](https://wiki.secondlife.com/wiki/God_Summons) or [dying](https://wiki.secondlife.com/wiki/death).

```lsl title="How to use" frame="terminal"
llTeleportAgentHome(NULL_KEY);
```

## Examples

<details open>
<summary>Example 1</summary>

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

</details>

## Known issues

From the issue templates included by the wiki article:

- SVC-212 (nf): New Feature Request - **llTeleportAgent**
- SVC-6360 (fs): Estate managers should be able to use llTeleportAgentHome()

## See also

### Functions

- [llEjectFromLand](/functions/llEjectFromLand/)
- [llTeleportAgent](/functions/llTeleportAgent/)
- [llTeleportAgentGlobalCoords](/functions/llTeleportAgentGlobalCoords/)

---

*Source: [LlTeleportAgentHome](https://wiki.secondlife.com/wiki/LlTeleportAgentHome) on the Second Life Wiki. Content from the Second Life Wiki articles LlTeleportAgentHome (revision 1194355, 2015-01-22), Template:Issues/SVC-212 (revision 1170440, 2012-07-10), Template:Issues/SVC-6360 (revision 1171021, 2012-07-28), Template:LSL Function/avatar (revision 1179236, 2013-06-15) and Template:LSL Function/security (revision 1171159, 2012-07-28), CC BY-SA 3.0.*

---

From lsl.dev: https://lsl.dev/functions/llTeleportAgentHome/