Skip to main content
Most Gatherer settings live in volvox.Config under the gatherer.* namespace. Defaults are declared once in Gatherer/Module.lua via volvox.Config:SetDefault; the runtime mirrors those keys into bot-core globals through SyncFromFrameworkConfig in Gatherer/ConfigUI.lua.
Call sites can use short, typo-resistant keys through the global GathererConfigKeys table (e.g. GathererConfigKeys.enabled"gatherer.enabled") together with volvox.Gatherer:GetSetting(key, default) / :SetSetting(key, value).

Core

KeyDefaultPurpose
gatherer.enabledfalseMaster on/off for the bot
gatherer.enable_herbalismtrueGather herb nodes
gatherer.enable_miningtrueGather ore nodes
modules.singleButtonAssistantfalseSingle Button Assistant module toggle (seeded here)
modules.singleButtonAssistant is a module toggle, not a gatherer.* key. It is listed here because Gatherer/Module.lua seeds it alongside Gatherer defaults.

Routes and movement

KeyDefaultPurpose
gatherer.route""Selected route name
gatherer.new_route_name""Name for a route being recorded
gatherer.new_route_radius50Waypoint radius for recorded routes
gatherer.mount_mode"Random"Mount selection strategy
gatherer.fly_form"Random"Flight form selection
gatherer.flight_speed20Flight speed
gatherer.gatherrange500Maximum node pickup range
gatherer.use_nav_serverfalseUse the navigation server for pathing

Scanning

KeyDefaultPurpose
gatherer.scan_interval0.35Seconds between object scans
gatherer.object_scan_range250Object scan radius
gatherer.max_scan_objects160Object scan cap
gatherer.ignore_mid_herbfalseSkip Midnight herb nodes
gatherer.ignore_mid_orefalseSkip Midnight ore nodes
gatherer.ignore_mid_fishfalseSkip Midnight fishing nodes

Node filtering and blacklisting

KeyDefaultPurpose
gatherer.blacklist_radius5Radius for position blacklist entries
gatherer.whitelist_radius5Radius for position whitelist entries
gatherer.temp_blacklist_failed_gathertrueTemporarily blacklist nodes after a failed gather
gatherer.failed_gather_timeout5Seconds before a gather attempt counts as failed
gatherer.failed_gather_blacklist_ttl120TTL for the failed-gather blacklist
gatherer.depleted_node_ttl600TTL for depleted-node tracking
gatherer.skip_submerged_nodesfalseSkip underwater nodes
gatherer.skip_cave_nodesfalseSkip cave nodes
gatherer.skip_inaccessible_undergroundtrueSkip nodes buried underground
gatherer.underground_skip_depth12Depth threshold for underground skip
gatherer.underground_retry_ttl60Retry TTL for skipped underground nodes

Combat and safety

KeyDefaultPurpose
gatherer.mobrange0Mob avoidance radius around nodes
gatherer.avoid_herb_mobsfalseAvoid mobs near herb nodes
gatherer.avoid_ore_mobsfalseAvoid mobs near ore nodes
gatherer.avoid_elite_mobstrueAvoid elite mobs
gatherer.kill_wild_node_mobsfalseKill mobs guarding wild nodes
gatherer.mob_block_blacklist_attempts2Attempts before blacklisting a mob-blocked node
gatherer.mob_block_retry_ttl45Retry TTL for mob-blocked nodes
gatherer.flee_timeout12Seconds before flee gives up
gatherer.fight_acquire_range45Target acquisition range in combat
gatherer.fight_move_range6Melee approach distance; combat chase keeps moving until target-coordinate distance is within this range
gatherer.resume_gather_after_combattrueReturn to the interrupted node after combat
gatherer.resume_gather_ttl60TTL for the resume-gather memory
gatherer.loot_killed_mobstrueLoot or harvest mobs killed in combat, including wild-node guardian corpses
gatherer.loot_killed_mobs_range30Loot search radius

Death recovery

KeyDefaultPurpose
gatherer.dead_scan_units120Unit scan cap while dead
gatherer.dead_scan_objects160Object scan cap while dead
gatherer.spirit_healer_range350Spirit Healer search radius for ghost recovery pathing

Overload and mounted gathering

KeyDefaultPurpose
gatherer.overload_herbfalseOverload herb nodes
gatherer.overload_orefalseOverload ore nodes
gatherer.overload_wild_herb_onlyfalseOnly overload wild herb nodes
gatherer.overload_wild_ore_onlyfalseOnly overload wild ore nodes
gatherer.lambent_overloadfalseOverload Lambent nodes
gatherer.plant_resilient_seedtruePlant resilient seeds
gatherer.mounted_gathercomputedtrue only when gatherer.mount_mode is "Druid" at registration
gatherer.mounted_gather_attempts3Mounted gather retry attempts

Consumables

KeyDefaultPurpose
gatherer.use_phialsfalseUse phials; ITEMUSE defers while in combat or near an enemy
gatherer.use_potionsfalseUse potions
gatherer.use_haranir_perception_phialtrueUse Hara’nir Perception phial
gatherer.use_tool_enhancementsfalseUse tool enhancements
gatherer.use_refulgent_razorstonetrueUse Refulgent Razorstone
gatherer.use_midnight_foodstrueUse Midnight foods
gatherer.use_azeroot_teatrueUse Azeroot tea
gatherer.use_argentleaf_teafalseUse Argentleaf tea
gatherer.use_sanguithorn_teafalseUse Sanguithorn tea
gatherer.use_midnight_mulchtrueUse Midnight mulch before herb gathers — picks the best owned, enabled, usable, off-cooldown tier in priority order: Empowered Mulch (238389), Imbued Mulch (238388), Magical Mulch (238387)
gatherer.use_firewaterfalseUse firewater
gatherer.use_knowledge_itemstrueUse profession knowledge items
gatherer.auto_mid_herb_kpfalseAuto-spend Midnight herbalism knowledge points
gatherer.auto_mid_mining_kpfalseAuto-spend Midnight mining knowledge points

Miscellaneous

KeyDefaultPurpose
gatherer.anti_afkfalseAnti-AFK nudge
gatherer.anti_afk_interval55Anti-AFK interval in seconds
gatherer.show_statusfalseShow the on-screen status frame
gatherer.debug_scanfalseEnable debug logging