BossAuras

# Boss Auras

**Boss Auras** displays harmful boss debuffs applied to **your character** in a clean, fully customizable icon layout. It's a standalone, lightweight extraction of BigWigs' aura module — no BigWigs required.

Whether you're tracking a stacking DoT during a raid encounter or a dispellable magic debuff in Mythic+, Boss Auras gives you complete control over how it looks and where it sits on your screen.

## Features

### Icon Customization
- Adjustable icon **size** (width & height, 24–256 px)
- **Zoom** the icon inside its frame without changing the frame size
- **Keep Aspect Ratio** option for non-square icons
- Configurable **spacing** between icons
- Choose **max icons** (1–5)
- Six **growth directions**: Left, Right, Up, Down, Center Horizontal, Center Vertical
- Toggle **cooldown swipe** on or off
- Optional **tooltip** on hover

### Border
- Any border style registered with **LibSharedMedia-3.0** (Solid, None, and any others you have installed)
- Adjustable border **size** and **offset**
- **Dispel-type coloring** — automatically tint the border by Magic / Curse / Disease / Poison / Enrage / Bleed
- Or set a **custom fixed color** with full alpha support

### Cooldown Text
- Choose any **LibSharedMedia font**
- Adjustable font **size** (8–200)
- **Outline** (None / Thin / Thick)
- **Monochrome** and **Slug** rendering options
- Position anywhere on the icon with **9 anchor points** and fine-tune with X/Y offsets
- Full **color** control with alpha
- **Decimal threshold** — show tenths of a second below a configurable number of seconds
- **Emphasize** color when the aura is about to expire (configurable trigger time and color)

### Dispel Type Indicator
- Optional **corner icon** showing the aura's dispel type
- Adjustable **size** (1–64 px)
- Position with **9 anchor points** plus X/Y offsets

### Stack Count
- Optional **stack number** display
- Choose any **LibSharedMedia font**
- Adjustable font **size**, **outline**, **monochrome**, and **slug** rendering
- 9 anchor points with X/Y offset tuning
- Full color and alpha control

### Positioning
- **Drag-to-position** mode — click "Toggle Anchors" in the options, drag the yellow frame, done
- **Precise position** panel with exact X / Y coordinates (±2048)
- Anchor relative to **any frame** by name (e.g. `UIParent`, `PlayerFrame`)
- Choose source and destination anchor points (9 × 9 combinations)

### Smart Filtering
Automatically ignores debuffs that are not worth tracking, including:
- **Deserter / Dungeon Deserter / Challenger's Burden**
- **Bloodlust / Heroism family** (Exhaustion, Sated, Temporal Displacement, Insanity, Fatigued)
- **Stagger** and other non-boss debuffs

Only boss-applied harmful debuffs on the player are shown.

## Usage

- Type `/ba` or `/bossauras` to open the options panel
- Also available under **Interface → AddOns → Boss Auras**
- Click **创建测试光环 / Create Test Aura** to preview your settings with fake auras
- Click **显示/隐藏锚点 / Toggle Anchors** to drag the icon group into place

## Requirements

- World of Warcraft **Retail 11.0+** (uses the modern `CustomAuraContainer` API)
- **LibSharedMedia-3.0** (included)
- **Ace3** (included)

## Notes

- This addon only handles debuffs on **you** (the player). It does not display debuffs on tanks, other group members, or enemies.
- No aura sounds, no boss timers, no bars — just a focused, high-quality debuff display.
- All settings are per-profile via AceDB, so you can share your layout across characters.

## Credits

Extracted and adapted from the aura module of **BigWigs Bossmods** by the BigWigs team. Huge thanks to them for the original design and implementation.

--------------------------------------------------------------------------------------------- # 首领光环（Boss Auras）

**首领光环** 用于在屏幕上以整齐、高度可自定义的图标形式显示**首领施加在你身上**的减益效果。它是从 BigWigs 光环模块中提取出的单体插件，**无需安装 BigWigs**。

无论你是在团队副本中追踪可叠加的持续伤害，还是在大秘境中监控可驱散的魔法减益，首领光环都能让你完全掌控图标的外观与位置。

## 功能特色

### 图标自定义
- 可调图标**尺寸**（宽 × 高，24–256 像素）
- **缩放**选项，在不改变外框大小的前提下缩放图标
- **保持宽高比**，适配非正方形图标
- 可调**图标间距**
- 可选**最大图标数**（1–5）
- 六种**排列方向**：向左、向右、向上、向下、水平居中、垂直居中
- 可开关**冷却扫动**动画
- 可选鼠标悬停**提示信息**

### 边框
- 支持所有已通过 **LibSharedMedia-3.0** 注册的边框样式（含纯色、无边框，以及你安装的其他样式）
- 可调边框**大小**与**外扩**
- **按驱散类型着色** —— 边框自动随魔法 / 诅咒 / 疾病 / 中毒 / 激怒 / 流血变化
- 或使用**自定义固定颜色**，支持透明度

### 冷却文字
- 任意 **LibSharedMedia 字体**
- 可调**字号**（8–200）
- **描边**（无 / 细 / 粗）
- **单色渲染**与 **Slug 渲染**选项
- 使用 **9 个锚点**定位到图标任意位置，并通过 X/Y 偏移微调
- 完整的**颜色**控制，支持透明度
- **小数阈值** —— 剩余时间低于设定秒数时显示小数
- **强调**颜色 —— 光环即将结束时自动切换颜色（触发时间与颜色可配置）

### 驱散类型指示器
- 可选在图标角落显示该减益的**驱散类型图标**
- 可调**大小**（1–64 像素）
- **9 个锚点**定位，配合 X/Y 偏移微调

### 层数
- 可选**层数数字**显示
- 任意 **LibSharedMedia 字体**
- 可调**字号**、**描边**、**单色**与 **Slug 渲染**
- 9 个锚点 + X/Y 偏移
- 完整颜色与透明度控制

### 定位
- **拖动定位**模式 —— 在设置中点击「显示/隐藏锚点」，拖动黄色框即可
- **精确位置**面板，支持精确 X / Y 坐标（±2048）
- 可依附于**任意框架**（如 `UIParent`、`PlayerFrame` 等）
- 自由选择起点锚点与终点锚点（9 × 9 组合）

### 智能过滤
自动忽略不值得追踪的减益，包括：
- **逃亡者 / 地下城逃亡者 / 挑战者的负担**
- **嗜血 / 英勇类**（疲惫、心满意足、时空错位、疯狂、疲劳）
- **醉拳**及其他非首领减益

仅显示首领对你施加的有害减益。

## 使用方法

- 输入 `/ba` 或 `/bossauras` 打开设置面板
- 也可通过 **界面 → 插件 → 首领光环** 进入
- 点击 **创建测试光环** 用假图标预览当前样式
- 点击 **显示/隐藏锚点** 拖动图标组到目标位置

## 前置需求

- 魔兽世界 **正式服 11.0+**（使用了新版 `CustomAuraContainer` API）
- **LibSharedMedia-3.0**（已内置）
- **Ace3**（已内置）

## 说明

- 本插件仅处理施加在**你身上**的减益，不显示坦克、其他队员或敌方单位身上的减益。
- 没有音效、没有首领计时条——只专注于高质量、可自定义的减益显示。
- 所有设置均通过 AceDB 按配置档保存，可在多角色间共享。

## 致谢

本插件改编自 **BigWigs Bossmods** 的光环模块，原作者为 BigWigs 团队。感谢他们提供的原始设计与实现。

## 许可协议

本插件基于 **GNU 通用公共许可证 v2.0** 发布，因为它衍生自同样采用 GPL-2.0 的 BigWigs Bossmods。
详见 LICENSE 文件。