BGH - Battle Ground Helper

# BG Helper (BGH) — Release notes

## 2.0.0 — Major release

### Visual / UX

- **New window chrome:** gold + teal accent strips along the top of the main frame (v2 “signature” look).
- **Title bar:** darker blue-grey tint for contrast with the accent.
- **Version badge:** `v2.0.0` shown next to the title (also in the minimap broker tooltip and addon list title).

### Addon sync (critical)

- **Correct instance channel:** sync now uses **`INSTANCE_CHAT`** for battlegrounds (retail API). The previous **`INSTANCE`** value was invalid for `C_ChatInfo.SendAddonMessage`, which could prevent reliable delivery to other players in the BG.
- **Message buffer:** while you are in a PvP instance and **`bgType` is not yet set** (brief window after `ClearBGWidgets` / before `BuildBG` finishes), incoming messages are **queued** (cap 64) and **replayed** when `BuildBG` completes — applies to **all** BG UI types (BASE, FLAG, ORB, etc.), not only base rows.
- **Routing:** receive path no longer depends on `bgType` to *accept* messages; handlers filter as needed.
- **Replay:** `ReplayBuffer()` is invoked at the **end of `BuildBG`** for every BG type (moved out of `BuildBaseSystem` only).

### Player names

- **Realm-safe names:** defender add/remove and inbound routing normalize **`Name-Realm`** → short **`Name`** so lists and updates stay consistent.

### DHR

- **`OnDHRMessage`:** `INC` / `SAFE` / `LEAVE` no longer require `self.bgType == "DHR"` so messages are not dropped if they arrive before the UI type is fully settled.

### AUTO (beta)

- **Options:** AUTO toggle lives in **Options** (under reset / behavior), not crowding the main title bar.
- **Base auto-DEF:** minimap zone text vs known bases (with fallback name table), auto `DEF` / `LEAVE` when moving, subtle **`[A]`** marker when auto-assigned.
- **Temple of Kotmogu:** orb stack display on your cell; **5+** red emphasis; **8+** auto **`GONNADIE`** (same as danger).
- **Trinket warning:** when defending a base and **INC** fires on that base, if PvP trinket (slots 13/14) has **>10s** cooldown remaining → log line **“! No trinket — rotate NOW”** and faster orange row flash.

### Events / send guards

- **Send:** still guarded to avoid nonsense outside instances; allows sending in **PvP instance** when `bgType` is not set yet; **`SYNC`** in **test mode** without `bgType` (party testing).
- **Receive:** own addon messages ignored (anti-echo).

### Misc

- **`Show my actions in local chat only` (`echoEnabled`):** affects only **local echo** of macro hints — **does not** disable addon sync (sync is controlled by **Addon sync**).

### Files touched (high level)

- `events.lua` — channel, buffer/replay, `RouteInboundMessage`
- `ui.lua` — layout, `UpdateAll` after base build, AUTO placement, v2 visuals
- `state.lua` — `ShortName` for defenders
- `options.lua`, `minimap.lua` — version display
- `auto.lua` — AUTO beta logic
- `BGH.toc` — version **2.0.0**

---

## Earlier (1.x) — summary

Initial retail BG coordination UI with addon sync, multiple BG modes (BASE, EOTS, FLAG, ORB, CART, DHR), macros, and minimap button.