Files
WeakestAuras/Compat.lua
T
github-actions[bot] 552e1704a1 WeakestAuras 0.13.0
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.
2026-08-20 08:44:14 +00:00

96 lines
4.4 KiB
Lua

-- WeakestAuras -- Lua 5.0 shims the ported WeakAuras2 idioms lean on. Kept
-- deliberately small: only what's actually used, no speculative polyfills.
-- Upstream section refs (§N) point at design/architecture/weakauras2-reference.md
if WeakestAuras.disabled then return end
local WA = WeakestAuras
-- 5.1 added `math.huge`; 5.0 reads it back as nil, so `x or math.huge` inside a
-- comparison is a runtime error rather than the large number it looks like. The
-- division is how 5.0 spells the same infinity.
WA.INF = 1 / 0
-- One 2^32-millisecond period, in seconds -- the width of the engine's tick
-- counter expressed on GetTime()'s scale.
local TICK_WRAP = 4294967.296
-- Repairs a timestamp ClassicAPI read into a *signed* 32-bit int. Its
-- cooldown backports do `int startMs` and hand back `startMs * 0.001`
-- (src/spell/Cooldown.cpp, src/item/Cooldown.cpp -- the latter shared by
-- GetItemCooldown and C_Container.GetItemCooldown), while the engine's counter
-- is unsigned. Once the machine has been up past 2^31 ms (~24.9 days) every
-- timestamp from those two reads back exactly one period short, and negative:
-- a real start of 2697363.158 arrives as -1597604.138. A timestamp is never
-- legitimately negative, so the sign is the whole test.
--
-- Deliberately not applied everywhere: ClassicAPI's aura and cast paths cast
-- through uint32_t and are already right, as are vanilla's own
-- GetSpellCooldown/GetInventoryItemCooldown. Wrapping a correct value would
-- push it 49.7 days into the future.
function WA.UnwrapTick(t)
if t and t < 0 then return t + TICK_WRAP end
return t
end
-- 5.0 has no `wipe`; clearing keys in place preserves the table identity that
-- callers (memoization caches, per-tick scratch tables) hold a reference to.
function WA.wipe(t)
for k in pairs(t) do t[k] = nil end
return t
end
-- The first `n` *characters* of a UTF-8 string. A plain string.sub cuts on a
-- byte and can land inside a multi-byte sequence, which renders as a garbage
-- glyph -- and every accented spell name on this client is Latin-1 encoded as
-- UTF-8, so that is the common case rather than the exotic one. Continuation
-- bytes are 0x80-0xBF, so anything outside that range starts a character.
function WA.Utf8Sub(s, n)
if type(s) ~= "string" or type(n) ~= "number" or n < 0 then return s end
local len = string.len(s)
local chars = 0
for i = 1, len do
local b = string.byte(s, i)
if b < 128 or b >= 192 then
if chars == n then return string.sub(s, 1, i - 1) end
chars = chars + 1
end
end
return s
end
-- xpcall-wrapped call with the aura id prefixed onto any error, so a broken
-- aura reports itself and fails alone rather than taking down a whole tick
-- (§12's error-attribution pattern, minus the sandbox). 5.0's xpcall
-- takes no call args, so the arguments are captured as upvalues in a wrapper
-- closure instead of forwarded -- capped at eleven, which is what the widest
-- call site needs: a compiled trigger function takes (state, event, arg1..arg9).
-- Returns the pcall-style (ok, result-or-error) so callers can branch on success.
function WA.safecall(errTag, fn, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11)
if type(fn) ~= "function" then return false, "not a function" end
local ok, res = xpcall(function() return fn(a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11) end, function(err)
return err
end)
if not ok then
-- The options preview runs trigger code that was written to read a live
-- event payload, and an aura opted into swallowing that (WA2's
-- ignoreOptionsEventErrors) wants the failure gone, not reported once per
-- preview. Nothing else sets this, and the one setter clears it in the
-- same call.
if WA.silenceErrors then return ok, res end
local message = "[" .. tostring(errTag) .. "] " .. tostring(res)
-- `errTag` is a label for a chat line, and half the call sites are not an
-- aura at all (Comm, the trigger-system dispatch), so it cannot key a
-- per-aura registry. The aura is read off the ambient instead; nil means
-- chat only, which is what a non-aura caller gets. Late-bound because this
-- file loads before both the registry and the aura environment.
local uid = WA.CurrentWarningUid and WA.CurrentWarningUid()
if uid and WA.UpdateWarning then
WA.UpdateWarning(uid, "runtime:" .. tostring(errTag), "error", message, true)
else
DEFAULT_CHAT_FRAME:AddMessage("|cffff0000WeakestAuras|r " .. message, 1, 0.3, 0.3)
end
end
return ok, res
end