> ## 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.

# Installation

> Load LootRoute inside World of Warcraft through the WGG unlocker.

## Requirements

* **World of Warcraft (Retail)** with the **WGG** unlocker installed. There is no standalone runtime — the addon only runs inside the game through WGG.
* **No build step, package manager, or test runner.** The repository is loaded as-is.

## Install

<Steps>
  <Step title="Place the repository">
    Put the repository where WGG loads its scripts.
  </Step>

  <Step title="Verify the load manifest">
    Ensure `loadorder.json` is present at the repository root. It is the manifest WGG reads to load every file in the correct order — a Lua file that is not listed there never loads.
  </Step>

  <Step title="Launch the game">
    Start World of Warcraft with WGG. Once in-game, open the settings window via the minimap button or by typing `/volvox`.
  </Step>
</Steps>

## Data locations

LootRoute reads and writes data under Windows paths used by WGG's file API:

| Path                                                                       | Purpose                                                                |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `C:/WGG/scripts/Gatherer`                                                  | Bundled scripts and routes (`route/<name>.json`)                       |
| `C:/WGG/GathererData`                                                      | User-writable persistent data (for example, automatic blacklist files) |
| `C:/WGG/scripts/LootRoute/DemonGUISettings<CharacterName><RealmName>.json` | Per-character JSON settings; realm whitespace is stripped              |

<Note>
  Settings are stored through [`volvox.Config`](/framework/configuration) and namespaced with dotted keys (e.g. `gatherer.enabled`, `general.tickrate`, `modules.gatherer`). Edit them through the in-game settings window rather than by hand.
</Note>