Super Swing Timer

Melee, ranged, and current-target enemy swing timer for World of Warcraft Classic and TBC (including Anniversary Edition).

Super Swing Timer tracks white-hit swing timers across main hand, off hand, ranged attacks, and your current hostile target. It is tuned for Classic/TBC mechanics such as next-melee-attack abilities, dual-wield desync, parry haste, extra-attack suppression, haste rescaling, druid form resets, rogue Sinister Strike end-window timing, a Rogue energy-tick helper plus Slice and Dice upkeep bar, ret paladin seal-breakpoint timing, shaman weave breakpoints, and current-target enemy swing detection. The current timing model keeps swing motion on a GetTime()-aligned precise clock, applies cached latency only to predictive windows such as Auto Shot safe-stop timing, rogue Sinister Strike queue guidance, and weave clip math, keeps Maul, Heroic Strike, Cleave, and Raptor Strike on separate next-attack paths, and avoids mixed clock-domain drift.

At a glance

CurseForge pages are easiest to read when they stick to standard Markdown tables, lists, inline code, and screenshots. This README avoids relying on Mermaid diagrams so the same content stays portable across CurseForge and GitHub. If you want diagrams, render them to PNG or SVG and embed the image instead of depending on a live diagram renderer.

Key features

• All melee classes: Warrior, Rogue, Paladin, Shaman, Druid, and Hunter
• Current-target enemy swing bar that tracks your selected hostile target from PLAYER_TARGET_CHANGED, UnitGUID("target"), UnitAttackSpeed("target"), and hostile SWING_DAMAGE / SWING_MISSED combat-log events, while ignoring off-hand hits so the single enemy bar stays readable
• Hunter auto shot with GetSpellCooldown(75) + ranged-speed sync for the ranged timer, plus ranged-haste-aware fallback resync when UnitRangedDamage() is temporarily unavailable; while the cooldown API is active, live ranged resync also reuses the cooldown start anchor instead of only stretching duration mid-cycle; the addon now also cross-checks real Hunter auto-repeat state through Blizzard's current spell API before letting SPELL_UPDATE_COOLDOWN seed a new cycle, treats mounted Hunters as not auto-repeating, blocks cooldown re-anchors while the bar is pinned in the red moving window, and no longer hard-resets the current ranged timer on transient stop events; the shared swing clock stays on a GetTime()-aligned GetTimePreciseSec() / GetTime() path while cached latency is applied only to predictive windows, the Hunter MH bar is anchored to the ranged stack and only appears for a live melee swing or a queued Raptor Strike, queued Raptor now uses its own yellow next-attack tint without sharing Warrior or Druid queue state, melee handoffs no longer leave the ranged bar stuck full red after the last ranged cycle expires, and the dedicated 10px hunter bar beneath ranged now covers both the hidden Auto Shot / instant Multi-Shot window and real Steady Shot / Aimed Shot casts while tinting those real casts by whether they still fit before the next Auto Shot
• Off-hand timing now requires a real off-hand weapon speed instead of fabricating hidden OH cycles, and the OH frame is reused cleanly across equipment swaps
• Dual-wield tracking with independent MH and OH timers
• NMA detection for Heroic Strike, Cleave, Maul, and Raptor Strike
• Warrior and Druid queue colors for Heroic Strike, Cleave, and Maul so the MH bar clearly shows which special is queued, while the spark remains on its own manual/default color for readability and Maul queue state stays isolated from the Warrior queue-cleanup path
• Haste rescaling when weapon speed changes mid-swing, while keeping live swing anchors on the addon's aligned precise timer path so bars do not lead early from alternate CLEU clock remapping
• Parry haste handling using the standard Classic 40% reduction with a 20% remaining-time floor
• Extra attack suppression for Sword Spec and Windfury
• Druid form reset handling
• Ret Paladin seal breakpoint line that shows the actual strike-edge end marker plus a GCD/swing-aware reseal point on twist seals, with the full seal list from docs/spellIds.md covered by aura-name fallback and the breakpoint lines clamped above the bar texture
• Shaman weave assist for Lightning Bolt, Chain Lightning, Healing Wave, Lesser Healing Wave, and Chain Heal breakpoints, with color-coded family timing, small breakpoint spell icons that stay above and below the MH bar texture, resolve spell names through the shared spell-info wrapper, and stay hidden when Minimal Mode or the weave toggle disables them
• Optional class colors for MH / OH / ranged bar fills, with the spark color kept independent so queue tints and white/manual spark colors stay readable, turning class colors off restoring the saved manual bar colors instead of leaving the class tint behind, and live bar text now flipping to black with a white outlined backing while class colors are enabled for better readability on bright fills
• Rogue latency-adjusted main-hand end window that turns red on the final slice of the MH bar so Combat Rogues can press Sinister Strike into the swing landing and more reliably fire it immediately after the main-hand hit, while the spark stays layered above that red slice for readability, the default alpha stays a little softer for clearer bar reading, and the helper now falls back to the live MH weapon speed whenever the MH bar itself is visible
• Rogue Slice and Dice helper: a slim duration bar above the MH bar that uses the shared bar texture path, matches MH width, tracks the active Slice and Dice buff in real time from a Classic-safe helpful-aura read (UnitBuff / UnitAura signature tolerant), rechecks its aura state on a short throttle for smoother live updates, and stays hidden whenever the buff is down or the MH bar itself is hidden
• Rogue energy-tick helper: one slim 4px vertical bar to the left of the MH bar that fills on the Classic/TBC 2-second energy-tick cadence, re-syncs from likely natural energy gains, and keeps the swing timer stack cleaner than the earlier paired test helper
• Customizable bars, separate MH/OH and ranged textures, glow/opaque indicator mode, compact spark settings with a 3px default spark width, a slight forward-biased pixel-snapped spark edge so the thin spark reads closer to the live fill edge, alpha-enabled color pickers, configurable bar background tint and opacity, adjustable bar border color and thickness, widened drag hitboxes plus real drag handlers for easier bar movement, reset-to-default position restore, visibility, lock state, and the Test Bars preview via /sst, /super, or /superswingtimer
• Toggle MH / OH / ranged / enemy bars, the Rogue Sinister Strike cue, the Rogue Slice and Dice bar, the Rogue Energy Tick checkbox, plus the shaman weave helper and its family controls from the config panel or Blizzard's Interface Options → AddOns list
• Collapse or expand the major config sections so the /sst panel stays easier to scan while you tune textures, colors, timing, and weave settings, with stable row groups that keep the panel rendering cleanly
• Texture picker: the MH/OH and ranged texture rows now open a scrolling full-preview list that keeps each texture stretched behind its label, stays focused on bar-style textures from Blizzard, WeakAuras, and installed LibSharedMedia media packs, and keeps the spark / shaman weave spark rows on the dedicated thumbnail browser seeded with the WeakAuras Square_FullWhite preset surfaced as Normal.

Timing model

Texture sources

Installation

1. Download the latest release ZIP from GitHub Releases

2. Extract the archive into your AddOns folder so the final path looks like:

   World of Warcraft\_classic_\Interface\AddOns\SuperSwingTimer\

3. Log in and play

Usage

Opening /sst previews the bars for setup, but the live gameplay bars remain combat-driven and stay hidden out of combat unless you are using preview/test mode. Hidden or idle live bars reset to an empty state so entering combat no longer shows stale full bars from the previous cycle. The ranged bar for Hunters also appears when auto-shot mode starts, and the smaller hunter cast bar appears beneath it for the fixed Auto Shot hidden cast window (ns.CAST_WINDOW plus cached latency) instead of the full ranged cooldown cycle; BC Classic instant Multi-Shot shots now seed that helper with a short stored shot window when the client does not expose a live cast.

The main commands are /sst, /super, and /superswingtimer. /swang remains as a legacy alias.

Class support

Enemy bar support is not class-restricted: if you have a hostile target selected, the addon can track that target's main-hand swing timer with the red default enemy bar.

Configuration

Type /sst, /super, or /superswingtimer to open the config panel.

Config panel options

• Use a top Quick Controls section with a clearly labeled left Visibility column and right Key Colors column so the most-used visibility and bar-color settings stay together, with compact non-overlapping row spacing that fits the Rogue/Hunter quick options cleanly
• The /sst color swatches now use clearer flat preview tiles so the chosen bar colors are easier to read at a glance while configuring the addon
• The main /sst panel now supports mouse-wheel scrolling, keeps later sections pushed below the real Quick Controls height, and labels preview mode more clearly so setup feels closer to a Blizzard-quality options panel
• Show or hide the main-hand, off-hand, ranged, enemy, Rogue Sinister Strike cue, the Rogue Slice and Dice bar, and the Rogue energy-tick helper as appropriate for your class
• Enable or disable the shaman weave assist and individual spell families
• Adjust bar, ranged, spark, and weave-spark textures; the bar and ranged rows now use a scrolling full-preview list for bar-style media from Blizzard, WeakAuras, and LibSharedMedia packs, while spark textures still use the thumbnail browser; tune layers, sizes, alpha, and the tiny upper/lower weave markers that follow spell haste; the stock bars now default to a slimmer 15px height with the OH bar derived down to 8px, the Rogue Slice and Dice helper clamped to a slim 3-4px profile above MH, the spark default height matches that slimmer profile and clamps to the host bar, and the breakpoint overlays now live on a dedicated overlay frame so they stay above the bar fill without relying on hover-sensitive HIGHLIGHT layering
• Switch weave-indicator glow between a bright additive style and a more opaque blend; the main swing spark stays on a color-preserving blend so white/manual spark tints stay visually accurate
• Toggle minimal mode, lock / unlock bars, tune the bar border size, and run the Test Bars preview; Reset Defaults now also restores the saved anchor positions
• Change colors for the bar background, bar border, MH, OH, ranged, Rogue Sinister cue, Rogue Slice and Dice helper, Rogue tick bar, Auto Shot safe/unsafe feedback, enemy, spark, and the paladin seal breakpoint line; MH / OH / ranged can use class colors while the Rogue cue, Rogue Slice and Dice helper, Rogue energy tick, Auto Shot feedback, enemy bar, and spark keep their own separate manual/default tint and opacity
• Labels sit above the controls in /sst, the rows are clickable, and hover tooltips explain what each setting does; the right-side checkbox, dropdown, or editable number field is the control for each row

Feedback

Found a bug or want a feature? Open an issue at: GitHub Issues

Changelog

See CHANGELOG.md for the release history.