MDT Pull Navigator

Keep your MDT route in view with a small, movable dungeon map. MDT Pull Navigator zooms to the current pull and follows the route as enemy-forces progress and boss kills meet each pull's requirements.

**Requires [Mythic Dungeon Tools (MDT)](https://www.curseforge.com/wow/addons/mythic-dungeon-tools).** This is an early Alpha. Ingame checks have been performed, but the addon still may encounter bugs.

## Controls

- Drag the header to move the map or the lower-right corner to resize it. **Move/Lock** locks its position and size.
- The current pull is cyan, bosses are gold, and the next pull is dimmed. Hover enemies for their names and forces values.
- **Route** shows the floor with numbered pulls. **Focus** frames the current pull. Scroll over the map to adjust zoom.
- **Floor** cycles through the current pull's floors, or the route's floors in overview. A pull on several floors still completes as one step.
- **Auto** follows dungeon progress in the matching Mythic+ dungeon. Outside a key, the map works as a route preview.
- **Next (`>`)** finishes the current step and corrects the forces baseline. Use it when the group skips a pack, pulls extra enemies, or the tracker needs a correction.
- **Previous (`<`)** pauses Auto so you can inspect earlier pulls. Enable Auto again when ready.
- **Refresh** reloads the selected route. Route changes also appear automatically and pause Auto; select the correct pull before resuming.
- **Reset** returns to pull 1 with Auto paused. Starting a new keystone resets run progress while keeping your Auto preference.

Optional bindings are listed under **MDT Pull Navigator** in WoW's key-binding settings.

## Automatic progression

Trash progression is an estimate based on the dungeon's enemy-forces total and the cumulative count planned in MDT. It does not identify every killed enemy. Advancement happens after a short settling delay and works best when the group follows the route in order. Extra mobs, skipped packs, combined pulls, or incorrect counts can put it ahead or behind. Use **Next** or `/mdtp pull N` to correct it.

Boss steps wait for a successful encounter and matching creature IDs from Retail's encounter event. If the client omits those IDs, they differ from MDT's data, or you joined after the kill, advance manually. Boss kills observed during the run survive `/reload`.

Zero-force nonboss enemies, empty steps, missing data, and duplicate spawns require manual advancement. Auto waits if progress data is unavailable. Forces beyond a capped objective cannot be inferred reliably, and the final pull may need **Next** if the key ends before its update settles. A matching dungeon-completion event shows “Dungeon complete” without marking unverified route steps as killed.

This version displays pull positions and order. MDT drawings, notes, and a live player-position arrow are not included.

## Commands

Settings are account-wide; run progress is saved per character. Your MDT route and MDT window position are left unchanged.

## License and credits

Licensed under **GPL-2.0-or-later**; see `LICENSE`.

- [Mythic Dungeon Tools](https://github.com/Nnoggie/MythicDungeonTools), by Nnoggie and contributors: route format, installed dungeon data, and map tile layout. MDT is installed separately and retains its own license and credits.
- Blizzard's [scenario API](https://github.com/Gethe/wow-ui-source/blob/live/Interface/AddOns/Blizzard_APIDocumentationGenerated/ScenarioInfoDocumentation.lua) and [encounter API](https://github.com/Gethe/wow-ui-source/blob/live/Interface/AddOns/Blizzard_APIDocumentationGenerated/EncounterInfoDocumentation.lua): public progress and encounter information.
- [MDT Guide](https://gitlab.com/shrugal/mdtguide/-/blob/master/Main.lua): reference for the raw enemy-forces criterion in Midnight. No MDT Guide code is bundled.