Never get caught off guard again. Know what's coming — before it hits.

BossReminder** is a lightweight, self-contained encounter awareness addon that tracks boss mechanics and fires visual warnings and voice callouts precisely when you need them. No bloat, no external dependencies — just crisp, customizable alerts covering 76 bosses across 11 instances with ~280 pre-timed events.

Built from the ground up for Midnight 12.x — taint-free, secret-value-safe, and designed for serious raiders and M+ players who want to stay one step ahead of every mechanic._

Author: TomoAniki    Version: 1.2.0

Open settings with /br  •  Enable Edit Mode with /br edit to reposition every widget freely

BossReminder monitors encounter events and fires pre-calculated timers based on each boss's ability cooldown pattern. When a mechanic is incoming, it triggers up to 5 simultaneous display types and plays a localized voice callout — giving your whole group a clear heads-up before the ability lands.

Every display widget is independently toggleable, resizable, repositionable via Edit Mode, and fully customizable (font, color, texture, size).

Classic countdown bars — the backbone of your encounter awareness.

• Up to 8 simultaneous bars stacked vertically, grow up or down
• Each bar shows the spell icon, ability name, and remaining time
• Fully themable: LibSharedMedia texture and font pickers
• Custom RGBA color, bar width/height, and spacing between bars
• Bars recycle from a frame pool — no GC overhead during progression

Large numeric 5–4–3–2–1 readout that appears in the final seconds before an ability.

• Triggers when a timer reaches the configured pre-warn threshold (default 5s)
• Displays the spell icon alongside the number (optional)
• Configurable font, font size, and screen position
• Cleans itself up automatically on encounter end

A bold center-screen text callout — impossible to miss.

• 3-stage animation: 0.15s fade-in → 2s hold → 0.4s fade-out
• Reads the ability name directly — zero configuration needed
• Font, size, and position fully customizable
• Ideal for high-priority mechanics that need instant attention

A radial cooldown swipe for short-fuse abilities (≤ 30 seconds).

• Visual circular sweep that depletes as the timer counts down
• Custom color and size — matches any UI aesthetic
• Automatically hidden when the timer expires
• Perfect for visual learners tracking abilities by shape, not text

A dedicated bar that tracks live boss casts in real time.

• Monitors boss1–boss5 units for casts and channels
• Handles casts (forward fill) and channels (reverse fill) natively
• Shows cast name + remaining duration
• Secret-value-safe via pcall-wrapped UnitCastingInfo / UnitChannelInfo

BossReminder ships with a full voice callout engine powering 70+ localized audio cues across 202 packaged sound clips.

• Pack selection — choose your preferred voice pack from the config panel
• Channel control — route audio through Master, SFX, Music, or Dialog
• Volume slider with independent control
• Throttle protection — 0.15s minimum gap prevents audio spam on overlapping events
• Fallback chain: voice profile → LibSharedMedia key → raw path → generic fallback
• Test button — preview any voice cue directly from the Voice config page
• Powered by LibSharedMedia-3.0 for seamless integration with your existing media setup

BossReminder's encounter data is covering the full Midnight Season 1 content lineup.

• 76 bosses with individual per-mechanic toggles
• ~280 timed events with:
  • firstSeenSec — offset from pull to first cast
  • cdSeriesSec — repeating ability cooldown deltas
  • Type tagging: Tank / Healer / Mechanic / Other
  • Severity levels (0/1/2) for color-coded priority
  • Optional voice label and spell ID per event
• Browse bosses by instance in the Encounters page — toggle individual mechanics on/off per boss
• Dry-run Test Mode: replay any encounter's timer sequence without entering the instance (/br test enc <encounterID>)

Don't just prepare for bosses — prepare for the pull.

BossReminder includes a lightweight Trash CD Tracker for monitoring dangerous non-boss abilities between bosses.

• Tracks cooldowns by NPC ID + Spell ID rules
• Listens to UNIT_SPELLCAST_SUCCEEDED and UNIT_SPELLCAST_START — no CLEU dependency
• Guards against secret values via issecretvalue() — fully Midnight-safe
• Manage rules from the dedicated Trash CD config page
• Enable/disable with a single toggle

Switch characters, switch specs — BossReminder keeps up automatically.

• Named profiles — create, rename, duplicate, delete
• Per-spec assignment — map each specialization to a profile; BossReminder auto-loads it on spec change
• Auto-save before every profile switch — never lose your settings
• Snapshot/apply pattern — deep-copy includes all display, voice, encounter, and condition settings
• Import / Export — share profiles as a compressed string (coming soon)

Every display widget is freely repositionable with a single toggle.

• /br edit unlocks all 5 widgets simultaneously — drag them anywhere on screen
• Alignment Grid with 3 modes: Dimmed, Bright, Off
• Cursor flashlight — grid lines near your mouse glow for pixel-perfect alignment
• Header bar with Grid / Lock / Reload UI controls
• Positions persisted per profile — your layout follows your spec

Open with /br — a clean, dark-themed panel with instant access to every setting.

BossReminder is purpose-built for the Midnight API environment:

• Secret Values: UnitCastingInfo() and UnitChannelInfo() return opaque secret numbers. The Cast Progress Bar passes these directly to SetMinMaxValues / SetValue — the only C-side methods that accept them natively.
• Taint Prevention: All unit events use RegisterUnitEvent scoped to specific boss units. No global RegisterEvent("UNIT_*") calls anywhere.
• Trash CD Safety: issecretvalue() guards all cooldown comparisons in the Trash CD tracker — zero taint risk from secret returns.
• Frame Pooling: Timer Bars recycle from a pre-allocated pool — no frame creation or GC pressure during active fights.
• Encounter Engine: Timers are pre-calculated at encounter start via C_Timer.NewTimer chains. Zero per-frame logic outside the 0.1s scheduler tick.

BossReminder is fully self-contained — no separate library installs needed.

• LibStub — Library versioning
• CallbackHandler-1.0 — Internal event bus
• LibSharedMedia-3.0 — Shared fonts, textures, and sound files

1. Download the latest release from CurseForge
2. Extract the BossReminder folder into World of Warcraft/_retail_/Interface/AddOns/
3. Restart WoW or type /reload
4. Type /br to open the configuration panel
5. Head to the Encounters page to enable or disable specific boss mechanics
6. Use /br edit to reposition all display widgets to your preferred screen locations

Use the CurseForge project page to report bugs or suggest features. When reporting issues, please include:

• Your class and specialization
• The boss encounter and mechanic involved
• Steps to reproduce the problem
• Any relevant Lua errors from the in-game error window