BrewStaggerBar - Brokan
- By
options_preview.png
preview2.png
preview.png
prev_bar.png
Description
BrewStaggerBar
Lightweight, feature-rich Brewmaster Monk stagger tracking bar for World of Warcraft: Midnight (12.0+).
Built from the ground up as a standalone addon to replace a WeakAuras setup that is no longer viable under Midnight's Secret Values API restrictions. All combat API calls are wrapped in pcall for full Secret Values safety — if Blizzard re-restricts any API, the bar degrades gracefully instead of throwing errors.
Features
Stagger Bar
- 4 configurable color tiers: Light (0–30%), Moderate (30–60%), Heavy (60–100%), Extreme (>100%)
- Bar maximum scales up to 1000% max HP (configurable via slider) with linear fill instead of resetting at 100%
- Optional overflow wrap mode: bar refills cyclically when exceeding the configured maximum
- Background color changes on extreme stagger
- Horizontal or vertical orientation
- Smooth bar animation powered by LibSmoothStatusBar (toggleable)
- Custom border texture, size and color via LibSharedMedia
- Bar textures and fonts via LibSharedMedia
Template Text System
Three independent text elements (label, percentage, tick) — each with its own font face, size, outline, anchor point and X/Y offsets. All text is driven by templates using these flags:
| Flag | Output | Example |
|---|---|---|
%n |
Name | Stagger |
%s |
Stagger total (formatted) | 1.2m |
%r |
Stagger total (raw) | 1234567 |
%p |
Stagger as % of max HP | 45% |
%t |
Single tick value (formatted) | 61.7k |
%d |
Tick DPS — tick × 2 (formatted) | 123.4k/s |
%tp |
Tick as %HP per second | 4.5% |
%m |
Max HP (formatted) | 2.7m |
%a |
Absolute stagger / max HP | 450k / 1.2m |
%purify |
Purifying Brew predicted clear | 225k |
%% |
Literal % |
% |
%( / %) |
Literal parentheses | ( ) |
Number formatting options: raw, k/m, mil/M, or K/M short notation.
Default templates: label shows %d (%tp) (tick DPS with tick percentage), right side shows %p (stagger percentage).
Glow Effects
LibCustomGlow integration with 4 glow types, each with its own configurable parameters:
| Type | Parameters |
|---|---|
| Pixel | Lines, frequency, thickness, border mode |
| AutoCast | Particles, frequency, scale |
| Button | Frequency |
| Proc | Duration, start animation toggle |
All types share color picker and X/Y offset controls. Glow triggers at a configurable stagger tier.
Visibility Rules
- Auto-show only when playing Brewmaster spec
- Hide out of combat (with configurable fade delay in seconds)
- Hide in rest areas / cities
- Hide when stagger is zero (full HP)
Sparkline History
Mini line graph below the bar showing stagger trend over time. Configurable height, number of samples and color.
Alerts
- Sound alerts — play any LibSharedMedia sound when reaching a configurable tier, with adjustable cooldown
- Combat chat log — print stagger tier warnings to chat, routed via LibSink (supports Scrolling Combat Text, MikSBT, Blizzard floating text, Parrot, and more)
Profile System
- AceDB profiles with per-character or shared configurations
- Automatic profile switching per specialization via LibDualSpec
- Compressed profile import/export (AceSerializer + LibDeflate) — share your setup as a string
Other
- Test Mode with visual indicator — cycles through all tiers for previewing settings
- Bob and Weave talent detection — auto-adjusts tick calculation (20 vs 26 ticks)
- Drag-to-move with lock toggle
- Screen clamp recovery — bar auto-repositions to center if saved offscreen after a resolution change
- Addon Compartment integration (Midnight minimap menu) via LibDBCompartment
The BrewStaggerBar - Brokan Team
