# 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, L'ura memory-game helper, 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
- Group ratings grid for your party
- Group keystones at a glance
- Great Vault tracker
- Rating goals (2000 / 2500 / 3000) with focus dungeons
- Guild keystones tab — see every guildy's key, refresh on demand

### 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.

### L'ura Memory-Game Helper
Built for the L'ura encounter in March on Quel'Danas. One-click macro generator creates 5 single-letter macros (`O D G T X`) that broadcast rune tokens in raid chat. Every raider running YippYapp sees the runes appear in a pentagon display in press order — no extra downloads, works in both Heroic and Mythic.

### 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)

### 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 Panel
Full Blizzard Options integration — toggle features on/off without touching slash commands. `Esc → Options → AddOns → YippYapp Helper`.

## 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 panel |
| `/yyhrc` | Preview the ready-check window |

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for the full version history.

## Feedback

Bug reports and feature requests welcome on the project page.
