# YippYapp Helper

An all-in-one companion addon for World of Warcraft: Midnight Season 1. Gear upgrade advisor, Mythic+ helper, raid tools, trinket rankings, loot browser, consumables guide, dungeon teleports, and more — all in a unified app shell.

## Features

### Gear Upgrade Advisor
- Scans all equipped gear showing upgrade track, rank, and item level
- Color-coded recommendations: **Upgrade Now**, **Hold Crests**, **Save for Drop**, **Free Upgrade**, and more
- 10-rule recommendation engine considering crest scarcity, slot priority, replacement risk, Hero-to-Myth conversion, and achievement progress
- Auto-opens anchored to the upgrade vendor window — click any slot to send it directly

### Mythic+ Helper
- **Dungeon overview** — clickable dungeon icons with your best key level, score, and teleport
- **Group ratings** — per-dungeon score grid for all party members with color-coded cells
- **Group keystones** — see everyone's key at a glance with dungeon icons and class colors
- **Great Vault** tracker with Blizzard-native tooltips — click to open the vault
- **Rating goals** — progress bars for 2000/2500/3000 with focus dungeons and estimated key levels needed
- **Guild tab** — browse guild members' keystones (shared via addon comms)
- **Keystone sharing** — automatically broadcasts your key to party and guild

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

### Trinket Rankings
- SimulationCraft-powered trinket rankings for all DPS and tank specs
- **Single Target** and **Multi-Target** fight styles
- Side panel on the Character Frame with your spec's top trinkets
- Auto-highlights trinkets from your current dungeon/raid
- Full app view with class/spec browser and S/A/B tier columns

### Raid Tools
- **Tier Tracker** — scan your raid group for tier set pieces
- **Split helper** — visualize odd/even group splits with tank, healer, and DK distribution
- **Swap suggestions** — intelligent player swap recommendations for balanced splits (no duplicate suggestions)
- **PI assignments** — assign Power Infusion targets
- **Release blocker** — prevents accidental spirit release in guild raids (hold CTRL 1s to override)

### Loot Browser
- Browse all dungeon, raid, and world boss loot by slot
- Spec and secondary stat filtering with difficulty columns
- Trinket tier badges cross-referenced from SimC rankings

### Consumables Guide
- Enchant, gem, flask, food, and potion recommendations for every spec
- Three-tab layout with item icons, quality-colored links, and guide text

### Progression Overview
- Gear sources, crest tracks, and season reference at a glance

### Dashboard
- Character bar with spec, item level, and profile selector
- Crest overview with counts, season caps, and weekly remaining
- **Upgrade summary** — top 3 actionable recommendations, auto-refreshes on gear/crest changes
- **Farm guide** — shows which crests you're short on and where to farm them
- Quick navigation to all addon pages

## Slash Commands

| Command | Description |
|---|---|
| `/yh` | Open the app |
| `/yh help` | Show all commands |
| `/yh mplus` | Open Mythic+ helper |
| `/yh raid` | Open raid tools |
| `/yh loot` | Open loot browser |
| `/yh release` | Toggle release spirit blocker |
| `/yh release debug` | Test release blocker outside raids |
| `/yh profile [name]` | Show or set profile (normal, heroic, mythic) |
| `/yh discount <track>` | Toggle crest discount for a track |
| `/yh discounts` | Show discount status for all tracks |
| `/yh debug` | Dump slot data to chat |

## How It Works

The addon reads your equipped gear via tooltip scanning to determine each item's upgrade track and rank. It cross-references this with your player profile to classify crests as "free" or "precious", then runs through its recommendation engine to suggest the best use of your resources.

Trinket rankings are generated from SimulationCraft at Myth 1/6 item level using 5000 iterations per spec. Rankings are tiered as S (top 3), A (top 4-10), and B (top 11-20).

Mythic+ ratings and per-dungeon scores are pulled from the Blizzard API (`C_PlayerInfo.GetPlayerMythicPlusRatingSummary`). Keystones are shared between addon users via addon messaging.
