Skip to main content
LootRoute by Volvox is a World of Warcraft gathering bot (herbalism, mining, and fishing) written in Lua. It runs inside the game, loaded by the third-party WGG unlocker. The project has two layers:
  • The framework — the shared volvox table: a module system, per-character JSON config store, in-game settings UI (built on the bundled StdUi toolkit), minimap button, event/combat-log dispatcher, and logging.
  • The LootRoute bot — the flagship plugin built on the framework: route following, node scanning, combat handling, flight and skyriding, and quality-of-life tasks such as mailing and repairs.
Automating gameplay with an unlocker violates the World of Warcraft Terms of Service and can result in account suspension or a permanent ban. This project is provided for educational purposes; use it at your own risk.

​
How it works

WGG loads each Lua file listed in loadorder.json at the repository root, in order, invoking every file with two varargs: 
local WGG, volvox = ...
  • WGG — the unlocker API: object scanning, movement, protected calls, tracelines, HTTP, and file I/O. See the WGG API documentation.
  • volvox — the shared framework table threaded through every file. It is the bus for all cross-file state and services.
Main.lua loads last and starts the runtime via volvox:Init().

​
Explore the docs

Installation

Get LootRoute loading through WGG.

Quickstart

Open the settings window and start your first gathering run.

Architecture

Load order, the runtime contract, and how the layers fit together.

LootRoute bot

The state machine, routes, node databases, and configuration.

Framework reference

Full API reference for every volvox.* service.

Development

Static tooling, conventions, and the release process.

​
Authoritative external references

ReferenceUse for
WGG API docsEvery unlocker call — names, parameters, returns, failure behavior
Wowpedia WoW APIStandard World of Warcraft API functions
WowheadEvery numeric game ID — items, GameObjects, spells, NPCs, zones