# DiveHelper

A small, focused addon for the **Abyss Anglers** event in patch 12.0.5 (Midnight). It answers one question every dive: *what should I do next?*

## Important

This is a disposable addon. Use it when grinding out the achievements, getting your items etc, then throw it away!

This is 100% vibe coded while doing the dive event.

Partially tested since I already completed most of it while building the addon.

Haters may move along.

# What it does

- **Single floating list** of every incomplete Abyss Anglers achievement.
- **Three columns** per row: progress · what to do · clickable achievement name.
- **Priority sorted** so vendor-unlock achievements sit at the top, then other actionable items, then passive point grinds at the bottom.
- **Sub-rows for fish lists** — multi-criterion achievements (e.g. "Catch the listed creatures") show their parent achievement once and indent each missing creature beneath it.
- **Vendor unlock tooltip** — hover any row to see the achievement description, current progress, and which Depthdiver Jeju / Tu'nakit upgrade it gates (Reinforced Joints, Plecofin Bait, Pressurized Eyeglass, Ka'bubb, Idol of the Depths, etc.).
- **Click any row** to open the Blizzard Achievement UI directly on that achievement.
- **Rare creature alerts** during dives — gong sound, chat ping, and a gold row at the top of the list whenever a vignette-tagged rare appears in the dive instance.
- **Footer summary** — `Dive achievements: X / Y done`.

## Slash commands

- `/dh` — toggle the frame.
- `/dh show` / `/dh hide` — explicit show/hide.
- `/dh reset` — recentre the frame and reset its size.
- `/dh refresh` — clear the achievement cache and re-scan (use after a hotfix or if the list seems stale).
- `/dh debug` — print diagnostic info.
- `/dh inspect <name>` — dump an achievement's criteria for troubleshooting.
- `/dh rares on` / `/dh rares off` — toggle the rare-spawn sound and chat ping.

## Frame

- Drag from anywhere on the panel to move it.
- Drag the bottom-right corner to resize.
- Click the frame to bring it above other UI.
- Position and size are saved per character.

## Notes

- Diving suit upgrades purchased from Depthdiver Jeju are **warband-wide** — buy on one character, the whole
account benefits.
- The achievement-to-vendor-reward mapping is curated from Wowhead. If a row's tooltip is missing the `Unlocks:`
line, that mapping just hasn't been filled in yet — feel free to report it on the issue tracker.