# Questie-X
[](https://xurkon.github.io/Questie-X/)
[](https://www.patreon.com/Xurkon)
[](https://www.paypal.me/Xurkon)
**A universal WoW quest-helper addon with a plugin architecture for custom private servers.**
[Download Latest](https://github.com/Xurkon/Questie-X/releases/latest) • [View Source](https://github.com/Xurkon/Questie-X) • [Read Documentation](https://xurkon.github.io/Questie-X/)
---
## Installation
1. [Download](https://github.com/Xurkon/Questie-X/releases) 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](https://github.com/Xurkon/Questie-X-AscensionDB) |
| Questie-Ebonhold | Ebonhold | [Questie-X-EbonholdDB](https://github.com/Xurkon/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:
```lua
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.
