KillOrder

KillOrder — Changelog
=====================

v2.0 — Multi-Version Support, Full Visual Rework & Stability Pass
------------------------------------------------------------------

This is a major release. The addon was renamed from KillOrderTBC to
**KillOrder**, rebuilt to run across Classic Era, TBC Anniversary, Wrath,
Cata, and MoP Classic through retail-shared UI in one package, and had
most of its interface rebuilt from scratch. It also resolves the
nameplate-detection issues introduced by Blizzard's mid-2026 shared-UI
patch (2.5.6), which this version has been re-verified against.

### Renamed & Multi-Version
- **KillOrderTBC → KillOrder** — all TBC-only branding removed from the
  name, TOC, chat prefixes, and global identifiers
- `## Interface` now lists every current Classic and retail build in one
  TOC line, instead of a single hardcoded TBC interface version
- Author/signature updated

### Nameplate Engine — Critical Fixes
- **Root-caused a caching bug** in the nameplate visual engine: a
  momentary zero-width reading on the health bar (common during layout
  recalculation) was being treated as "this plate is stale," forcing a
  full teardown/rebuild of every visual element on it far more often
  than intended. This was silently undermining several features at once.
- Reworked health-bar detection to prefer the client's official
  `UnitFrame.healthBar` field, falling back to the old widest-StatusBar
  scan — more reliable under Blizzard's shared nameplate template
- Fixed nameplate overlay elements (priority badge, role name, spotlight
  effects) being invisibly clipped by the new template's health bar
  frame — moved them to a dedicated, unclipped overlay layer
- Fixed background art rendering and window borders to account for the
  above

### Auto-Classification
- **Fixed the core classification bug:** the addon only listened for
  `UNIT_SPELLCAST_START`/`_CHANNEL_START`, which never fire for
  instant-cast abilities — the majority of heals and many mob abilities.
  Added `UNIT_SPELLCAST_SUCCEEDED` so instant casts are observed too.
- Spell-name lookup now works against both the legacy `GetSpellInfo` API
  and the newer `C_Spell.GetSpellInfo` table API, whichever the client
  provides
- New **Boss** role tier, distinct from World Boss: detected live via
  the native `boss1`–`boss8` unit tokens WoW exposes during a real
  dungeon/raid encounter, overriding both color and priority rank
- Priority list is now 13 roles: Boss, World Boss, Elite Healer, Healer,
  Elite Caster, Caster, Elite Ranged, Ranged, Elite Melee, Melee,
  Elite Tank, Tank, Unknown

### Removed
- **Assist Mode** — the target-cycling keybind, its SecureActionButton,
  and all related slash commands and settings, removed entirely
- **Pulse** and **Spotlight** — both nameplate effects removed
  entirely. Pulse in particular was tracked back to the same caching
  bug above (a nameplate mid-rebuild would freeze at whatever alpha it
  last had, including fully dimmed) and, combined with ongoing
  reliability issues, was pulled rather than left half-working
- Old floating "Alert Bar" HUD fully replaced (see Target Role Bar,
  below) rather than patched forward

### Target Role Bar (new floating popup)
- Restored and rebuilt as a standalone widget, independent of
  nameplates entirely, so it isn't affected by any nameplate-side
  rendering quirks
- Styled to match: a thin full-height colored accent bar at each outer
  edge with a shorter colored priority-number badge just inside it —
  mirrored on both ends, banner/flag style, color-matched to role
- Sized to just fit the role name + mob name text
- Toggle available on the Main Window, in Options, and via
  `/ko alertbar`; position is draggable and saved

### Main Window
- Widened and shortened for a better aspect ratio; row height and
  spacing tightened
- Priority bars above the dim divider are now noticeably more visible;
  dimmed rows unchanged
- Bottom row is now **Nameplates / Dim / Role Bar** — equal width,
  full-width, centered
- **Options** button moved to the title bar, next to the close button
- Title now shows the version number (e.g. "KillOrder v2.0")
- Background art insets tightened so content sits cleanly inside the
  new artwork's border instead of overlapping it

### Options Window
- Reorganized into four sections: **Theme, Appearance, Session
  Management, Tips** — nameplate display toggles moved to WoW's own
  AddOns settings panel (Esc → Options → AddOns → KillOrder) to keep
  this window focused on appearance and window management
- No more scrolling — window height is computed from content every
  time it's built
- Section headers now use each theme's own title color plus a thin
  accent underline, instead of a fixed color per section
- All sliders replaced with "− value DEFAULT +" stepper rows
- Theme picker and role-bar text-color buttons restyled as proper
  bordered, brightened-on-hover buttons
- **Reset to Defaults** button added (with confirmation), separate from
  the existing Reset Learned Roles / Force Rescan
- Window position and scale now persist across reload, same as the
  Main Window
- Orcish Iron given its own accent/title color — it previously shared
  Dark Stone's red almost exactly

### Six Illustrated Themes
- Dark Stone, Orcish Iron, Fel Green, Cobalt Blue (renamed from
  Alliance Blue — no reason for a Horde player's theme list to say
  "Alliance"), Parchment, Shadow Mist
- Each theme now ships a full background art panel in addition to its
  color palette; background art can be toggled off independently
  without losing the theme's colors
- Background art re-cropped from a thinner-bordered source set;
  windows resized to match

### Persistence & Minimap
- Main/Options window open-or-closed state now correctly survives
  `/reload` and login (previously only worked if the window had been
  closed and reopened at least once that session)
- Window positions saved and restored the same way
- Minimap left-click now properly toggles the Main Window instead of
  only ever opening it; right-click still toggles Options

### Misc
- Themed buttons throughout the addon now share one consistent hover
  glow instead of some having a barely-visible one
- Background-opacity slider fixed (was displaying "1%" instead of
  "100%" at full)
- Nameplate detection range hardcoded to the engine max (41 yards) —
  no longer a separate setting

Earlier Versions (condensed)
-----------------------------

**v1.1–v1.2 (as KillOrderTBC)** — Introduced the smart auto-classification
engine (mana-bar split, cast observation, confidence-graded learning),
elite sub-roles, a 250+ entry spell database across four role
categories, pill-shaped Role Bar with adjustable intensity and text
color, and assorted TBC-client compatibility fixes (keybinding
registration, StaticPopup capitalization, font path escaping, dynamic
Main Window height).

**v1.0 (initial release)** — Nameplate role coloring by kill priority,
draggable Kill Priority Order list, a 4-layer role detection system
(static database of 200+ dungeon NPCs, creature-type fallback,
mouseover scan, cast observation), the dim divider system, a floating
target Role Bar HUD, group Main-Tank sync (`/ko mt`, `/ko sync`), and
the original Assist Mode and Spotlight effects (both since removed —
see v2.0).