# LootRoute

> A World of Warcraft gathering automation framework and bot, written in Lua and run in-game by the WGG unlocker by Volvox.

## Docs

- [Architecture](https://docs.lootroute.volvox.bot/architecture.md): Load order, the runtime contract, and how the framework and bot layers fit together.
- [Changelog](https://docs.lootroute.volvox.bot/development/changelog.md): Release history for LootRoute by Volvox.
- [Conventions](https://docs.lootroute.volvox.bot/development/conventions.md): Code style, commits, changelog maintenance, and the release process.
- [Tooling](https://docs.lootroute.volvox.bot/development/tooling.md): Static linting and formatting — the only verification layer for this repo.
- [Configuration](https://docs.lootroute.volvox.bot/framework/configuration.md): volvox.Config — the per-character JSON persistence layer.
- [Events](https://docs.lootroute.volvox.bot/framework/events.md): volvox.EventHandler — the game and combat-log event dispatcher.
- [GUI builder](https://docs.lootroute.volvox.bot/framework/gui-builder.md): volvox.GuiBuilder — the declarative settings-page DSL built on StdUi.
- [Interface](https://docs.lootroute.volvox.bot/framework/interface.md): The settings window, minimap button, global status toggles, and /volvox slash commands.
- [Logging](https://docs.lootroute.volvox.bot/framework/logging.md): volvox:Logger, per-level helpers, and limited bootstrap fallbacks.
- [Modules](https://docs.lootroute.volvox.bot/framework/modules.md): volvox.Module — the base class every feature registers through.
- [Runtime](https://docs.lootroute.volvox.bot/framework/runtime.md): volvox:Init(), the OnTick/OnUpdate loops, tick modes, and callback registration.
- [Utilities](https://docs.lootroute.volvox.bot/framework/utilities.md): WGG-first API resolution and WoW secret-value unwrapping.
- [Configuration](https://docs.lootroute.volvox.bot/gatherer/configuration.md): Every gatherer.* config key, its default value, and what it controls.
- [File map](https://docs.lootroute.volvox.bot/gatherer/file-map.md): Per-file responsibilities of the Gatherer layer, in load order.
- [Overview](https://docs.lootroute.volvox.bot/gatherer/overview.md): The Gatherer bot layer — how the framework registration and bot core fit together.
- [Routes and data](https://docs.lootroute.volvox.bot/gatherer/routes-and-data.md): Route files, blacklists, whitelists, and the per-expansion node databases.
- [State machine](https://docs.lootroute.volvox.bot/gatherer/state-machine.md): The Status and State globals that drive the Gatherer bot, and the Routine() dispatcher.
- [Introduction](https://docs.lootroute.volvox.bot/index.md): LootRoute by Volvox is a World of Warcraft gathering automation framework and bot, written in Lua and run in-game by the WGG unlocker.
- [Installation](https://docs.lootroute.volvox.bot/installation.md): Load LootRoute inside World of Warcraft through the WGG unlocker.
- [Quickstart](https://docs.lootroute.volvox.bot/quickstart.md): Open the settings window, pick a route, and start your first gathering run.