Skip to content

zavahcodes/pfQuest

Repository files navigation

pfQuest

This is an addon for World of Warcraft Vanilla (1.12) and The Burning Crusade (2.4.3). It helps players to find several ingame objects and quests. The addon reads questobjectives, parses them and uses its internal database to plot the found matches on the world- and minimap. It ships with a GUI to browse through all known objects. If one of the items is not yet available on your realm, you'll see a [?] in front of the name.

The addon is not designed to be a quest- or tourguide, instead the goals are to provide an accurate in-game version of AoWoW or Wowhead. The vanilla version is powered by the database of VMaNGOS. The Burning Crusade version is using data from the CMaNGOS project with translations taken from MaNGOS Extras.

pfQuest is the successor of ShaguQuest and has been entirely written from scratch. In comparison to ShaguQuest, this addon does not depend on any specific map- or questlog addon. It's designed to support the default interface aswell as every other addon. In case you experience any addon conflicts, please add an issue to the bugtracker.

Downloads

You can check the [Latest Changes] page to see what has changed recently.

World of Warcraft: Vanilla

  1. [Download pfQuest] (*)
  2. Unpack the Zip-file
  3. Move the pfQuest folder into Wow-Directory\Interface\AddOns
  4. Restart Wow
  5. Set "Script Memory" to "0" (HowTo)

*) You can optionally pick one of the slim version downloads instead. Those version are limited to only one specific language: English, Korean, French, German, Chinese, Spanish, Russian

World of Warcraft: The Burning Crusade

  1. [Download pfQuest] (*)
  2. Unpack the Zip-file
  3. Move the pfQuest-tbc folder into Wow-Directory\Interface\AddOns
  4. Restart Wow

*) You can optionally pick one of the slim version downloads instead. Those version are limited to only one specific language: English, Korean, French, German, Chinese, Spanish, Russian

World of Warcraft: Wrath of the Lich King

Important

This is a BETA version of pfQuest

It is able to run on a WotLK (3.3.5a) client, but does not yet ship a WotLK database. Every available content is limited to Vanilla & TBC as of now.

  1. [Download pfQuest] (*)
  2. Unpack the Zip-file
  3. Move the pfQuest-wotlk folder into Wow-Directory\Interface\AddOns
  4. Restart Wow

*) You can optionally pick one of the slim version downloads instead. Those version are limited to only one specific language: English, Korean, French, German, Chinese, Spanish, Russian

Development Version

The development version includes databases of all languages and client expansions. Based on the folder name, this will launch in both vanilla and tbc mode. Due to the amount of included data, this snapshot will lead to a higher RAM/Disk-Usage and slightly increased loading times.

Controls

  • To change node colors on the World Map, click the node.
  • To remove previously done quests from the map, <shift>-click the quest giver on the world-map
  • To temporarily hide clusters on the world-map, hold the <ctrl>-key
  • To temporarily hide nodes on the mini-map, hover it and hold the <ctrl>-key
  • To move the minimap-button, <shift>-drag the icon
  • To move the arrow, <shift>-drag the frame

Addon Memory Usage

The addon ships an entire database of all spawns, objects, items and quests and therefore includes a huge database (~80 MB incl. all locales) that gets loaded into memory on game launch. However, the memory usage of pfQuest is persistent and does not increase any further over time, so there's nothing bad on performance at all. Depending on the download you pick (especially the full packages), you might see a message that warns you about an addon consuming too much memory. To get rid of that warning, you can set the addon memory limit to 0 which reads as no limit. This option can be found in the character selection screen.

Map & Minimap Nodes

Auto-Tracking

The addon features 4 different modes that define how the new or updated questobjectives should be handled. Those modes can be selected on the dropdown menu in the top-right area the map.

Option: All Quests

Every quest will be automatically shown and updated on the map.

Option: Tracked Quests

Only tracked quests (Shift-Click) will be automatically shown and updated on the map.

Option: Manual Selection

Only quest objectives that have been manually displayed ("Show"-Button in the Questlog) will be displayed. Completed quest objectives will be still automatically removed from the map.

Option: Hide Quests

Same as "Manual Selection" and in addition to that, Quest-Givers won't be shown automatically. Also completed quest objectives will remain on the map. This mode won't touch any of the map nodes created.

Database Browser

The database GUI allows you to bookmark and browse through all entries within the pfQuest database. It can be opened by a click on the pfQuest minimap icon or via /db show. The browser will show a maximum of 100 entries at once for each tab. Use your scrollwheel or press the up/down arrows to go up and down the list.

Questlog Integration

Questlinks

On servers that support questlinks, a shift-click on a selected quest will add a questlink into chat. Those links are similar to the known questlinks from TBC+ and are compatible to ones produced by ShaguQuest, Questie and QuestLink. Please be aware that some servers (e.g Kronos) are blocking questlinks and you'll have to disable this feature in the pfQuest settings, in order to print the quest name into the chat instead of adding a questlink. Questlinks sent from pfQuest to pfQuest are locale independent and rely on the Quest ID.

The tooltip will display quest information such as your current state on the quest (new, in progress, already done) as well as the quest objective text and the full quest description. In addition to that, the suggested level and the minimum level are shown.

Questlog Buttons

The questlog will show 4 additional buttons on each quest in order to provide easy manual quest tracking. Those buttons can be used to show or hide individual quests on the map. Those buttons won't affect the entries that you've placed by using the database browser.

Show
The "Show" button will add the questobjectives of the current quest to the map.

Hide
The "Hide" button will remove the current selected quest from the map.

Clean
The "Clean" button will remove all nodes that have been placed by pfQuest from the map.

Reset
The "Reset" button will restore the default visibility of icons to match the set values on the map dropdown menu (e.g "All Quests" by default).

Chat/Macro CLI

The addon features a CLI interface which allows you to easilly create macros to show your favourite herb or mining-veins. Let's say you want to display all Iron Deposit deposits, then type in chat or create a macro with the text: /db object Iron Deposit. You can also display all mines on the map by typing: /db mines. This can be extended by giving the minimum and maximum required skill as paramter, like: /db mines 150 225 to display all ores between skill 150 and 225. The mines parameter can also be replaced by herbs, rares, chests or taxi in order to show those instead. If /db doesn't work for you, there are also some other aliases available like /shagu, pfquest and /pfdb.


Changes in this fork (zavahcodes/pfQuest)

This fork includes a few quality-of-life additions on top of the original project:

Bug Fixes

  • Fixed quest objective icons disappearing from map (v7.0.2)
    • Resolved an issue where quest objective icons would disappear after accepting new quests, leaving only quest giver icons visible
    • The bug occurred because when processing new quests, the addon would remove all quest nodes but only re-add objectives for the newly changed quests
    • Now properly re-adds all active quest objectives when the quest giver update is triggered, ensuring nothing disappears from the map

Features

  • Quest resynchronization UI button

    • New setting in Config → User Data:
      • "Resynchronize Quests" – provides a convenient GUI button that performs the same function as /pfdb query.
    • Queries the server for completed quests and updates your quest history accordingly.
    • Includes server compatibility checks and user feedback messages.
    • Available in multiple languages (English, Spanish, Portuguese).
  • Smart NPC tooltip quest information control

    • New setting in Config → General:
      • "Hide Accepted Quest Info On NPC Tooltips" – intelligently filters quest information in NPC tooltips.
    • When enabled, only shows quest information for NEW/UNACCEPTED quests, hiding info for quests already in your quest log.
    • Helps discover new available quests while reducing tooltip clutter from accepted quests.
    • Perfect for identifying new quest opportunities without information overload.
  • Minimap-only quest giver visibility toggles

    • New settings in Config → Map & Minimap:
      • "Show Quest Starters (Mini Map)" – toggle NPCs that offer quests on the minimap.
      • "Show Quest Enders (Mini Map)" – toggle NPCs that accept quest turn-ins on the minimap.
      • "Show Quest Starters (World Map)" – toggle NPCs that offer quests on the world map.
      • "Show Quest Enders (World Map)" – toggle NPCs that accept quest turn-ins on the world map.
    • Filtering is texture-based to avoid hiding objective spawn dots by accident.
  • Quest Tracker text outline

    • New setting in Config → Questing:
      • “Quest Tracker Text Outline” – applies an outline to quest titles and objectives in the tracker.
    • Takes effect immediately when toggled (no reload required).
  • Map node interaction controls

    • New settings in Config → Map & Minimap:
      • "Disable World Map Node Interaction" – pfQuest pins stop capturing hover/click; native map blobs stay interactive.
      • "Disable Minimap Node Interaction" – same concept for the minimap.
      • "Disable World Map Node Tooltips" and "Disable Minimap Node Tooltips" – keep pins visible but skip pfQuest tooltips/highlights.
    • Useful for players who only want pfQuest to draw icons while keeping default map interactions untouched.
    • Hold Shift to temporarily re-enable disabled interactions while the key is pressed.
  • Localizations

    • Added localization keys for the new settings and basic translations for a few locales. Other locales fall back to the base key.

Notes

  • Compatibility remains Vanilla/TBC/WotLK (as per original). These changes are additive and preserve existing default behavior when disabled.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages