Quester Forever

All addon interface text, messages and diagnostics are in English. Quest titles,

objective text, NPC names and item names come from the game and retain the client's

language. Localized quest detection remains supported.

Quest locations appear on the world map and nearby on the minimap: quest givers,

turn-in points and objective areas use distinct icons with tooltips. Quester checks

the available map APIs at runtime and uses client quest POIs or waypoints when

provided. It also remembers the player's nearby position when visiting a quest NPC,

separately by client build and language. These visited positions are approximate;

remembered quest givers do not guarantee current quest availability. Hidden quests

are excluded and completed quests no longer show remembered giver markers. Enemy

names alone never create a position. Minimap markers require usable map dimensions

and player coordinates; unsupported or inaccessible APIs leave those markers absent.

Client TOCs

`Quester.toc` is the main TOC and fallback. The sibling TOCs are alternative

entry points selected by the client's game type; they are not loaded by the main

TOC and do not include one another. Keep the addon folder named `Quester`.

| TOC | Client | Interface |

| --- | --- | --- |

| `Quester_Mainline.toc` | Retail | 120105 |

| `Quester_Vanilla.toc` | Classic Era, Hardcore, Season of Discovery | 11509 |

| `Quester_TBC.toc` | Burning Crusade Classic, Anniversary | 20506 |

| `Quester_Wrath.toc` | Wrath Classic | 30405, 38002 |

| `Quester_Cata.toc` | Cataclysm Classic | 40402 |

| `Quester_Mists.toc` | Mists of Pandaria Classic | 50504 |

| `Quester_Forever.toc` | Forever | 16001 |

| `Quester_Camelot.toc` | Forever under the Camelot game type | 16001 |

Each TOC initially loads the existing modules in the same order and uses

`QuesterDB`. To build a different interface for an edition, change that TOC's

file list, for example replacing `window.lua` or `settings.lua` with an

edition-specific implementation. Preserve the namespace functions used by the

other modules and keep `quester.lua` last. Apply common module changes to all

relevant TOCs, including the main fallback; keep the Forever/Camelot lists aligned.

Adding an interface number alone does not port the addon to that client.

Retail, Era, TBC, Mists and Forever interface numbers were checked against the

local installation's `.build.info`; Wrath and Cata values match the installed

QuestieDB TOCs. Update these headers when targeting newer patches. The Blizzard

UI source also uses game-type-specific loading for edition-specific files:

First Use

1. Restart WoW if the addon does not yet appear in the addon list; otherwise use /reload.

2. Enable Quester in the addon list.

3. Under /macro → General Macros, drag the global QuesterTarget macro onto your action bar.

4. The compact bar displays one 30-pixel icon for each detected enemy target. Left-click an icon to target that enemy; its name and quest progress are shown in the tooltip. Drag the handle on the left to reposition the bar, and right-click the handle to collapse or expand it. The handle remains visible while collapsed, and the state is saved. /quester hide hides the entire bar; /quester shows it again.

5. For collection quests, target a suitable enemy or mouse over it. If its tooltip contains an open quest objective that can be matched unambiguously, the actual NPC name appears as a target icon and in the macro.

6. Talk to a quest giver: available quests are selected and accepted automatically. Hold Shift to keep quest acceptance manual.

Use /quester priority to list active quests, /quester priority <exact quest name or ID> to prioritize one, and /quester priority clear to restore quest log order. The priority is saved account-wide. Prioritized enemies appear first in both the bar and macro, and their icon numbers have an asterisk. Icon progress shows the sum of known counters for that enemy across its unfinished objectives; individual counters remain visible in tooltips.

The macro is updated whenever quest data changes. During combat, updates are delayed until combat ends. Each click searches open enemy objectives in priority order, then quest log order and stops at the first existing living target. The previous target selection is cleared first. The macro does not start an attack.

Hover over the bar handle to see objective completion counts and up to eight unfinished objectives without a detected enemy target. /quester objectives lists every unfinished objective, including collection and exploration goals. Objectives with multiple learned enemies are counted once.

Commands

Command Effect

/quester or /quester show Show target icons

/quester hide Hide target icons

/quester hide <name/ID> Hide one quest's targets and items; save the exclusion account-wide

/quester show <name/ID> Restore a hidden quest

/quester hidden [clear] List active and hidden quests, or restore all hidden quests

/quester exclude quest [ID/name] Exclude a quest from automatic acceptance and turn-in

/quester exclude npc [ID/name] Exclude all quests at an NPC from automation

/quester sell [on/off] Toggle automatic grey-item sales at merchants (off by default)

/quester exclude item ID/name Protect an item from automatic sale

/quester allow item ID/name Remove an item sale exception

/quester exclude item <ID/name> Protect an item from automatic selling

/quester allow quest|npc|item [ID/name] Remove an automation exception

/quester exceptions [clear] List saved automation exceptions, or remove them all

/quester objectives List unfinished objectives and show completion counts

/quester priority [name/ID/clear] List quests, prioritize one, or clear the priority

/quester inspect Open a copyable diagnostic report for the targeted NPC

/quester debug Print original objective text and detected names in chat

/quester status Show help, settings, and the number of omitted targets

/quester auto on / /quester auto off Explicitly enable/disable automatic quest acceptance and turn-in

/quester resume Clear the error lock; then talk to the quest giver again

/quester turnin Toggle automatic quest turn-in only

/quester auto Toggle automatic quest acceptance and turn-in together

/quester macro Toggle macro updates; the existing macro remains in place

/quester notify [on/off] Toggle or explicitly enable/disable a screen message when a quest becomes ready for turn-in

/quester sell [on/off] Toggle or explicitly enable/disable automatic selling of grey items at merchants

/quester trivial Also select grey/trivial quests in the selection window

/quester update Request a macro update

Quest acceptance, quest turn-in, selection of grey quests, and macro updates are enabled by default. Previously saved explicit settings are preserved. Settings and the macro are stored account-wide. The macro is populated with the objectives of the currently logged-in character. The name QuesterTarget is reserved for this addon. An old character-specific copy is removed only after the global macro has been created successfully. Afterwards, drag the global macro onto the action bar once again. If the global macro storage is full, the old copy is retained.

Turn-in notifications are disabled by default. Enable them with /quester notify on. Each quest triggers one screen message when it becomes ready, including hidden quests; unchanged status and quests already ready at login do not trigger messages. If screen messages are unavailable, the message appears in chat.

Limitations of the First Version

Automatic selling is disabled by default. Enable it with /quester sell on. Hold Shift to pause it. Locked items, quest items, items without a known vendor price, and items protected with /quester exclude item <ID or exact name> remain in your bags. Protections are saved account-wide. Remove one with /quester allow item <ID or exact name>; /quester exceptions clear removes all automation exceptions, including item protections.

Automatic repairs are disabled by default. Use /quester repair [on/off] to toggle or enable/disable them. At repair vendors, Quester uses your own gold and reports the cost or missing gold in chat. Hold Shift to pause; repairs also pause during combat.

Open Settings → AddOns → Quester, or use /quester settings, to configure quest automation, notifications, the target macro, merchant automation and the quest window. The panel also manages quest priorities, hidden quests and quest/NPC/item exceptions. Changes are saved immediately account-wide; combat-sensitive window and macro changes are deferred until combat ends.

* Enemy names are taken from localized Blizzard text for open kill objectives, including numbered placeholders and simple progress counters such as Forest Wolf: 0/8. Common English plural forms are normalized using a limited mapping, for example Kobold Workers to Kobold Worker. Other NPC names remain unchanged. For collection and kill objectives, unambiguous NPC tooltip mappings are preferred. Without such an observation, collection objectives remain unknown. World objects are not targetable enemies. /quester debug displays the objective text when needed; no external quest database is required.

* Entries provided by the quest log API are taken into account. Collapsed categories may hide objectives depending on the client. If objectives are missing, expand the categories and run /quester update.

* The macro is limited to 255 bytes. Excess targets are omitted; /quester status shows how many. Individual icons can still target enemies beyond this limit. Completed objectives free up space again.

* One free global macro slot is required. Execution always happens through your own key press or click.

* Grey quests are also selected by default; /quester trivial toggles this behavior. If you manually open the details of a grey quest, automatic acceptance will also apply; holding Shift pauses it.

* Quests ready for turn-in are opened and completed at the NPC. If there is no choice of reward, or exactly one selectable reward, it is collected automatically. If there are multiple selectable rewards or a monetary cost, manual selection or confirmation is preserved. Holding Shift pauses both acceptance and turn-in.

* Automation exceptions persist across sessions and apply to both acceptance and every turn-in step, including repeatable material hand-ins. Use an ID or exact name, or omit it to use the open quest/current NPC. Hold Shift while opening a dialogue to save an exception before automation acts. Exceptions leave other quests available for automation; manual acceptance and turn-in remain possible.

In-Game Testing

Open a quest giver with multiple quests, test the Shift interruption, accept an enemy quest, and test the macro. After progress, completion, or abandonment, the macro text should update accordingly. During combat, the text must remain unchanged and update once combat ends. /console scriptErrors 1 enables Lua error messages.

API reference: Blizzard QuestLog documentation and GossipInfo documentation, mirrored from Blizzard’s UI source code.

The icons use protected WoW action buttons. During combat, existing icons remain clickable; changes to targets, position, or visibility are applied only afterwards. The macro and icons use the same name detection logic. If there are no enemy objectives, only the small handle remains visible. The symbols are numbered target icons, not NPC portraits.

Diagnostics for Collection Quest Enemies

After /reload, target a possible loot enemy for an open collection quest and run /quester inspect. Copy the highlighted report with Ctrl+C or Cmd+C. The diagnostic window opens only through this command; Escape closes it.

The report contains the client build, language, NPC name and NPC ID, raw tooltip lines including unknown beta fields, quest log objectives, and available quest map data. Missing or failing APIs are marked accordingly. If no modern tooltip API is available, a separate tooltip is used for reading the data. If objective text has not yet loaded, briefly mouse over the NPC and try again.

The diagnostic snapshot remains in memory only until the next reload. Automatic tooltip detection runs independently of the diagnostic window.

Learned Quest Targets

Quester monitors target changes and mouseover units. In the Forever Tooltip, a quest heading (type 17, quest ID) links the following objective lines (type 8) to a quest. A mapping is stored only if exactly one open collection or kill objective from that active quest matches the tooltip text after removing the progress counter. The NPC must be attackable; its actual name and NPC ID are used.

Mappings are stored account-wide in QuesterDB.learnedTargets, separated by client build and language. Multiple NPC types can be associated with a single objective. Completed or abandoned quests no longer provide active macro targets, but the mapping remains stored for future acceptance or for other characters. New beta builds are learned again from scratch.

Quester learns the quest association displayed by the game, not drop chances or a complete loot table. Unknown NPC types are recognized only after an encounter. Missing, conflicting, or inaccessible tooltip data does not create a mapping. The macro and protected icons are updated during combat only after combat ends.

If quest acceptance or turn-in was disabled, use /quester auto on, then talk to the NPC again. /quester debug additionally displays the most recent automation action. Dialogue actions are delayed briefly and discarded if the quest window is closed or the active quest changes.

Protection Against Failed Quest Loops

If the client reports a full inventory, full quest log, or an item limit after an automatic action, Quester pauses quest acceptance and turn-in. In addition, the same action for the same quest will not be repeated without confirmed success. Cancelling discards pending actions and prints a single notification in chat.

Once the inventory has actually been relieved — through more free slots or fewer items — or space has been freed in the quest log, the lock is removed automatically. If the quest dialogue is still open, processing continues automatically; if it has been closed, simply talk to the NPC again. Inventory events that do not change available space, and merely rearranging item stacks, do not trigger another attempt. If the action fails again, Quester pauses until space is freed again. During combat, continuation is delayed until combat ends. /quester resume remains available as an optional manual reset.

TomTom Quest Navigation (Retail)

Optional and disabled by default. In Settings → AddOns → Quester, enable

"Send the highlighted quest target to TomTom", or use `/quester tomtom on`.

Disable it in the same panel or with `/quester tomtom off`. The setting is

saved account-wide. TomTom must also be installed and enabled. It is declared

as an optional dependency: Quester still loads without it. Enabling navigation

without TomTom displays an explanatory chat message and status in Quester's

options rather than an addon loading error.

Quester follows the quest currently highlighted by Blizzard's quest helper,

using `C_SuperTrack.GetSuperTrackedQuestID()` and

`C_QuestLog.GetNextWaypoint()`. If no waypoint is supplied, it tries the

quest's native map POI. It checks for changes every half second and creates

one temporary arrow waypoint without adding extra map/minimap markers.

The arrow shows the quest name on the first line and the game's waypoint

text below it. If no waypoint text is supplied, the remaining quest objectives

are shown instead; if neither is available, only the quest name is shown.

Completion and turn-in destinations follow the data supplied by the game;

Quester does not choose the geographically nearest quest or calculate a route.

When there is no active quest target or no usable coordinates, its waypoint

is removed. Disabling the feature removes only Quester's waypoint.

Keep only one automatic TomTom arrow integration enabled at a time;

RestedXP-TomTom or TomTom's closest-quest integration can select other targets.

Quester selects the arrow when its target changes; it does not continuously

reclaim an unchanged target after another addon or a manual waypoint takes over.

TomTom's own arrow visibility and corpse priority settings still apply.

This first implementation is loaded only by `Quester_Mainline.toc`, which

also declares TomTom as an optional dependency. Other TOCs do not load the

integration or show its settings; the Forever port will be added separately.

`/quester debug` prints the navigation status and, when available, quest ID,

map ID and coordinates. Retail verification: enable the option, highlight a

quest in Blizzard's tracker, check the TomTom arrow, switch quests, progress

to a new objective/turn-in, then disable the option. Also test a manual map

pin, missing TomTom, and simultaneous arrow integrations. In-game behavior

still requires verification; mocked API tests do not establish client compatibility.

API source: Blizzard-generated QuestLog and SuperTrack documentation mirrored at