法术警报计时器 (SpellAlertTimer / SAT)

在暴雪「法术警报」上显示倒计时文字，让你清楚知道核心技能警报还剩多少秒。

简介

法术警报计时器 (SpellAlertTimer / SAT) 是一个轻量级插件，在暴雪自带的「法术警报 (Spell Alert)」图标上叠加显示对应技能的剩余倒计时。

很多职业的核心触发（如节能施法、各类「可用 / 触发」提示）会以法术警报的形式弹出，但暴雪原版只显示图标，不显示剩余时间。本插件让你一眼看清警报还能持续多久，方便安排下一个技能。

特性

• 在暴雪法术警报框体上直接叠加倒计时数字，位置自动跟随
• 数字小于 10 秒时显示小数点，更精确
• 支持法术 ID 映射，可将同一技能的不同表现统一为一个（内置节能施法等）
• 支持屏幕左右位置微调偏移
• 使用暴雪 12.1 全新 AuraContainer 光环系统，不读取受保护的光环数值（secret 值），安全高效
• 按需创建，几乎零资源占用

使用方法

无需任何设置，安装即用。请确保游戏内已开启法术警报：

ESC → 选项 → 战斗 → 法术警报 (Spell Alert)，并调节「法术警报不透明度」。

法术 ID 映射

暴雪法术警报提供的 SPELL_ID 有时并非该技能的真实法术 ID，需映射到实际 SPELL_ID 才能正确显示倒计时。内置已映射节能施法等常见情况，如需修改，打开 SpellAlertTimer.lua 顶部的 SPELL_ALIAS 表：

local SPELL_ALIAS = {
    [1277420] = 263725,  -- 节能施法 1 层
    [1277421] = 263725,  -- 节能施法 2 层
    [1277422] = 263725,  -- 节能施法 3 层
}

> 注意：如果技能触发时身上明明有 BUFF 却不显示倒计时，说明该法术 ID 尚未正确映射。请在评论区留言，我会调整；或联系 32655163@qq.com。

要求

• World of Warcraft Retail 12.1 或更高版本
• 依赖暴雪 12.1 新增的 CustomAuraContainerTemplate (AuraContainer)。若模板不存在，插件会自动停用不报错。

作者

• CN-无尽之海-简繁丶

SpellAlertTimer (SAT)

A lightweight addon that displays a countdown timer on Blizzard's Spell Alert overlays, so you always know how long your procs and triggers last.

About

SpellAlertTimer (SAT) is a lightweight addon that overlays a countdown timer on Blizzard's Spell Alert icons.

Many class procs (Clearcasting, etc.) appear as Spell Alerts, but Blizzard only shows the icon without the remaining time. This addon lets you see at a glance how long the alert lasts.

Features

• Overlays countdown text directly on the Blizzard Spell Alert frame, auto-following its position
• Shows a decimal point when under 10 seconds for precision
• Spell ID alias mapping to unify different spell IDs of the same ability (e.g. Clearcasting)
• Adjustable left/right pixel offset
• Built on the 12.1 AuraContainer system — never reads protected (secret) aura values
• Created on-demand, near-zero resource usage

Usage

No configuration needed — just install and it works, as long as Spell Alert is enabled under ESC → Options → Combat → Spell Alert.

Spell ID Alias Mapping

The SPELL_ID from Blizzard's Spell Alert is sometimes not the real spell ID; it must be mapped to the actual SPELL_ID to show the countdown correctly. Common cases (e.g. Clearcasting) are pre-mapped. To modify, open SpellAlertTimer.lua and adjust the SPELL_ALIAS table:

local SPELL_ALIAS = {
    [1277420] = 263725,  -- Clearcasting (1 stack)
    [1277421] = 263725,  -- Clearcasting (2 stacks)
    [1277422] = 263725,  -- Clearcasting (3 stacks)
}

> Note: If a proc triggers and you have the buff but no countdown appears, the spell ID likely isn't mapped yet. Please leave a comment and I'll fix it, or contact me at 32655163@qq.com.

Requirements

• World of Warcraft Retail 12.1+
• Requires Blizzard's CustomAuraContainerTemplate (AuraContainer). The addon auto-disables gracefully if the template isn't present.

Author

• CN-无尽之海-简繁丶