This addon contains no in-game configuration and is instead configured by editing values in the Lua files. If you are not comfortable doing this and require in-game configuration, this addon may not be for you. There are no current plans to add any in-game configuration.
Changes for 5.0/MoP
As of version 0.9, options are now moved into a separate file called options.lua. Also, you may specify overrides for the default options in options_override.lua if you wish. Doing so may make upgrading versions easier by electing to keep your override file between versions.
QuestKing is a complete replacement for Blizzard's objective tracker frame. It is designed to be simple, compact and unobstrusive while supporting all the (in my opinion) important features of the Blizzard alternative, plus some of its own.
QuestKing is visually inspired heavily by QuestGuru_Tracker, and philosophically inspired by both QuestGuru_Tracker and its predecessors (such as bEQL). However, QuestKing is written from scratch, with no dependencies, and keeping in mind the requirements of a quest tracker in WoW 5.0. I've also attempted to keep CPU and memory usage relatively low.
The following features from the Blizzard frame ARE supported:
New for 5.0! Scenario stage progress and criteria
New for 5.0! Challenge mode support, including medal timers and criteria
Notifications for automatically completable quests (New feature since WoW 4.0)
Notifications for automatically received quests (New feature since WoW 4.0)
Timers for timed quests
Timers for timed achievements
Quest item buttons
Automatic quest tracking (uses Blizzard setting)
The following features from the Blizzard frame ARE NOT supported:
Filtering the list based on your current zone
Manual or proximity-based sorting
Map POI buttons on the tracker itself (POIs still exist on world/mini map)
I may or may not support more of these in future (POIs would be nice but I find the icons rather obstrusive, and collapsable headers are a decent substitute for the first two).
Furthermore, QuestKing provides:
Highly compact design
Notifications when looting items that begin a quest (based on itemID)
3 different view modes (quests only, achievements only, and a combined mode)
Colour-coded quests and objectives according to level and completion state
Collapsible zone/category headers
Collapsible quest/achievement objectives
Custom positioning, including toggling between preset positions
Customisable size, positioning, font and colours
And with the optional but included QuestKingSounds standalone addon:
Quest progress sounds
All options are configured by editing values in Lua files. A list of all default options is shown in options.lua, with comments provided next to many variables in case their name is not sufficiently descriptive. You may edit options directly in options.lua if you wish, but you should also consider using options_override.lua to override just the defaults that you want to change. This should make upgrading to new versions easier in the future.
At the very least, you will almost certainly want to change the default position of the tracker by editing the "positionPresets" table. Each table there represents the arguments to the SetPoint that will determine the tracker's position.
Quests are coloured according to their difficulty, with some exceptions. Completed quests are coloured bright blue. Failed quests are coloured purple. Quests with no valid objectives are coloured pale green, indicating a probable "connector" quest (a quest that doesn't need to be "completed" but rather simply requires you to visit some other questgiver, often in another zone or area). Objectives are coloured fading from red to green as they are completed, then finally pale purple at completion (to make it easy to distinguish between a 100/100 objective and a 99/100 objective). Many of these colours are configurable in Lua should you wish to do so.
QuestKing comes with a bundled addon, QuestKingSounds, providing sound alerts for objective progress, completed objectives, and completed quests. This addon is entirely seperate from QuestKing and neither depends on the other. You may freely choose not to install QuestKingSounds. If you do want to use it, you may configure it in the same way QuestKing is configured by looking at options.lua and options_override.lua.
In-Game Tracker Usage
Mode Button [Q/A/C button]:
- [Left click] to cycle between quest (Q) and achievement (A) view mode.
- [Right click] to cycle into combined (C) mode, where achievements are shown under their own header.
Collapse Button [+/- button]:
- [Left click] to toggle collapsing the tracker.
- [Right click] to cycle the tracker between alternative position presets.
Automatic Quest Popups:
- [Left click] to open.
- [Right click] to dismiss.
- [Left click] to collapse.
- [Left click] to open.
- [Right click] to set active quest. (Quests only. Sets minimap arrow. Blizzard UI may override when opening the map.)
- [Shift] + [Left click] to link to chat. (Must have chat editbox open.)
- [Alt] + [Left-click] to collapse objectives. (Achievement objectives will temporarily uncollapse if a timer is detected on one.)
- [Alt] + [Right-click] to stop tracking this quest/achievement.
You may use the slash command /qkreset to reset the collapsed state of all quests, achievements and headers.
Bugs / Other
This is a relatively new addon, so please forgive any bugs (and please tell me about them should you find them). Also, the addon is not currently locale independent in a few of its functions (e.g. getQuestTaggedTitle). Any ideas/code for improvements in terms of efficiency are welcome. Feature requests are also welcome, but keep in mind I intend to keep this addon as slim as possible for my own purposes and am extremely unlikely to add in-game options, etc.
- TOC back to 50001 (the correct number).
- Made tooltip scale fix more robust.
- Added "tooltipScale" option. Set to nil to disable all scaling adjustments.
- Added "subzoneHeuristicHighlight" option for simple heuristic-based quest subzone highlighting.
- Will now attempt to restore the previous GameTooltip scale instead of setting it to 1 after the tooltip is hidden.
- Cleaned up options_override.lua.
- Added support for Legendary and Account quest tags.
- showCompletedObjectives can now be set to "always" to show objectives even
for complete quests.
- TOC version to 50004.
- Separated options out into options.lua and options_override.lua. Changing
your options in options_override.lua should allows for easier version
upgrades by keeping your options_override.lua between versions.
- Small code clean-up.
- Fix for new event SCENARIO_CRITERIA_UPDATE.
- Added separate font config option for challenge mode timer
- Added medal icons next to challenge mode timer
- Added platinum medal support (not currently used in game)
- Updated list of quest-starting items
- Changed challenge timers to more closely reflect the in-game medal colours
- Changed challenge timers to use an abbreviated time format (no hours unless
needed, no leading 0s)
- Changed the way completed scenarios are dislayed, allowing scenario quests
to continue to appear
- Adjusted challenge timer rounding to cause less resync jitter
- Scenario and challenge objectives now obey showCompletedObjectives
- Challenge timers now obey updateRate throttling for OnUpdate time/bar
- Fixed bug causing achievement timers to ignore updateRate throttling after
- (Internal) Cleaned up use of WatchButton:Get -> WatchButton:GetNext
- Added support for scenarios and scenario quests
- Added support for challenge modes, including medal timer
- Fixed 5.0 achievement bitmask bug
- Fixed 5.0 bug caused by present but nil objectives (e.g. 250 Mark of the
World Tree quests, Research Project: the Mogu Dynasties)
- Fixed delayed update not occurring when item buttons were hidden due to
layout check instead of button reset.
- Changed parent of item buttons to UIParent to prevent them being hidden
indirectly due to the parent button being hidden. Should hopefully also help
with taint problems.
- Fixed a bug that could cause Blizzard's tracker to reappear in some cases
(e.g. when visiting a barber)
- Fixed a possible taint issue that could happen when quest item buttons were
updated during combat. As a result, item buttons that would be created during
combat won't appear during combat, and item buttons that already exist may be
misaligned if quests are moved/hidden/completed during combat. The tracker
will wait until combat ends and force an update, adding or realign any buttons
that combat prevented.
- Removed a debug line.
- Re-added QuestKingSounds to archive (was mistakenly not packaged in 0.61).
- Fixed a bug that could cause the tracker to not update immediately or cause
an error occasionally when receiving an automatic quest.
- TOC updated to 4.3
- Added ability to disable quest item buttons
- Added a work-around for very rare, very obscure bug related to quest log
items being in an incorrect order (true cause remains unknown)
- Added quest-starting item popups (simple implementation based on predefined
itemID list and CHAT_MSG_LOOT)
- New colour for guild achievements