Files
Questie-X/README.md
T
Xurkon c4d003e58f feat: Questie-X v1.1.4 - plugin architecture, monorepo, rebranding
- Repoint remote to Xurkon/Questie-X
- Add QuestiePluginAPI, QuestieServer, QuestieLearnerComms modules
- Add Questie-X.toc, Questie-X-Classic.toc, Questie-X-TBC.toc, Questie-X-Turtle.toc
- Remove embedded Database/Ascension and Database/Ebonhold (migrated to plugins)
- Add Plugins/ directory with NTFS junctions for Questie-X-AscensionDB and Questie-X-EbonholdDB
- Add LibDeflate, XXH_Lua_Lib, LibDBIcon-1.0, LibDataBroker-1.1
- Update README: Questie-X branding, logo, plugin install guide, plugin API docs
- Update CHANGELOG: v1.1.4 entry documenting all architectural changes
- Update .gitignore: exclude plugin junctions, __pycache__, .agents, debug files
- Various module updates: corrections, map, tracker, tooltips, quest, options
2026-03-14 06:10:17 -05:00

6.6 KiB

Questie-X Logo

Questie-X

Version Downloads Documentation Patreon PayPal License WoW


A universal WoW quest-helper addon with a plugin architecture for custom private servers.

Download Latest  •  View Source  •  Read Documentation


Installation

  1. Download the archive.
  2. Extract it into your Interface/AddOns/ directory.
  3. The folder name determines which dataset loads:
    • Questie-X — WotLK (3.3.5a default)
    • Questie-X-Classic — Classic era dataset
    • Questie-X-TBC — The Burning Crusade dataset
    • Questie-X-Turtle — Turtle WoW dataset
  4. If your server lacks a world map patch, enable Options -> Advanced -> Use WotLK map data.

Plugin System

Questie-X ships with a Plugin API that lets separate addons inject custom server databases (quests, NPCs, objects, items, zones) without modifying core files. This is a new architecture replacing the old embedded Database/Ascension and Database/Ebonhold folders.

Available Plugins

Plugin Server Repository
Questie-Ascension Project Ascension Questie-X-AscensionDB
Questie-Ebonhold Ebonhold Questie-X-EbonholdDB

Installing a Plugin

Each plugin is a standalone addon. Install it the same way as the core addon:

  1. Download the plugin archive from its repository's Releases page.
  2. Extract it into your Interface/AddOns/ directory alongside Questie-X.
  3. The extracted folder name must match the plugin's .toc title (e.g., Questie-Ascension, Questie-Ebonhold).
  4. Reload your UI or restart the game client — Questie-X will detect and load the plugin automatically.

Plugins declare Questie-X as a dependency in their .toc file, so they only load when the core addon is present.

Writing Your Own Plugin

Questie-X exposes a public API via QuestiePluginAPI. A minimal plugin registers itself and provides override tables:

local plugin = QuestiePluginAPI:RegisterPlugin("MyServer")
plugin:RegisterQuestDB(MyServerQuestDB)
plugin:RegisterNpcDB(MyServerNpcDB)
plugin:RegisterObjectDB(MyServerObjectDB)
plugin:RegisterItemDB(MyServerItemDB)
plugin:RegisterZoneData(MyServerUiMapData, MyServerZoneTables)

See Modules/Libs/QuestiePluginAPI.lua for the full API surface.


Fixes & Compatibility

Nameplates

  • Explicitly skips Ascension Nameplates to avoid conflicts while maintaining compatibility with generic nameplate addons.

Quest Tracker

  • Ascension API: Fully compatible with custom quest APIs; no crashes on auto-turn-in quests.
  • Header Persistence: Resolved issues where quest headers would disappear from the tracker.
  • Dynamic Updates: Instant refresh when accepting, completing, or abandoning quests.
  • Combat Safety: Protected with pcall to prevent UI lockups during intense combat updates.

Tooltips

  • Fixed all legacy Lua errors.
  • Displays if an NPC drops an item that starts a quest directly in the tooltip.

Maps (Minimap & World Map)

  • Minimap: Fixed zoom-related Lua errors.
  • World Map: Full support for Ascension's WorldMapFrame (minimized mode), Mapster, and Magnify-WotLK.
  • Icon Cleanup: Resolved "ghost icon" bug where completed quests remained visible on the map.

Custom IDs

  • Native support for large integer IDs common on custom private servers.

Features

Ascension Scaling

Quests automatically scale to character level, perfectly matching the Ascension Scaling system.

Visual Map Objectives

Notes for quest starters, turn-ins, and complex objectives are drawn directly on your maps.

Quest Givers Quest Complete Quest Tooltip

Advanced Quest Tracker

  • Smart Tracking: Automatically tracks quests upon acceptance.
  • Expanded Capacity: Displays up to 20 quests (original limit: 5).
  • Interactive: Left-click to open the log; Right-click for focus modes or TomTom arrow integration.
Tracker

My Journey & Quests by Zone

  • Journey Log: Record every major step of your adventure.
  • Completionist View: Lists all available and completed quests per zone to ensure nothing is missed.
Journey Zone Quests

Database Search & Config

  • Global Search: Find any NPC, Object, or Quest in the massive Questie database.
  • Deep Customization: Adjust everything from icon scale to tracking logic.
Search Config

Credits

  • Questie Team - Original addon developers.
  • Xurkon - Questie-X fork and maintenance.
  • Project Ascension & Ebonhold Communities - Testing and data feedback.

License

MIT License - See LICENSE for details.