AutoQuestLearner

Standalone quest addon · Interface 3.3.5

AutoQuestLearner

A quest addon that learns the world by playing it. It points you to your next objective, remembers where things are, and gets a little smarter every time someone quests with it.

Alliance & Horde supported

No pfQuest or Questie required — fully self-contained.

What it does

Everything a leveling run needs, self-contained

Ships with its own bundled coordinate database, then keeps correcting and filling it in from your own play.

Smart navigation arrow

Points you toward your next quest objective or turn-in automatically — no separate addon needed to know which way to walk.

Learns as you play

Quest giver, turn-in, and objective locations are saved to a shared learned database, filling gaps in the bundled data over time.

Nearby quest suggestions

Filtered by level range, real bitwise faction checks, reputation requirements, and completion history checked against the server — not just what this addon has seen before. Chain prerequisites are respected too, including "must complete all/any of these," "only while another quest is active," and mutually exclusive siblings, plus quests that need a specific item in hand before they'll even let you interact.

Share what you've learned

Live sync with your party, raid, or guild applies newly learned locations in real time — kill/collect spawn points included, not just quest givers and turn-ins. No group? /aql export and /aql import trade your whole learned history with another player anytime — never overwriting what you already have.

Live kill-tracking

Kill something in a spawn cluster and its dot disappears until it would plausibly be back, instead of showing a static cluster regardless of what's actually alive right now. Respawn timing starts as a reasonable guess and gets more accurate over time as the addon learns each NPC's real interval from repeated observation.

Snooze any quest

/aql sleep pulls an available-to-pick-up quest out of rotation — on every character on the account — until you wake it back up whenever you're ready.

Multi-floor detection

Standing right on the pin with nothing there usually means a floor above or below. Confirm it once and the addon remembers — applied to every other point in that same spawn cluster too, not just the one spot.

Self-correcting gating

PvP-flag and reputation requirements aren't documented anywhere for this server — so the addon learns them directly from the game's own error messages the first time you actually hit one, and stops suggesting that objective until it's genuinely possible again.

Zone-only tracker view

Optional filter to show only quests relevant to the zone you're actually standing in, instead of every tracked quest across every zone stacked on top of each other. Pinned quests always stay visible regardless.

Quest item buttons

A small movable panel puts the icon for "use this on the objective" items, like an Essence Extractor, one click away.

Hand-verified travel routes

Cross-zone quests get a real route or a precise checkpoint for the arrow to aim at, instead of a generic "fly there."

In-game quest tracker

A tracker panel that can stand in for Blizzard's default one, built to match everything else the addon already knows.

Map & minimap nodes

Quest givers and objectives show up right on the map and minimap, clustered so a busy zone stays readable.

Route planner

Suggests an order to tackle your active quests, clustering nearby ones so you clear an area instead of backtracking.

Zone completion tracking

See how many known quests you've finished in your current zone, and what's still left to pick up.

Quest chain preview

Shows the next quest in a chain, when one is known, right as you're about to turn something in.

Multi-language quest data

Quest titles, descriptions, objectives, NPC names, and zone names are available in German, French, Korean, Portuguese, Russian, Spanish, and Chinese, matched automatically to your client's own language — with a graceful fallback to English wherever a given language's data doesn't cover something yet.

Outline spawn areas

Optional map display mode: kill-objective hunting grounds for your currently tracked quest can show as a shaded area instead of a dot cluster. Gathering nodes (herbs, ore, etc.) always keep precise individual pins, since those are fixed spots, not a wandering creature's general territory.

Alliance & Horde

Both factions are fully supported, with the same learning database shared underneath.

Note: class-restricted quests aren't suggested for pickup by default, even for a matching class, since this server's custom class roster means extra requirements those quests often carry can't be reliably verified.

Reference

Slash commands

Everything is reachable from /aql. The most useful ones day-to-day are learn, route, and config. Click a heading below to expand the rest — most people never need to.

Core
/aql, /aql status
Short status summary and the essential command list, in chat. /aql help all shows everything.
/aql guide
Opens the in-game how-to-use guide (also runs automatically on first install).
/aql config
Opens the settings panel, with quick buttons for Guide, Route, Zone, and Chain.
/aql learn [quest name]
Saves your current location as an objective or turn-in for that quest — the main way bad data gets corrected.
/aql missing
Reports that a quest giver the arrow just sent you to genuinely isn't there — run it standing on the spot.
/aql sleep [questID]
Stops an available (not-yet-picked-up) quest from being suggested, on every character, until woken back up.
/aql wake [questID|all]
Undoes a sleep. With no argument, wakes whatever the arrow's currently pointing at.
/aql sync
Check location-sharing status with party/raid/guild, and how many locations you've received/applied this session.
/aql export
Get a copyable text string of everything you've learned, to share with another player running this addon.
/aql import
Paste someone else's export string to add their learned locations to yours. Never overwrites anything you already have.
/aql route
Suggests an order to tackle your active quests, clustering nearby ones together.
/aql zone
Shows how many known quests you've completed in your current zone.
/aql chain [quest name]
Shows the next quest in the chain. Uses your pinned quest if no name is given.
/aql suggestzone
Suggests which zone to level in next, based on your level, race, and faction — following the same progression established Classic leveling guides use.
/aql tracker
Toggles this addon's own quest tracker panel.
/aql unpin
Clears a pinned quest, returning the arrow to auto-select. Alt+Right-Click does the same.
More settings & tools
/aql db
Breakdown of the shared learned database — quest count, NPC count, and more.
/aql learnedstats
Shows how much has actually been learned so far, account-wide, all characters combined.
/aql floor up|down|clear
While standing on an unresolved pin, teaches the arrow which way the real spot actually is — applied to that whole spawn cluster, not just the one point.
/aql proximity
Toggles automatic proximity-based objective learning (on by default).
/aql focus
Shows only what the arrow is tracking, instead of everything known nearby.
/aql blizztracker
Toggles Blizzard's default quest tracker.
/aql map
Forces an update of map nodes.
/aql scan
Forces an immediate proximity scan for nearby quest givers.
/aql opendb [questID]
Opens that quest on the Ascension Database in your browser.
/aql announceparty
Toggles announcing quest accept/complete/abandon in party/raid chat (off by default).
/aql announcepartyprogress
Toggles announcing kill/loot progress (e.g. "4/8") in party/raid chat (off by default, separate from the above).
/aql questitemtooltip
Toggles showing quest progress on item tooltips, anywhere an item tooltip shows up (on by default).
/aql lock
Toggles locking the tracker's position/size so it can't be accidentally dragged or resized.
/aql availrange [number]
Sets how far the arrow will look for an available quest to auto-suggest (default 20).
/aql availrangeactive [number]
Same, but specifically while you already have a real active-quest objective to head toward (default 5, tighter).
Advanced & rarely needed
/aql learnnotify
Toggles the automatic "Learned a new spawn point" chat notification (on by default).
/aql learnedstatsauto
Toggles showing the learned-stats summary automatically every login/reload (on by default).
/aql trackascension
Toggles whether Ascension's own custom-added quests get suggested for pickup at all (off by default).
/aql trackclassquests
Toggles whether class-restricted quests get suggested for pickup at all, even for a matching class (off by default).
/aql zonenudge
Toggles the one-time-per-zone nudge suggesting where to go next once a zone's known quests are mostly done.
/aql zonefilter
Toggles showing only current-zone quests in the tracker. Pinned quests and unknown-location quests always show.
/aql pvprequired [clear]
Lists quests flagged as needing a PvP flag to interact with, learned from the game's own error message.
/aql reprequired [clear]
Lists quests flagged as needing more reputation than you currently have, same idea as above.
/aql unavailable [clear]
Lists quests the addon learned were never actually offered despite passing every check, or clears that.
/aql respawntimers [clear]
Lists (or clears) learned per-NPC respawn intervals, used once observed instead of the default guess.
/aql backfillids
Re-runs the one-time NPC-identity backfill on existing learned spawns (normally runs once automatically on login).
/aql resync
Force-reloads all learned locations and refreshes map nodes.
/aql gossip
Reprocesses the currently open gossip window (rarely needed manually).
/aql calibrate [reset]
Shows minimap-scale calibration progress for starting zones that self-measure from your movement (Shadowglen, Coldridge Valley, Camp Narache, Red Cloud Mesa, Deathknell, Valley of Trials). "reset" re-measures your current zone.
Diagnostics & troubleshooting
/aql arrow
Explains exactly why the navigation arrow is or isn't showing right now.
/aql why [questID]
Explains exactly why a quest is or isn't currently showing as available.
/aql questitems
Diagnostic for the quest item button panel.
/aql debug
Prints general diagnostic info.
/aql debuglog
Toggles internal diagnostic logging to chat (off by default).
/aql killdebug
Toggles chat output for every kill's parsed NPC ID and whether a matching map node was found.
/aql clusterdebug
Toggles a visual debug overlay on the world map for cluster merging.
/aql flickerdebug
Records 5 seconds and reports tracker function calls — useful if the UI seems to flicker.
/aql perf / perfdebug
Memory and FPS-impact checks for this addon specifically.
Mouse actions
Alt + Right-Click a tracked quest
Pin or unpin the arrow to that quest.

Getting started

Installation

Download the addon and extract the zip.

Copy the AutoQuestLearner folder into your Interface\AddOns\ folder, so the path ends in ...\AddOns\AutoQuestLearner\AutoQuestLearner.toc.

Fully restart the game client the first time — a /reload isn't enough on first install.

Check that it's enabled in your AddOns list at the character select screen, then run /aql guide in-game any time.

Version history

Changelog

Every zip in downloads/ is also archived as a dated GitHub Release, so older versions stay downloadable.

hotfix August 28, 2026
  • Arrow no longer locks on every targeted NPC. Vendors, trainers, books, and quest givers were all treated as “(available)” at Distance 0.0 until you walked out of range. Available targets now only come from the real quest-giver database.
  • While your quest log has any quests, the arrow stays on objectives and turn-ins — it will not keep pointing at available pickups. Available suggestions return when the log is empty.
  • Fixed a math bug where “skip available” still matched nearby givers (maxRange -1 squared to 1).
  • TomTom-style clear on accept and quest-log change: drops the old waypoint and retargets immediately, including when another addon auto-accepts for you.
  • On accept, clears your current target so the arrow is not glued to the NPC.
  • Session arrow/available cache purged on login (no cross-character leftovers).
  • Coldridge / starting zones: minimap scale no longer uses the parent zone’s size (that made clusters crawl). Auto calibration runs on login and zone change.
  • Same-coord cluster dedupe — stacked rings from Ascension + pfQuest + learned data collapse to one pin.
  • Tracker objectives show a colored • matching the minimap ring for that objective.
  • Performance: coalesced map rebuilds on kill/loot/accept/turn-in/zone change to reduce FPS stutter.
August 16, 2026
  • Fixed a real, measured stutter: the available-quest-givers scan was walking the entire 6,600+ quest database on every quest-progress event (confirmed via /aql perfdebug: ~35ms per call). Now scoped to just your current zone — roughly 20x faster. The same fix was applied to the zone-completion nudge, which turned out to be silently doing the exact same full-database walk every 30 seconds.
  • Capped item-collection objective source lookups — a common drop item with 100+ possible sources (like cloth scraps) could fan out to thousands of coordinate checks for a single objective. Now capped at 15 sources.
  • /aql suggestzone now follows the same zone-by-level progression established Classic leveling guides use (race/faction-aware for starting zones), instead of ranking purely by known-quest count.
  • New optional map display mode, Outline Spawn Areas: kill-objective hunting grounds for your currently tracked quest can show as a shaded area instead of a dot cluster. Gathering nodes always keep precise pins, since a fixed resource node isn't the same thing as a wandering creature's general territory.
  • Fixed a real cross-character bug: a brand-new character's first encounter with an already-known NPC was incorrectly re-triggering a "Learned new location!" announcement and a redundant rewrite — the "already known" check was scoped to the current character instead of the shared account-wide database. Navigation itself was never actually broken by this, but it made the shared database look like it wasn't working. Fixing it also means a later, more accurate sighting can now correct an earlier rough one, instead of that character being permanently locked out of ever refining it.
  • Quest titles, descriptions, objectives, NPC names, and zone names are now available in German, French, Korean, Portuguese, Russian, Spanish, and Chinese, matched automatically to your client's language, with a graceful fallback to English for anything not yet covered.
  • The arrow now explains itself for a confirmed small set of quests with genuinely zero location data anywhere, instead of silently going blank — and notes that finding it in-game teaches the addon (and everyone else) automatically, same as anything else it learns.
August 2026
  • Live kill-tracking — a spawn cluster's dot for the specific mob you just killed disappears until it would plausibly have respawned. Respawn timing starts as a reasonable guess and gets more accurate over time as each NPC's real interval is learned from repeated observation (/aql respawntimers).
  • Sharing (live sync and /aql export/import) now covers kill/collect spawn points, not just quest givers and turn-ins.
  • /aql sleep — pull any available-to-pick-up quest out of rotation, on every character on the account, until you wake it back up.
  • Multi-floor detection — confirm which way a spot really is once (/aql floor up/down) and the addon remembers it for that whole spawn cluster, not just the one point.
  • PvP-flag and reputation requirements, undocumented anywhere for this server, are now learned directly from the game's own error messages the first time you actually hit one, and stop being suggested until they're genuinely possible again.
  • Optional zone-only filter for the tracker (/aql zonefilter) — show only quests relevant to your current zone. Pinned quests always stay visible regardless.
  • A self-correcting check: if an NPC's gossip window doesn't actually offer a quest despite passing every known requirement, the addon stops suggesting it rather than repeating a guess reality just disproved (/aql unavailable).
  • Map/minimap hover-highlighting and the arrow's own target selection now correctly distinguish between different objectives and different specific spawn points on the same quest, instead of grouping everything under one shared identity.
  • Darker, more legible map/minimap node colors.
July 2026
  • Share what you've learned — live location sync with party/raid/guild, plus /aql export and /aql import to trade your full learned history with anyone, no grouping required.
  • Available quest suggestions now also check reputation requirements and known chain prerequisites (ALL/ANY-of, "only while another quest is active," mutually exclusive siblings), and correctly hold back quests that need a specific item in hand first.
  • Self-calibrating minimap scale for starting zones (Shadowglen, Coldridge Valley, Camp Narache, Red Cloud Mesa, Deathknell, Valley of Trials) via the new /aql calibrate command.
July 2026
  • Initial public release: smart arrow, learned location database, quest tracker, map/minimap nodes, route planner, and quest item buttons.

Full history & downloads: GitHub Releases →

Built on the shoulders of the community

Credits

Inspired by pfQuest (created by shagu) and Questie-X (maintained by Xurkon, a fork of the original Questie project rebuilt for private servers).

A number of quest NPC gaps are filled in from the original Questie project — thanks to Aero, Logon, Muehe, TheCrux/BreakBB, Drejjmit, Dyaxler, Cheeq, TechnoHunter, and other contributors.

Precise "stand here" coordinates for zone-wide objectives are supplemented from TourGuideVanilla (by cralor, credit to Tekkub for the original framework).

A lot of what powers this addon comes from projects that had gone quiet — community databases nobody had cross-checked in years, NPC data compiled by contributors long since moved on, coordinates nobody had gone back to audit. The work here has been less about starting from scratch and more about doing the maintenance those projects needed: validating old data against independent sources, pulling exact figures from real game files instead of estimating, and fixing what had quietly drifted wrong.

Maintained by Ezinagro. This addon is a work in progress — /aql learn is how anyone playing it helps correct the shared database, permanently, for everyone.