> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lootroute.volvox.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Routes

> Pick a route, record your own, and keep the bot away from bad spots with blacklists.

A **route** is a loop of waypoints LootRoute flies while looking for nodes. Routes appear in the **Route** dropdown on the **LootRoute → Active Route** page.

## Using a route

<Steps>
  <Step title="Pick it">
    Choose a route from the **Route** dropdown. If the list is empty it shows **No routes found** — record one below or install a shared route.
  </Step>

  <Step title="Load it">
    Click **Load Selected Route**. Chat confirms: `Route loaded: <name> (<N> points)`.
  </Step>

  <Step title="Run it">
    Start LootRoute. It flies the loop and gathers as it goes.
  </Step>
</Steps>

## Recording your own route

<Steps>
  <Step title="Name it">
    On the **Active Route** page under **Create Route**, type a unique name into **New Route Name** and press <kbd>Enter</kbd>. Optionally fill in the visible route details and adjust **Waypoint Radius**.
  </Step>

  <Step title="Record">
    Click **Start Recording**. Chat confirms: `Recording route '<name>'. Press F5 or Add Waypoint.`

    Fly the loop you want LootRoute to follow, pressing <kbd>F5</kbd> (or clicking **Add Waypoint (F5)**) at each point along the way. Add more waypoints around turns unless you want the route to resemble modern art.
  </Step>

  <Step title="Save">
    Click **Save New Route**. The route is saved, selected, and loaded — you're ready to start the bot. To abandon a recording instead, click **Stop Recording**.
  </Step>
</Steps>

<Tip>
  Make the last waypoint close to the first so the loop repeats cleanly.
</Tip>

### Editing a loaded route

* **Save Current Position as Waypoint** — appends where you're standing to the selected route.
* **Save Current Route** — saves the loaded route back to disk.
* **Clear Current Route** — unloads the route.

### Route names

Route names must be unique. If a name cannot be used, LootRoute explains why in chat; **Blacklist** and **Whitelist** are reserved for the position-list tools.

## Sharing routes

The **Route** dropdown tooltip shows the active route folder under your WGG Script Location. To share a route, copy its `.json` file. To install one, place the file in that folder and open the **Route** dropdown to refresh the list.

<Note>
  The same folder also holds LootRoute's position lists. They never appear in the **Route** dropdown; leave them in place when copying routes.
</Note>

## Blacklists and whitelists

Three tools keep LootRoute away from bad spots:

| Tool                            | Where             | What it does                                                                                                     |
| ------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Add Position to Blacklist**   | Active Route page | Never gather within the **Blacklist Radius** of where you're standing — good for spots that always cause trouble |
| **Add Position to Whitelist**   | Active Route page | Allow gathering within the **Whitelist Radius** of where you're standing, overriding position-based skip zones   |
| **Blacklist Current Node GUID** | Nodes page        | Permanently skip one exact node — useful for a single bugged node                                                |

LootRoute also skips nodes temporarily when they fail to gather, are depleted, are guarded by mobs it cannot clear, or sit underground. These skips expire on their own; use the [Nodes and Recovery sections](/guide/settings#nodes) if LootRoute is too stubborn or too cautious.