mirror of
https://github.com/fuffc/WeakestAuras.git
synced 2026-11-17 16:34:38 +00:00
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.
80 lines
3.5 KiB
Lua
80 lines
3.5 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
|
|
DEFAULT_CHAT_FRAME:AddMessage(
|
|
"|cffff0000WeakestAuras|r [" .. tostring(errTag) .. "] " .. tostring(res), 1, 0.3, 0.3)
|
|
end
|
|
return ok, res
|
|
end
|