# YippYapp Helper

An all-in-one companion addon for **World of Warcraft: Midnight Season 1**.
Gear upgrade advisor, Mythic+ helper, raid tools, ready-check overview,
loot browser, interrupt tracker, M+ completion popup, consumables guide,
and dungeon teleports — all in one unified window.

## Highlights

### Gear Upgrade Advisor
Smart recommendations for every equipped slot: **Upgrade Now**,
**Hold Crests**, **Save for Drop**, **Free Upgrade**, and more. Considers
crest scarcity, slot priority, replacement risk, and Hero-to-Myth
conversion. Auto-opens next to the upgrade vendor — click any slot to
send it straight to upgrade.

### Mythic+ Helper
- Dungeon overview with clickable teleport icons.
- **Party-scoped**: always shows your 5-man group, even when the raid
  frame is active.
- Group ratings grid for your party.
- Group keystones at a glance, auto-synced via addon-comm.
- Great Vault tracker.
- Rating goals (2000 / 2500 / 3000) with focus dungeons.
- Guild keystones tab — see every guildy's key, refresh on demand.
- `/yyhmplustest` fills the view with 5 dummy teammates so you can
  preview the full layout solo.

### Mythic+ Completion Popup (BETA)
On `CHALLENGE_MODE_COMPLETED`, a small window shows your new M+ rating
and the party's new keystones. Click any row to teleport directly
(secure InsecureActionButton casts the teleport spell), or click the
**Open Mythic+ window** button to navigate the app to the M+ page.

### Utility Advisor (BETA)
On entering a mythic-keystone or mythic 5-man, a compact window pops up
with per-class recommended utility spells for that dungeon and a short
mechanic description. Hover any spell icon for a full Blizzard tooltip.
Gold border + "T" badge marks talent-dependent picks. Shows once per
zone entry — no spam.

### Interrupt Tracker (BETA)
Party-wide interrupt cooldown bars with full visual customization.
- Time-correlation attribution model that works under Midnight's
  secret-value system (your kick hits a mob, your bar drains).
- Per-bar: class-colored fill, class-colored border, spell icon, name,
  countdown/elapsed timer, custom texture.
- Icon-mode alternative with cooldown swipe.
- Drag-to-move with visible unlock overlay.
- Multi-context visibility filter (any combination of Always, In a group,
  Dungeons & raids, Mythic+, Raid, PvP).

### Ready Check Window
Opens on every ready check. One row per raider showing:
Food · Flask · Vantus · Int · AP · Vers · Stam · Haste · Move · Durability %

Live-updates as buffs come in, countdown timer, Ready / Not Ready
buttons, and a collapse toggle for a compact view. Position and state
remembered across sessions. Optimized for 30-man raids — single-pass
aura scanner, debounced UNIT_AURA, coalesced durability comms.

### Raid Tools
- Group split analysis with tank / healer / DPS / melee / ranged counts
  per split.
- Swap suggestions to balance your groups.
- Release Spirit blocker for guild raids (hold CTRL 1s to override).
- **Raid Addon Scanner** — see who in your raid has YippYappHelper
  installed.

### Loot Browser
- Browse all dungeon, raid, and world-boss loot by slot.
- **Class dropdown** — inspect any class's loot table, not just your own.
- Horizontal-scroll item rows with arrow buttons.
- Automatically hides housing decor and profession recipes.
- Mount rewards get a distinct border so they stand out.

### Dungeon Teleports
All Hero's Path dungeon teleports from MoP through Midnight, organized
by expansion. Clickable secure buttons to cast directly. Greyed-out
icons for teleports you haven't unlocked.

### Consumables Guide
Enchant, gem, flask, food, and potion recommendations for every spec.

### Dashboard
Character bar, crest overview with weekly caps, top upgrade
recommendations, and a farm guide telling you exactly which crests to
chase and where.

### Settings
All settings now live inside the addon itself (no Blizzard AddOn Options
integration). Open via the **Settings** button on the AppFrame header
or Dashboard, or with `/yyhopts` / `/yyhsettings` / `/yyhinterrupts`.
Top-level tabs: **General** (other features), **Interrupt Tracker**
(with sub-sections).

## Slash Commands

| Command | Description |
|---|---|
| `/yh` | Open the app |
| `/yh help` | List all commands |
| `/yh mplus` | Open Mythic+ helper |
| `/yh raid` | Open raid tools |
| `/yh loot` | Open loot browser |
| `/yh release` | Toggle release-spirit blocker |
| `/yh profile [name]` | Switch between normal / heroic / mythic profiles |
| `/yhopts` | Open settings page |
| `/yyhopts`, `/yyhsettings`, `/yyhinterrupts` | Same as above |
| `/yyhrc` | Preview the ready-check window |
| `/yyhmplustest` | Toggle M+ test mode (5 fake teammates) |
| `/yyhutility` | Open utility advisor preview |
| `/yyhmpluspopup` | Preview the M+ completion popup |
| `/yyhintlog` | Toggle interrupt debug logging |
| `/yyhintdebug` | Fire a fake interrupt cast (cycles through classes) |
| `/yyhscan` | Open the raid addon scanner |

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for the full version history. Latest:
**v2.5.0 (2026-04-15)** — Midnight-ready: new Interrupt Tracker, M+
Completion Popup, Utility Advisor, in-addon Settings page, unified
dark theme, and extensive performance work for 30-man raids.

## Feedback

Bug reports and feature requests welcome on the project page.
