ATTENTION

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.

Description

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:

• Quest tracking
• Achievement tracking
• 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:

• Collapsible tracker
• 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

Options

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.


Colours

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.


QuestKingSounds

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.

Headers:
- [Left click] to collapse.

Quests/Achievements:
- [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.