Minion Beta! - Help us test our new AddOn updater. Get it now!
Download
(438 Kb)
Download
Updated: 05-09-15 09:07 PM
Pictures
File Info
Compatibility:
The Adventure Continues (6.1)
Updated:05-09-15 09:07 PM
Created:07-22-11 11:47 PM
Downloads:4,974
Favorites:61
MD5:
6.1

QuestKing 2

Version: 2.2.0
by: Barjack [More]

NOTE

This addon does have some in-game configuration via slash-commands (for example, for dragging and locking the tracker). However, more detailed customization (if required) must be done by editing values in Lua files. See options.lua for more information. There are no plans to add detailed in-game configuration menus.

Description

QuestKing is a complete replacement for Blizzard's default objective tracker/quest tracker. It is designed to be simple, compact and unobstrusive while supporting all the features of the default tracker, plus some of its own.

QuestKing is inspired by old-school quest trackers like GuestGuru, bEQL and MonkeyQuest. However, QuestKing is written from scratch to be a modern objective tracker that supports not only quests, but all the new types of objectives that Blizzard has gradually added to WoW. This includes achievements, scenarios, dungeon objectives, bonus quests, timed objectives, challenge modes, proving grounds, automatic quests, and so on. I have tried to keep the tracker as efficient as possible, and it should hopefully be kind to both your CPU and memory.

The following standard objective tracker features are supported:

  • Quests! Including quest items (non-tainting and usable in combat), sequenced quests, timed quests, and notifications for automatically received/completed quests.
  • Achievements! Including guild achievements and timed achievements.
  • Scenarios! Including bonus objectives and reward animations.
  • Dungeons! Plus bonus objectives and reward animations.
  • Challenge Modes! Including a fully functional medal timer.
  • Proving Grounds! Including wave timers and endless mode scoring.
  • Bonus Objectives! Including progress bars, animations, and reward display.
  • POI Tracking! Just like the default tracker, you can click quests to set your active destination.

QuestKing also provides the following *additional* features:
  • A special notification which appears when you loot an item which starts a quest.
  • Zone/category headings whose contents can be shown or collapsed.
  • Toggleable tracker with three different levels of information display (full, contextual only, none).
  • Three different tracking display modes which you can freely toggle between (quests only, achievements only, combined).
  • Compact, space-efficient design.
  • Quests and objectives colour coded according to level, completion, progress percentage, etc.
  • Customizable position, size, colours and font.
  • Animations for various events including objective progress, new or updated quests and objectives, and so on.

And with the optional but included QuestKingSounds standalone addon:
  • Quest sounds (fully customizable, with options for quest completion, objective completion, and objective progress sounds).

Sadly, there are a couple of things QuestKing does not and probably will not support. Because QuestKing is a categorized tracker, it does not suport changing the sort order dynamically based on zone/distance. It will always show your tracked quests in the same order and category as the quest log itself. It also takes a more conservative approach to supertracking (see the section on supertracking below).

Options

QuestKing comes with a number of slash commands for basic customization. They are as follows.

/qk lock - Locks and unlocks the tracker, making it draggable.
/qk scale - Sets the tracker's scale. Default is 1. Set to 1.2 for 20% larger, etc.
/qk alpha - Sets the tracker's transparency. Default is 0.9, and valid values are 0 to 1.
/qk origin - Sets the point from which the tracker "grows". Default is TOPRIGHT. Other valid values are TOPLEFT, BOTTOMLEFT, BOTTOMRIGHT.
/qk reset - Resets all collapsed objectives and headers.
/qk resetall - Resets all QuestKing settings (global and for the current character).

Many other 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. See the comments at the top of options_override.lua for more information.

QuestKingSounds

QuestKing comes with a bundled addon, QuestKingSounds, providing sound alerts for objective progress, completed objectives, and completed quests. This addon is entirely separate from QuestKing and neither depends on the other. You can install QuestKing without QuestKingSounds, or even install QuestKingSounds by itself without using QuestKing. 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.

Colours

Quests are coloured according to their difficulty, with some exceptions. Completed quests are coloured bright blue. Completed quests that can be turned in from anywhere are dark blue. 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.

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 both are shown together (achievements are shown under their own header).

Collapse Button [+/-/x button]:
- [Left click] to toggle collapsing the tracker (+/- modes). A collapsed tracker won't show tracked quests or achievements, but it will still show important and contextual information, like dungeon objectives, quest notifications, and bonus objectives.
- [Right click] to collapse the tracker completely (x mode). A tracker in this mode will never show any information at all.
- [Shift] + [Left click] to cycle the tracker between alternative position presets (if in preset mode).
- [Mouse wheel] to fade in a tracker backdrop (helps to increase visibility).

Notifications (e.g. automatic quests, quest-starting item pickups):
- [Left click] to open.
- [Right click] to dismiss.

Headers:
- [Left click] to collapse.

Quests/Achievements:
- [Left click] to open.
- [Right click] to set active supertracked quest.
- [Shift] + [Left click] to link to chat while the chat editbox is open.
- [Shift] + [Left click] to open the quest in Classic Quest Log, if it's installed (only when chat editbox is not open).
- [Alt] + [Left click] to hide objectives.
- [Alt] + [Right click] to stop tracking this quest/achievement.

A note on supertracking

Supertracking is the term for the "actively tracked" quest whose objective is highlighted more strongly on your map and minimap, and for which a minimap arrow appears. On the default objective tracker and the default map, you do this by clicking the big circled numbers. In QuestKing, you can still use the map as usual, or you can do it by right-clicking the title of a quest (a small yellow dot will appear after the name of the actively supertracked quest). You can right click the same quest again to remove the dot and disable supertracking. Unlike the Blizzard system, you can even use this to supertrack bonus objectives or quests in other zones.

Note however that QuestKing takes a more careful approach to automatic supertracking compared to the default objective tracker. First, QuestKing strongly supports the concept of supertracking no quest at all, and will never automatically set a supertrack target if supertracking is not currently active. This means you won't get minimap arrows constantly appearing and changing around when you're not doing any questing at all. QuestKing will automatically change the supertracked quest only if you are actively questing. This is determined to be the case in three situations:

1) You complete all the objectives of a quest. In this case the closest available quest will be supertracked (which might be the turn-in of the same quest).
2) You accept a new quest. In this case also, the closest available quest will be supertracked.
3) A quest you were tracking is removed from your quest tracker. Again, the closest available quest will be supertracked.

Note that even without any quest supertracked, quest objective areas will always be available and highlighted on the map and minimap. Supertracking only sets the minimap arrow and makes the objective area stand out more.

Notes

Looking for an old-school style quest log to go with your old-school style tracker? I recommend Classic Quest Log by Gello. It's a great addon that works perfectly alongside QuestKing, without any overlapping functionality.

I would like to thank the creators and maintainers of the quest trackers who came before me. Bayi, mrobrian, Gregity, Lazare, Jim-Bim, and many others. QuestKing was heavily inspired by the appearance and functionality of these great addons. And of course, thank you to the authors of Blizzard's own objective tracker (which I referred to constantly while writing this), and to all those who helped document WoW's UI on sites like WoWProgramming and WoWpedia.

Comments, constructive feedback, and bug reports are welcome. I hope you enjoy this addon.

2.2.0
- Improved how superceding objectives are displayed (e.g. Garrison invasion point objectives). If you want the old behaviour (all objectives always visible), then set opt.hideSupersedingObjectives to false.
- Slightly increased the time bonus rewards are displayed from 7 to 10 seconds.
- Fixed how "reptutation"-style objectives are displayed to avoid truncation.
- Fixed some issues in locales that show objective description/count in reverse order (e.g. ruRU).

2.1.1
- Fixed an error that happened when the tracker queued an update for after combat.
- Changed supertracking to always check for the closest POI when accepting a quest.

2.1.0
- Added "/qk scale" to set the tracker scale.
- Added "advanced background" option for better looking backgrounds.
- Fixed the default objective tracker re-appearing after visiting the barber.
- Fixed the scenario stage objective overlay appearing twice when zoning into a scenario or dungeon. (Workaround for Blizzard bug with LevelUpDisplay.)
- Cleaned up some code.

2.0.0
- Massive re-write for WoD.
Optional Files (0)


Archived Files (15)
File Name
Version
Size
Author
Date
2.1.1
437kB
Barjack
04-12-15 11:00 PM
2.1.0
436kB
Barjack
04-12-15 07:35 AM
2.0.0
436kB
Barjack
04-06-15 03:29 AM
0.94
22kB
Barjack
08-30-12 05:13 PM
0.93
22kB
Barjack
08-30-12 02:25 AM
0.92
22kB
Barjack
08-29-12 10:49 PM
0.91
22kB
Barjack
08-29-12 10:31 PM
0.9
21kB
Barjack
08-29-12 10:14 PM
0.72
17kB
Barjack
02-17-12 06:18 AM
0.71
17kB
Barjack
02-17-12 06:05 AM
0.7
17kB
Barjack
02-17-12 05:44 AM
0.66
17kB
Barjack
12-10-11 06:08 PM
0.61
15kB
Barjack
12-03-11 01:11 PM
0.6
16kB
Barjack
08-28-11 03:21 PM
0.5
14kB
Barjack
07-22-11 11:47 PM


Post A Reply Comment Options
Unread 09-13-13, 07:40 AM  
alanm26
A Kobold Labourer

Forum posts: 0
File comments: 29
Uploads: 0
Hi. I have to say this is the best quest tracker around currently. Recently with 5.4, an issue came up with the challenge timer. It's always shown in any zone, and does not function in the new proving ground scenario. Here's a picture:

http://i.imgur.com/qEDZ8aW.jpg

I'm trying to learn enough lua to fix it and maybe add proving ground support. So far I have it hidden except in challenge modes, where it's working.
Last edited by alanm26 : 09-13-13 at 02:10 PM.
alanm26 is offline Report comment to moderator  
Reply With Quote
Unread 08-29-13, 11:12 PM  
Barjack
A Black Drake
AddOn Author - Click to view AddOns

Forum posts: 83
File comments: 58
Uploads: 7
Hey all.

Not sure how many people are still using or interested in using this addon. I've moved half way around the world and no longer even have access to a computer that can run WoW, so keeping it updated now is borderline impossible for me. I'm not sure how much has broken in the last six months.

If anyone wants to post updates here, release a fan-update style version or whatever, you have my permission to do so. Feel free to send me messages about stuff like that as well if you like. I still check back here so I can try to put up a fixed version here myself as well if people can supply any necessary fixes.

I'd love to get back up and running myself but it may be another six months before I'm able to do so.

Thanks.
Barjack is offline Report comment to moderator  
Reply With Quote
Unread 11-24-12, 10:07 AM  
THduhman
A Kobold Labourer

Forum posts: 0
File comments: 12
Uploads: 0
Great addon and love the look/feel of it. Sadly, some of us (me, HA) have issues trying to figure out how to move it and positioning and such. My first issue is I have W8, and it is not opening the options.lua with the right app...grrr. I will continue to work on it as this is the best quest log addon I have seen. Kudos!! Just right now it overlaps my minimap and other bars on the right side with my LUI addon. :-(
THduhman is offline Report comment to moderator  
Reply With Quote
Unread 09-29-12, 10:07 PM  
ollitrop
A Kobold Labourer
 
ollitrop's Avatar

Forum posts: 0
File comments: 5
Uploads: 0
Originally Posted by Barjack
Originally Posted by ollitrop
Thank you for this awesome addon!

I figured out how to move the tracker to the position I wanted, I was just wondering if you plan to add a drag to move option in the future?

Thanks again!!!
It's a slight possibility, but getting both a drag-friendly option working together with the current position presets system is more complicated than it seems at first glance, due to issues like growth direction, parent frames, etc. which is all currently handled by just growing from predefined anchor points per preset. I know that it's a little trial-and-error at the start but once your positions are in there it works very well and very unambiguously, which is not really the case when dragging is thrown into the mix.
Aye, I guess there isn't really a need for it as long as the user knows how to update the option.lua file. Again thanks for a great addon, the in game one is just too wide for my taste, this one fits like a glove!
__________________
Freedom is not free.
ollitrop is offline Report comment to moderator  
Reply With Quote
Unread 09-29-12, 09:39 PM  
Barjack
A Black Drake
AddOn Author - Click to view AddOns

Forum posts: 83
File comments: 58
Uploads: 7
Originally Posted by ollitrop
Thank you for this awesome addon!

I figured out how to move the tracker to the position I wanted, I was just wondering if you plan to add a drag to move option in the future?

Thanks again!!!
It's a slight possibility, but getting both a drag-friendly option working together with the current position presets system is more complicated than it seems at first glance, due to issues like growth direction, parent frames, etc. which is all currently handled by just growing from predefined anchor points per preset. I know that it's a little trial-and-error at the start but once your positions are in there it works very well and very unambiguously, which is not really the case when dragging is thrown into the mix.
Barjack is offline Report comment to moderator  
Reply With Quote
Unread 09-29-12, 07:36 PM  
ollitrop
A Kobold Labourer
 
ollitrop's Avatar

Forum posts: 0
File comments: 5
Uploads: 0
Thank you for this awesome addon!

I figured out how to move the tracker to the position I wanted, I was just wondering if you plan to add a drag to move option in the future?

Thanks again!!!
Last edited by ollitrop : 09-29-12 at 07:43 PM.
ollitrop is offline Report comment to moderator  
Reply With Quote
Unread 09-29-12, 04:56 PM  
devilArt
An Aku'mai Servant
 
devilArt's Avatar
AddOn Compiler - Click to view compilations

Forum posts: 33
File comments: 128
Uploads: 1
thank you
devilArt is offline Report comment to moderator  
Reply With Quote
Unread 09-29-12, 03:37 PM  
Barjack
A Black Drake
AddOn Author - Click to view AddOns

Forum posts: 83
File comments: 58
Uploads: 7
Originally Posted by devilArt
hi Barjack, thanks for this awesome addon
BTW: can you tell me what font you used at that preview pictures, i really love it
Sure, if you look in the default options_override.lua you'll see the fonts I personally use (but commented out, of course):

opt.font = [[Interface\AddOns\SharedMedia_MyMedia\font\Calibri.ttf]]
opt.fontChallengeTimer = [[Interface\AddOns\SharedMedia_MyMedia\font\CalibriBold.ttf]]

So that's Calibri for the tracker and Calibri Bold for the challenge timer.
Barjack is offline Report comment to moderator  
Reply With Quote
Unread 09-29-12, 12:16 PM  
devilArt
An Aku'mai Servant
 
devilArt's Avatar
AddOn Compiler - Click to view compilations

Forum posts: 33
File comments: 128
Uploads: 1
hi Barjack, thanks for this awesome addon
BTW: can you tell me what font you used at that preview pictures, i really love it
devilArt is offline Report comment to moderator  
Reply With Quote
Unread 09-22-12, 02:05 PM  
Neema
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
Re: Re: QuestKingSounds replacing ReadyCheck with other built in sounds

Originally Posted by Barjack
That should do what you want.
Yes it does, perfectly! Thanks again
Last edited by Neema : 09-22-12 at 02:06 PM.
Neema is offline Report comment to moderator  
Reply With Quote
Unread 09-22-12, 01:41 PM  
Barjack
A Black Drake
AddOn Author - Click to view AddOns

Forum posts: 83
File comments: 58
Uploads: 7
Re: QuestKingSounds replacing ReadyCheck with other built in sounds

Originally Posted by Neema
I was looking at the QuestKingSounds and was wondering how to utilize other built in sounds, specifically the Peon vocals. I have put the name of the sound (PeonBuildingComplete1) into the override file to replace ReadyCheck the but this does not work as expected.
For whatever reason, there are two different ways WoW stores and plays sounds. Some are "interface sounds" which only need a simple name, e.g. "ReadyCheck", whereas other sounds need the full path to that sound to play. Since PeonBuildingComplete1 is a "creature sound", you need to specify the full path to that sound file.

opt.soundQuestComplete = [[Sound\Creature\Peon\PeonBuildingComplete1.wav]]

That should do what you want.
Last edited by Barjack : 09-22-12 at 01:45 PM.
Barjack is offline Report comment to moderator  
Reply With Quote
Unread 09-22-12, 01:24 PM  
Neema
A Kobold Labourer

Forum posts: 0
File comments: 5
Uploads: 0
QuestKingSounds replacing ReadyCheck with other built in sounds

Thank you for making a near perfect replacement for the quest objective tracker. I have been searching for something to replace quest guru for some time now as compatibility issues have been creeping into that addon and support for scenarios is not forthcoming. Your addon, for my purposes, works perfectly.

I was looking at the QuestKingSounds and was wondering how to utilize other built in sounds, specifically the Peon vocals. I have put the name of the sound (PeonBuildingComplete1) into the override file to replace ReadyCheck the but this does not work as expected.

Are there limits to what sounds can be played?

Thanks again for your efforts.
Last edited by Neema : 09-22-12 at 01:30 PM.
Neema is offline Report comment to moderator  
Reply With Quote
Unread 08-31-12, 10:44 PM  
Barjack
A Black Drake
AddOn Author - Click to view AddOns

Forum posts: 83
File comments: 58
Uploads: 7
Originally Posted by DaemonSambe
Thanks for adding the subzone stuff. I appreciate not having to make lots of changes to mods. One change i'd suggest is to remove the background color on completed quests.

As for the tooltip scale, the first iteration worked better than the current. With the new system, the set scale lasts make 1min after login, and is soon replaced.
Alright, well thanks for trying. It may be a very difficult problem depending on how the addon interaction works. In any case, setting tooltipScale to nil should solve your problem since I never call SetScale at all in that situation.

I'll change the subzone highlight in the next version to ignore completed quests, but it's not worth releasing a whole new version for. In the meantime you can go to around line 1764 in tracker.lua and change it from "if (opt_subzoneHeuristicHighlight) then" to "if (opt_subzoneHeuristicHighlight) and (isComplete ~= 1) then".
Barjack is offline Report comment to moderator  
Reply With Quote
Unread 08-31-12, 10:31 PM  
DaemonSambe
A Kobold Labourer
 
DaemonSambe's Avatar
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 168
Uploads: 1
Thanks for adding the subzone stuff. I appreciate not having to make lots of changes to mods. One change i'd suggest is to remove the background color on completed quests.

As for the tooltip scale, the first iteration worked better than the current. With the new system, the set scale lasts make 1min after login, and is soon replaced.

.Regards
DaemonSambe is offline Report comment to moderator  
Reply With Quote
Unread 08-31-12, 05:34 AM  
Barjack
A Black Drake
AddOn Author - Click to view AddOns

Forum posts: 83
File comments: 58
Uploads: 7
Originally Posted by Rammoth
You make it seem like I can do it myself with the features already provided in this. I'll take a look around, and read the code some, so I can understand how things work more.

If I think it needs this feature for my own personal use, would you mind if I added it in the code?
I doubt I'd want to merge such a change back in but if it's for your own use then please, feel free. I modify a number of the addons I use to suit my tastes as well.

You can probably accomplish a simple version of this solely in the "buildQuestSortTable" function, which takes your quest log and assembles a nested table of headers and watched quest ids. It does no sorting currently, it simply uses the default quest log order. I imagine what you want would be possible by creating a more complex annotated table under each header, using SelectQuestLogEntry and GetQuestLogRewardXP (API functions) to get experience values for each quest as you go, and then using that extra information to sort each header's contents and then run through that again turning it into a simple quest id list. Or something like that.
Barjack is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: