# nearby_avatars

:::warning
**Deprecated:** Use `nearbyavatars_scan` command instead. Reports avatars nearby to the bot.

:::

# Incoming and outgoing parameters

The input parameters are sent to your HTTP script along with this event. Output parameters (if any) should be generated by your script.

## Input parameters

| Parameter | Required | Value |
|-----------|----------|-------|
| action    | yes      | = nearby_avatars |
| bot_name  | yes      | the SL name of your bot |
| channel   | yes      | the unique bot id |
| cid       | yes      | internal HTTP connection identifier (you can ignore this value) |

## Input parameters specific for `nearby_avatars`

| Parameter | Required | Description |
|-----------|----------|-------------|
| avatars   | yes      | The nearby avatars (see format below) |
| heading   | yes      | Bot's heading (direction it looks), degrees |
| location  | yes      | Bot's current location, Region/X/Y/Z |

# Avatars list format

The list of avatars is separated by a newline. Each entry includes:

* UUID
* Full SL name
* X
* Y
* Z

Each item is separated by a semicolon `;`.

## **Example**

```
417732f0-a100-4e2d-a9bf-e381cfd12c3a;CuteGuide Resident;128;12;20
```