Interface

​

Theme

​

Palette

• volvox.Theme.font = { family = UNIT_NAME_FONT or STANDARD_TEXT_FONT, size = 12, titleSize = 18, headerSize = 14 }
• volvox.Theme.spacing = { gutter = 20, pad = 12, sectionGap = 18, labelGap = 20 } — column gutter, outer window inset, extra gap above section headers, and headroom reserved above widgets with TOP labels.
• volvox.Theme.size = { windowWidth = 900, windowHeight = 560, titleHeight = 44, sidebarWidth = 170, sidebarEntryHeight = 28, sidebarSubEntryHeight = 24, sidebarGroupLabelHeight = 24 } — the settings window and sidebar geometry.

​

Helpers

---@param name string           -- palette entry name (e.g. "accent")
---@param alphaOverride number|nil
---@return number r, number g, number b, number a
function volvox.Theme:Get(name, alphaOverride)

---@param name string
---@param alphaOverride number|nil
---@return table color          -- { r = , g = , b = , a = }
function volvox.Theme:Table(name, alphaOverride)

---@param name string
---@return string hex           -- e.g. "007aff"
function volvox.Theme:Hex(name)

​

Settings window

• General (Interface/Layout/General.lua) — tick mode and tick rate.
• Modules (Interface/Layout/Modules.lua) — enable/disable toggles for every registered module.

​

Sidebar API

---@param parent table   -- the settings window
---@param width number   -- sidebar width in pixels
---@return table sidebar
function volvox.Sidebar:Create(parent, width)

​

Opening it

---@return nil
function volvox.OpenSettings()

​

Single Button Assistant

​

Slash commands

---@param name string                 -- sub-command keyword (stored lowercased)
---@param handler fun(args: string)   -- called with the remaining argument string
---@param description? string
Macro:RegisterCommand(name, handler, description)

​

Minimap button

• Left click — toggle the settings window (opens it when ready if the frame isn’t built yet).
• Right click — dropdown menu: Enable Bot / Disable Bot (calls volvox.Gatherer:Start() / volvox.Gatherer:Stop()), Settings, Hide Minimap Button (persisted; restore via /volvox minimap), and Close.
• Draggable — position persists to the MinimapButtonPosition config key.

​

Global status toggles

---@param options table   -- must include `label` and `var`
---@return table|nil toggle
function volvox:AddGlobalToggle(options)

• Lazily creates the singleton volvox.GlobalStatusFrame (icon bar with a trailing settings gear button, drag/lock, hover styling) on first call. The frame is colored from volvox.Theme: background bg0 at 0.85 alpha, enabled icons accent, disabled icons muted at 0.6, hover bg2 at 0.9, borders and separators border at 0.9, and the lock icon tinted success (unlocked) / danger (locked).
• Returns nil if label or var is missing; returns the existing toggle if one with the same var already exists.
• Toggle state persists per-var in a separate JSON file, scripts/LootRoute/DemonStatusFrame.json (independent of volvox.Config), which also stores frame position and lock state and can read legacy scripts/Gatherer/DemonStatusFrame.json / configs/Demon/DemonStatusFrame.json files.