promotional bannermobile promotional banner
premium banner

zQuestLog

Quest and Objective log with collapsible headers and customizations.

Description

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.