tflo / Auto-Quest-Tracker-MkIII

Based on the original Auto Quest Tracker addon, updated for DF and much, much more.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Auto Quest Tracker Mk III

Auto Quest Tracker Mk III started out as the continuation of a continuation (last version: Jan 2021) of the original Auto Quest Tracker addon (last version: Jan 2018).

But in the meantime, and especially since version 4, it would be an understatement to call AQT Mk III a "continuation" of the original. It has gained so many new features and improvements, and not even the core function has remained unchanged.

If you're not familiar with the original Auto Quest Tracker:

What it does is basically move the quests that belong to your current zone into the quest tracker, and move them out when you leave the zone. If you manually add a quest to the tracker (Shift-click in the quest log), AQT will respect that and leave the quest in the tracker.

The addon works with most known quest trackers, like Quester, Kaliel's Tracker and of course Blizz's built-in quest tracker. If using with Kaliel's Tracker, make sure to have Kaliel's Auto Zone feature disabled.

I have updated Auto Quest Tracker, because – in my experience – it works better than all other similarly featured addons I've tried over the last years. For example, it's the only one – again: in my experience – that properly handles Callings and account-wide pet quests. (When I'm in Shadowlands, I do not want to see my Pandaria Beasts of Fable pet dailies popping up in the tracker, and when I'm pet battling in Pandaria I'm not interested in seeing my Maldraxxus Callings, …)

Quester + Auto Quest Tracker is my preferred combo.

New features of "Mk III"

General

  • Loading message (at login/reload) that shows the current state (enabled/disabled) of AQT. This can be disabled/enabled with /aqt loadingmessage (account-wide setting).
  • The /aqt slash command now shows the current state of AQT (enabled/disabled and other settings if applicable).
  • For a complete list of slash commands, type /aqt help or /aqt h.
  • Automatic throttling of the tracker update for 3 seconds in case of multiple zone changes in a row.

Enable/Disable AQT

  • You can now disable/enable AQT with the slash commands /aqt off or /aqt on (or shorter /aqt d or /aqt e) This is a per-char setting.

Temporarily disabling AQT can be useful for example if you have a bunch of quests that you want to keep focused as you move back and forth between adjacent zones. You could also just re-track the quests manually (AQT allows this and keeps them tracked), but this can get tedious. It can also be useful if you simply have too many quests that technically belong to your zone, but you're not interested in at the moment. What happens when you disable AQT is that the two main events become unregistered, i.e. this is close to unloading the addon, but without the need to reload.

New since version 3.0, there are now 3 modes of disabling AQT:

  • Disable AQT for the duration of the current session: /aqt off or /aqt d
    • This is the new default since v3.0. The point of this is to make it (almost) impossible to disable AQT and then forget to re-enable it in the next session. (There's nothing worse than missing half of your quest log just because the zone-related quests weren't auto-tracked!)
    • AQT is smart enough not to confuse a /reload or a disconnect with the start of a new session. A new session will start if you are logged out for 20 minutes or more. AQT will then re-enable itself the next time you log in.
  • Disable AQT permanently: /aqt offp or /aqt dp
    • This was the default before v3.0.
    • AQT will stay disabled on the char until you manually enable it again (/aqt e).
  • Disable AQT for the current map instance: /aqt offi or /aqt di
    • A map instance usually is everything that is separated by a loading screen. So, for example, an instance change happens when you use a portal or when you enter/leave a dungeon instance, etc.
    • AQT will re-enable itself automatically as soon as you have left the map instance.

Exceptions

New in v4 is a sophisticated Exceptions system:

  • You can now assign the following account-wide exceptions to quests:
    • Ignore (as if AQT was disabled for a specific quest).
    • Track always and everywhere.
    • Never track (disable auto tracking and remove from quest tracker).
  • Exceptions can be assigned via modifier keys while tracking/untracking a quest in the quest log or quest tracker.
  • Exceptions can be assigned via slash commands.
  • See the brand new AQT wiki, namely the Exceptions section, for how to do. It's too much new stuff to list here.
  • Print Exceptions report with /aqt x.
  • Slash commands to clear Exceptions (see Wiki!).

This opens up endless possibilites, for example:

  • Set all (current and future) dungeon quests to Never Track: /aqt n dung.
  • Set all variations of 'Aiding the Accord' to Always Track: /aqt a ata.
  • Set all Dragonriding Race quests to Ignore: /aqt i dr.

… and so on. Again, check the Wiki for detailed instructions and examples!

Mini API

You can now enable/disable AQT in your scripts with the global function addon_aqt_enable():

  • Enable with addon_aqt_enable(true)
  • Disable with addon_aqt_enable(false)
  • Toggle with addon_aqt_enable(not AQT_CharDB.enabled)

On wago.io you will find an (exemplary) companion WeakAura using this function that you can place onto your Quest Tracker:

  • The Aura's icon shows the current state of AQT (on/off)
  • Left click: toggle AQT
  • Right click: toggle Quest Log

More info on the Aura download page.

Addon Compartment Button

  • Shows the activation status.
  • Available click actions:
    • Left-click: Print status text; same as /aqt.
    • Command-left-click: Print help text (use Control-left-click on Windows); same as /aqt h or /aqt help.
    • Right-click: Toggle AQT for the current session; same as /aqt d / /aqt e or /aqt off / /aqt on.

Compatibility with Classic Quest Log

If you are using Classic Quest Log, you will need to patch it to set the correct quest watch type (1) when you Shift-click on a quest to add it to the tracker. Otherwise, AQT will not be able to recognize the quest as "manually added" and will untrack it when you zone out, which is usually not what you want when you add a quest manually.

You can download a plugin-style addon that will do this for you in this GitHub thread.


Feel free to post suggestions or issues in the GitHub Issues of the repo! Please do not post issues or suggestions in the comments on Curseforge.


My other addons:

About

Based on the original Auto Quest Tracker addon, updated for DF and much, much more.

License:GNU General Public License v3.0


Languages

Language:Lua 100.0%