ClassicAPI 1.18 is now the only requirement
Requirements
- Needs ClassicAPI 1.18.0 or newer. SuperWoW is no longer used, and Nampower is optional.
- On an older ClassicAPI the addon stays off, and a popup links the download.
- Custom triggers on SuperWoW or Nampower events only fire while that mod is installed.
Triggers
- New Combat Log trigger, with lists of spell IDs, spell names and NPC IDs.
WeakAuras2 auras that use one now import.
- Custom triggers can listen to the combat log with CLEU or CLEU:SUBEVENT.
- Crowd Control matches a specific type (stun, fear, root, silence, disarm and
more) or a school lockout, with the effect's real timer.
- Saved Crowd Control auras: Root, Silence and Disarm filters carry over; CC and
Snare become "any type", and snares are no longer detected.
- Cast bars follow pushback and channel updates.
Displays
- Icon cooldown swipes are drawn by the client's own cooldown frame.
- Sound actions play on a chosen channel, and a new Stop sound type ends a
looping sound.
Fixes
- Cooldown auras no longer sweep on every wand shot.
- The Global Cooldown trigger ignores wand and Auto Shot shots.
Model region, Empty region and improved WeakAuras imports
Model displays
- Ported missing "Model" display type: a 3D model with rotation, zoom, scale
and alpha, and a model browser with a live preview.
- Creature models can only render textured for creatures your client has seen.
Empty Region
- Ported missing "Empty" display type: displays nothing by itself; attach
sub-regions (text, border, glow) to give it content.
"multi" unit token
- An aura trigger on unit "multi" tracks your debuff on every mob it lands
on. One timer per mob, including mobs you never targeted.
Improved WA2 imports
- Retail icon numbers now resolve to this client's own icons instead of the
missing-texture block where possible.
- A lot of custom Lua written for retail now runs thanks to ClassicAPI 5.1
Lua transpilation efforts.
- Some WA_ group helpers and retail aura getters have been added to a
compatibility layer.
- Retail event names such as UNIT_POWER_UPDATE now work as written: a trigger
listing one is fed by the matching classic events, and custom code checking
the retail name sees it.
- Far more conditions carry over: variables a custom trigger declares, an
aura trigger's group-wide match count and total stacks, a cast's spell
name, and unit death.
- Class-and-spec load rules become class rules; Instance Size matches by
raid head-count (estimated).
- Added fonts used frequently in aura packs: Accidental Presidency,
Expressway, Bazooka, FORCED SQUARE and Cabin.
- Improved the import report to only list what is lost or substituted, at a
fraction of its former length.
Imported code using Lua 5.1 syntax and string methods needs ClassicAPI
1.11.0 or newer.
A pack imported before this release whose custom code checks retail event
names should be re-imported to benefit from these changes.
Triggers
- Weapon Enchant can show while an enchant is missing, or always.
- Power reads the power type you picked: a druid's mana display stays up in
cat or bear form.
- Cooldown Progress (Equipment Slot) gains "Is Usable"; Power gains "Only if
Primary".
- A cooldown trigger for a spell your character has not learned no longer
reads as permanently ready.
Dynamic groups
- Ported missing custom grow: your own Lua function positions the children.
- Children slide to their new slots as clones come and go, instead of
snapping.
- A per-unit-anchored group's offset controls nudge each clone off its
nameplate or unit frame.
Fixes
- Auras anchored to nameplates that only had the GUID and no valid unit token
now land on their own mob's plate instead of the target's.
- Equipment-slot trigger icons survive /reload instead of showing a bag
placeholder until the next import.
WeakestAuras 0.13.0
Radial cooldown swipe and circular progress
- An icon's cooldown swipe is drawn as a real radial wedge instead of a 3D
model, and holds its position while a trigger is paused.
- Icons gain Swipe Color, Cooldown Edge and Cooldown Edge Color, all three
usable in conditions.
- Progress Texture auras take the two circular orientations, Fills Clockwise
and Fills Anticlockwise, with Start angle, End angle and crop.
- Both need ClassicAPI 1.10.0 or newer. On an older one an icon keeps the model
swipe and does not offer the three colour options, and a circular Progress
Texture displays the unsupported-region message.
Icons and rotation in text
- %i renders the trigger's icon inline, Money draws coins, and {rt1} to {rt8}
become raid markers.
- Text sub-regions take a Rotation.
- Text scales past the client's font ceiling, and the Size fields accept a
value above the slider's range.
- The text features above need ClassicAPI 1.10.0 or newer and fall back to
plain text without it. A marker's name is not turned back into {rtN}.
Previewing an aura
- Selecting an aura previews it by running its triggers: a dynamic group shows
its real ordering, limits and stagger, a multi-unit trigger one clone per
member, and custom trigger code the clones it actually produces.
- An aura with custom trigger code can ignore Lua errors thrown while
previewing, from its Info tab.
Dynamic groups
- Clockwise and Counter Clockwise grows, with Constant Factor, Start Angle,
Radius, Angle Between Auras, Full Circle and Total Angle.
Display effects
- The region's own art has a Background row in the effects list, so a glow or
border can be moved below the icon it rings.
Filters that hold several values
- The Class, Race, Faction and Group Type load conditions each offer Ignored,
One Of and Any Of.
- The Instance Type, Stance/Form, Classification and Item Subclass trigger
filters take a set of values.
- Stance/Form matches the shapeshift bar position WeakAuras2 stores, and can be
inverted.
- Unit Characteristics accepts a group, party, raid or nameplate unit and
produces one state per member.
Fixes
- Auras are no longer wiped on login after a session in which the addon refused
to run for a missing client mod.
- A trigger naming a spell whose name ends in parentheses, such as Faerie Fire
(Feral), resolves to that spell instead of the one without the suffix.
- Item Cooldown and Equipment Slot Cooldown gain the Show Global Cooldown
toggle Spell Cooldown had, and the global cooldown is kept out of a cooldown
trigger's duration, remaining time and progress rather than only out of
whether it shows.
- An aura exported by a newer WeakestAuras imports with a warning instead of
being refused; settings the newer version added are lost, the rest arrives.
- The options footer lists what an out-of-date ClassicAPI, SuperWoW or Nampower
is costing you, with a download link for each.
WeakestAuras 0.12.0
- Added weako.xyz companion website integration: an aura downloaded from the
site links back to its page from its Info tab.
- Show the installed client mod versions of ClassicAPI, SuperWoW and Nampower.
- Display effects follow WeakAuras more closely: they can be duplicated and
reordered, and list order is now the draw order -- previously an effect's
type decided what drew on top, whatever order the list was in.
- Improved import and export by adding explicit aura migrations.
WeakestAuras 0.9.0
WeakAuras2 compatibility
- Import many WeakAuras2 export strings, including Wago.io strings, with translation reports and review before installation.
- Added compatibility for WeakAuras2 groups, sub-regions, anchors, conditions, load rules, generic triggers and bundled media.
- Native import/export supports duplicate detection, import-as-copy and individual-aura updates.
Runtime and authoring
- Added custom event triggers and Trigger State Updater custom clones.
- Added clone support for group, party, raid and nameplate unit producers, with dynamic-group sorting, limits and per-unit anchoring.
- Added display animations, chat/sound/custom/glow actions, custom options and additional Classic-era triggers.
- Improved aura tracking beyond the client?s harmful-aura slot limit and strengthened cooldown/GCD handling.
- Bundled additional licensed fonts, status bars, sounds and textures.
Documentation
- Expanded the public README with feature coverage, known limitations, official documentation guidance, Wago.io warnings and sharing instructions.
Texture displays and progress textures
- Add a standalone Texture display with custom texture paths, color, alpha, desaturation, mirror, rotation, blend mode, sizing, and position controls.
- Add a categorized texture picker with Shapes and Blizzard Alerts, live previews, current-texture selection, and manual path entry.
- Add linear Progress Texture displays with foreground/background textures, independent colors and desaturation, four linear orientations, inverse fill, alpha, mirror, texture rotation, Crop X/Y, and Re-center X/Y controls.
- Add the Same Texture option for Progress Texture displays so foreground and background textures can be linked or selected independently.
WeakestAuras 0.7.0 - Anchoring and glow improvements
- Added configurable aura anchoring with a 3x3 point grid.
- Anchor auras to the screen, UI parent, named frames, other WeakestAuras displays, the mouse, unit frames, or nameplates.
- Added a frame chooser for selecting visible frames in the game.
- Added configurable sub-region anchor targets for icons, progress bars, and text.
- Added five glow types: Button Overlay, Pixel, ACShine, Soft, and Pulse.
- Added glow controls for line count, frequency, length, thickness, border, scale, color, shape, area, and offsets.
Custom Lua improvements
- Custom text can read the aura's state and other trigger values through aura_env.
- Custom trigger logic and custom text now share consistent error handling and runtime isolation.
- %c custom text works on text regions and sub-region text.
- Custom Lua state persists between calls and resets when the aura's code changes.
- Fixed custom-code fields opening without their configured defaults.
- Fixed code editors failing to commit and re-colour when focus moves elsewhere.
- Fixed empty custom-text results being treated incorrectly.
- Added validation for optionsim mutation gates.
- No saved-aura migration is required.
Text auras, and better text options
- New "Text" region type: a line of text on its own, either sized to fit its
words or fixed with the text wrapping inside.
- Font options on any text: font, outline, justification, line spacing and
shadow.
- Format options per placeholder: time, big numbers, money, abbreviation and
padding.
- %c custom text on text auras, with your own Lua behind it. Custom text never
travels in an export or a chat link.
- An aura using a region type this addon does not have says so instead of
failing to load.
- Fixed an error when sorting a dynamic group whose child has no timer.
First public release
WeakestAuras brings WeakAuras-style custom aura displays to the 1.12 client:
icons, progress bars and groups, driven by triggers and conditions and
configured entirely in-game.
Requires the ClassicAPI, SuperWoW and Nampower client patches. The addon
refuses to load without them rather than running degraded.
Much of the engine is newly written and has had little time in front of a real
client. Expect rough edges, and please report them.