zQuestLog

A replacement for the default WoW objective tracker. Supports up to five independent tracker windows, each with its own position, size, categories, and settings.

Multiple Tracker Windows

You get up to five tracker windows. Each one is its own independent panel — position it wherever, size it however, and configure it separately from the others.

Assign any combination of these categories to any window:

Quests — your active quest log
World Quests — current world quests with live countdown timers
Bonus Objectives — bonus objective tasks in the open world
Scenarios — scenario and dungeon objective tracking
Achievements — tracked achievements and their criteria
Recipes — crafting recipes currently tracked in your professions UI, with per-reagent progress and a craftable count

You don't have to use more than one window. But if you want to separate world quests from your quest log, or keep dungeon content on its own panel, you can.

Tiling System

Tracker windows can be tiled — anchored to each other so they move and resize as a group. Set a parent, attach children to it, and the whole stack stays together when you drag.

Global tiling options:

Match Greatest Width — all trackers in the group expand to match the widest one
Match Greatest Height — same, but for height
Constrict Height to Root — the root tracker's max height caps the combined height of the whole stack

The built-in Example profile shows a ready-to-go two-tracker tiled setup as a starting point.

Per-Window Options

Every tracker window has its own full set of options:

Sizing and Position

Dynamic width and height — window auto-sizes to fit its content
Max and min width and height — always editable, independent of dynamic mode
Expand left or expand up — control which direction the window grows
Resize grip in the bottom-right corner

Behavior

Show when empty — controls whether the tracker stays visible when it has no content
Show in instance — controls whether the tracker stays visible inside dungeons and raids
Dungeon Quest Filter — show only quests related to the current dungeon
Show hidden quests — reveal quests you've manually hidden via Shift+Click
Scroll bar toggle

Title Bar

Auto-hide title buttons — buttons fade in when you hover over the title bar and fade out when you move away
Show the addon name, category initials, or both in the title
Categories shown in the title bar: (Q)uests, (S)cenarios, (W)orld Quests, (B)onus Objectives, (A)chievements

Background

Background texture (LibSharedMedia supported)
Background overlay color and opacity

Sorting and Tracking

By default zone headers follow Blizzard's quest log order. Options to change:

Sort Nearest Quests — re-orders quests by distance. The zone header with the closest quest moves to the top, and quests within each zone are ordered closest-first. Campaign headers always stay above.
Auto Track Nearest Quest — automatically super-tracks the closest quest that has a known map location.
Current Zone First — moves your current zone's header to the top without a live distance poll. Mutually exclusive with Sort Nearest.
Current Quest Area — groups quests whose objective area you are currently standing in under a Current Area header, placed just below campaigns. Optionally shown above campaigns instead.
Use Blizzard Quest Order — zone headers follow the Blizzard quest log order rather than alphabetical order.
Use WoW Tracking — show only quests that are actively tracked in the WoW quest log, ignoring per-quest show/hide state.

Poll rates for Sort Nearest and Auto Track are individually configurable (1–15 seconds each).

Campaign Grouping

Campaign quests group under named headers for current expansion content. Enable Track Old Campaigns (experimental) to also group older expansion campaigns under their own headers instead of treating them as regular zone quests.

Campaign headers show a tooltip on hover with the current chapter name and completion state.

Quest Icons

An icon can be displayed next to each quest title. Choose between the custom zQuestLog icon style or the native WoW quest icon style. Icon size and vertical position are both adjustable.

Progress and Timer Bars

Objective progress bars show for quests that track quantities. A configurable percentage label can be shown on the bar itself.

Timer bars show for quests with active countdowns. The bar changes to a completion color when time is up. Timer bar height, texture, font, label position, and all colors (fill, segments, background) are independently configurable.

Achievement progress bars also support a percentage label.

Mythic+ Info

When a Mythic+ key is active, the Scenario tracker section shows an additional block with the keystone timer, death count, and active affixes. This can be toggled independently of the rest of the Scenario tracker.

Customization

Style — global appearance options:

UI Accent Color — color of the title text, scroll bar thumb, borders, and UI controls. Option to use your class color automatically.
Smooth Scrolling — animates scroll position changes instead of jumping.
Separator Lines — optional dividers between content categories. Configurable texture, color, and opacity. Separate toggles and controls for campaign group separators.
Super-Track Glow — highlights the currently super-tracked quest with a background glow and/or a << marker.
Pixel Perfect Scale — scales tracker windows to align with the physical pixel grid for sharper rendering on high-DPI displays.

Colors — set per content type:

Quest header, title, completed title, and objective colors
Color quests by difficulty level
World quest and bonus objective colors
Scenario header, stage name, and objective colors
Achievement header, title, and objective colors
Recipe header, title, objective, and completed objective colors
Campaign chapter color
Progress bar fill, segment, and background colors
Timer bar fill, segment, background, and completion colors

Fonts — set independently for:

Header text
Quest and achievement titles
Objective text
Campaign headers and chapter lines
Progress bar labels
Timer bar labels

Spacing — fine-grained pixel control over padding above and below every row type: headers, titles, objectives, progress bars, timer bars, separators, and the buffers between groups.

Sound Notifications — sound picker for:

Objective increment (progress ticks up)
Objective complete
Quest and achievement complete

Settings Panel (zSettingsFrame adapter)

zQuestLog uses the zSettingsFrame adapter in zSF_Bridge.lua with a few options that affect UI behavior:

showScaleDropdown (boolean): when true, the panel shows a dedicated scale selector for resize scaling on this addon's settings page.
cpuProfile (boolean): when true, the CPU usage meter appears in the zSettingsFrame status bar (requires C_AddOnProfiler).
tabRowMaxBlizz (number): controls the maximum number of tab buttons per row when the panel is embedded in Blizzard settings.
themeColors (table): primary/secondary colors for zSettingsFrame chrome. Typically maps to ZQL_GOLD_DARK and a class color (e.g. RAID_CLASS_COLORS["WARLOCK"]).

These settings are configured in zSF_Bridge.lua and can be adjusted to fit different theme or performance preferences.

Controls

Left-click a quest — super-tracks it and sets the minimap pin. If complete and ready to turn in, opens the completion UI instead.
Right-click a quest — opens the quest detail / turn-in frame
Alt + Left-click a quest — opens the Quest Journal to that entry
Shift + Click a quest — toggle as user-hidden
Shift + Click a zone header — bulk-hide or unhide all quests under that header
Ctrl + Left-click — link the quest or achievement to chat
Right-click an achievement — opens the Achievements frame
Right-click the title bar — opens the options panel
Use quest items directly from the tracker window
Click to Complete for quests that complete via the objective frame
Shift + Left-click a recipe — untracks it from the professions UI
Right-click a recipe — opens the professions UI to that recipe's entry

Minimap Button

zQuestLog provides a minimap button for quick access to common tracker controls and a status overview.

Appearance

The button displays the zQuestLog icon on your minimap (configurable minimap position)
Can be enabled or disabled from the minimap button's own context menu

Tooltip Display

Hover over the button to see a real-time status tooltip that includes:

Click instruction — a quick reference for all button actions
Current Settings — displays whether "Show Hidden Quests" and "Dungeon Mode" are currently enabled or disabled
Tracker Assignments — lists all active trackers (T0–T4), their assigned categories, and whether each is currently visible or hidden

Click Actions

Left Click — shows all trackers that have categories assigned to them
Shift + Left Click — hides all trackers that have categories assigned to them
Right Click — opens the options panel
Shift + Right Click — toggles the global "Show Hidden Quests" setting
Ctrl + Right Click - toggles "Dungeon Mode" setting

Key Bindings

zQuestLog registers nine bindings in the WoW Key Bindings panel under its own zQuestLog header. All are unbound by default.

Toggle Main Tracker — show or hide the Main Tracker
Toggle Tracker 1–4 — show or hide each additional tracker individually
Toggle All Trackers — smart: shows all if any are hidden; hides all if all are visible
Toggle Hidden Quests — same as the eye button on the title bar
Toggle Dungeon Mode — same as the dungeon button on the Main Tracker title bar
Collapse/Expand All Trackers — smart: minimizes all if any are expanded; expands all if all are minimized

Quest Item Buttons

Quest items for active quests show up as clickable icon buttons with cooldown swipes. Two display modes:

Inline mode (default)

Buttons appear directly alongside the quest title inside the tracker window
They scroll with the content and clip to the scroll viewport

Panel mode

All item buttons for a tracker are grouped into a dedicated floating panel
The panel anchors to any of 8 positions around the tracker window, or floats freely with a saved position
Buttons stack in a configurable grow direction
Panel background texture, overlay color, border color, and thickness are all configurable
A numbered badge can be shown on each button and its corresponding quest title row to match buttons to quests at a glance

Combat behavior

Button positions, attributes, and cleanup are deferred until combat ends
Buttons stay in place and keep their last-assigned item for the duration of a fight
You can still click and use them during combat

Integrations

TomTom — when TomTom is loaded, a Show TomTom Waypoint option becomes available. When enabled, super-tracking a quest also sets a TomTom arrow pointing to the quest's next objective.
WolfHat — when WolfHat is loaded, CTRL+right-clicking a quest or achievement opens the corresponding WolfHat detail frame.

Tooltips

Quest tiles show reward previews including items, experience, money, and reputation.
Show Party Quest Progress — when in a group, the tooltip shows each party member's progress on the same quest.
Campaign header tooltips show the current chapter name and completion state.

Profiles

All settings are saved per profile — colors, fonts, spacing, tracker assignments, everything. Profiles can be created, copied, imported, exported, and switched from the options panel.

Hidden quests are stored per-character and are unaffected by profile switches
A built-in Example profile shows a fully customized starting setup
Reset Example Profile restores it to its original state at any time
Import and export profiles as a compressed string to share with other players

Additional

Location hints (routing lines like "Take the portal to Outland") can be shown on all quests or only the super-tracked quest
Completed objective and completed achievement criteria visibility toggles
Frame lock to prevent accidental dragging or resizing
Option to hide the default Blizzard objective tracker
/zql slash command with subcommands for quick access

If submitting an issue or feature request, use the Issues page and include the required information. Requests posted in comments will be ignored.