BuffCue

BuffCue 0.2.1

Lightweight buff, debuff, and consume readiness warnings for WoW Classic: Mists of Pandaria.

Install:
  World of Warcraft\_classic_\Interface\AddOns\BuffCue\

Core commands:
  /buffcue                 Show settings
  /buffcue on              Enable warnings
  /buffcue off             Disable warnings
  /buffcue test            Test current alert sound/message
  /buffcue sound           Cycle alert sound
  /buffcue sound 1-5       Select alert sound
  /buffcue debug           Toggle debug output

Buff expiration commands:
  /buffcue short           Toggle short-buff warnings
  /buffcue long            Toggle long-buff warnings
  /buffcue mine            Toggle short-buff only-mine filter

Debuff expiration commands:
  /buffcue debuffs         Toggle target/focus/mouseover debuff warnings
  /buffcue debuffmine      Toggle debuff only-mine filter
  /buffcue debufftime 5    Set debuff warning time, 1-60 seconds
  /buffcue debuffmin 5     Ignore debuffs with total duration <= this value
  /buffcue smartdebuffs    Toggle class-aware smart debuff filtering
  /buffcue profile         Show the current character's debuff watchlist

BuffCue Pro commands:
  /buffcue pro             Toggle Pro features
  /buffcue ready           Run a flask/food readiness check now
  /buffcue consumes        Toggle consume reminders
  /buffcue flask           Toggle flask/elixir checks
  /buffcue food            Toggle food/Well Fed checks
  /buffcue tankdebuffs     Toggle player/tank debuff stack warnings
  /buffcue tankstacks 3    Set player/tank stack warning threshold

Default buff rules:
  - Ignores passive/no-expiration auras.
  - Ignores very short buffs under 30 seconds total duration.
  - Buffs from 30 seconds through 5 minutes: warn at 5 seconds.
  - Buffs longer than 5 minutes: warn at 5 minutes, 1 minute, and 10 seconds.
  - Short-buff warnings default to buffs cast by you/your pet only.
  - Warnings fire once per buff application and reset when the buff refreshes.

Default debuff rules:
  - Watches debuffs on target, focus, and mouseover.
  - Defaults to debuffs cast by you/your pet only.
  - Ignores debuffs with total duration of 5 seconds or less by default.
  - Warns 5 seconds before the debuff expires.
  - Smart debuff filtering is enabled by default, so BuffCue focuses on class-relevant DoTs/debuffs instead of every short effect on a target.
  - Warnings reset when the debuff is refreshed.
  - If you switch targets and the old mob is not your focus/mouseover, BuffCue cannot continue tracking it reliably in this lightweight version.

BuffCue Pro behavior:
  - Class-aware debuff watchlists for major DoTs, armor debuffs, and class-maintained target effects.
  - Consume readiness reminders for flask/elixir and food/Well Fed.
  - Readiness checks run on ready checks and when entering combat, with throttling to prevent spam.
  - Player/tank debuff stack warnings alert when a debuff on you reaches the configured stack threshold.
  - /buffcue ready runs an immediate local readiness check.

Sound choices:
  1 - Voice: "Buff expiring"
  2 - Soft chime
  3 - Double beep
  4 - Alarm
  5 - Klaxon

Changelog:

0.1.1
- Fixed MoP Classic UnitBuff return-order handling that could treat expirationTime as the caster string, causing errors on buffs such as Horn of Winter.

0.1.2
- Long-duration buffs now warn three times: 5 minutes, 1 minute, and 10 seconds before expiration.
- Short-buff behavior remains unchanged: 5-second warning for 30-second through 5-minute buffs.

0.1.3
- Added player-cast debuff expiration warnings for target, focus, and mouseover units.
- Added /buffcue debuffs, /buffcue debuffmine, and /buffcue debufftime commands.

0.1.4
- Debuff alerts now ignore debuffs with a total duration of 5 seconds or less by default, reducing spam from very short effects such as Explosive Shot.
- Added /buffcue debuffmin <seconds>.

0.2.0
- Added BuffCue Pro features into the main addon.
- Added class-aware smart debuff watchlists to reduce debuff-warning noise.
- Added consume readiness checks for flask/elixir and food/Well Fed.
- Added /buffcue ready, /buffcue consumes, /buffcue flask, and /buffcue food.
- Added player/tank debuff stack warnings with /buffcue tankdebuffs and /buffcue tankstacks.
- Added /buffcue profile to show the current class debuff watchlist.

0.2.1 Compatibility update
- Updated TOC interface to 50504 for current Mists of Pandaria Classic client compatibility.
- Added safe event registration so removed/renamed events do not block addon loading.
- Added client build/interface reporting on login, /buffcue, and /buffcue build.
- Hardened aura reads with UnitAura / C_UnitAuras fallback handling while preserving UnitBuff / UnitDebuff support.
- Wrapped periodic scans with a safe scanner to prevent repeated scan errors from breaking the addon loop.