# BattleFocus

**Repository Path**: xiongliding/BattleFocus

## Basic Information

- **Project Name**: BattleFocus
- **Description**: 战瞳：监控状态，专注战斗。
魔兽世界插件，通过醒目的BUFF提示，帮助你专注战斗。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-13
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 战瞳

监控状态，专注战斗。

## 功能简介

本插件专注于实时监控玩家与目标的 BUFF（增益效果）和 DEBUFF（减益效果），通过醒目且直观的界面展示关键战斗信息，帮助你在战斗中更专注、高效。

### 核心功能

- **战斗状态监控**：持续追踪玩家自身及目标身上的各类 BUFF / DEBUFF。
- **醒目展示**：以直观的界面展示关键状态。
- **自定义配置**：支持自由配置监控项、显示样式与提醒条件。
- **技能施法提示**：智能提示关键技能的施放时机，优化战斗节奏。

### 展示效果

![demo.jpg](doc/demo.jpg)

## 使用说明

### 安装方法

1. 下载插件包并解压。
2. 将解压后的文件夹放入魔兽世界安装目录下的 `Interface/AddOns` 文件夹中。
3. 启动游戏，插件将自动生效。

### 配置说明

通过 `/battlefocus` 或 `/bf` 命令打开设置面板：

- **显示**：调整提示的大小和位置。
- **保持**：配置需要长期保持的增益状态（如各类自我 BUFF）。
- **增益**：监控有时限、可主动获取的增益效果。
- **击发**：监控被动触发的、能增强下一次特定技能的效果。
- **目标**：监控目标身上的特定状态（如需要关注的 DEBUFF 或特定 BUFF）。

![config.jpg](doc/config.jpg)

所有配置项在插件界面中均有悬浮提示说明。以下以戒律牧为例，结合实际场景对各功能进行详解，方便你理解并适配自己的职业与天赋。

本插件的状态与技能图标均由代码实时演算生成（无内置的技能表等数据），不会受到职业或版本限制，只要输入正确的名称即可使用。


#### 1. 确保BUFF不遗漏

- **场景举例**：戒律牧的“心灵之火”可提升法伤，若开战前忘记施放，将导致输出损失。因此需要监控该 BUFF，在其消失或剩余时间不足时提醒补上。
- **配置方法**：在“保持”分类中添加一条记录，BUFF名称填写“心灵之火”，技能名称填写“心灵之火”，并启用。
- **效果说明**：当角色缺少“心灵之火”时，屏幕中央会出现对应的技能图标按钮，点击即可施放。获得 BUFF 后按钮自动隐藏。

补充说明： 
1. 最多可设置 5 个需保持的 BUFF，插件会按顺序提示第一个缺失的状态。
2. 效果相同或互斥的 BUFF 应填写在同一栏，用英文竖线 ```|``` 分隔，例如 ```神圣之灵|精神祷言```。
3. 同名但类型不同的状态可通过添加后缀区分，例如牧师的“启发”效果，主动施放获得的无类型 BUFF 可写为 ```启发:None```，被动触发获得的魔法类型 BUFF 可写为 ```启发:Magic```
4. 插件会缓存技能图标数据以优化性能。若学习新技能（包括宠物和坐骑）或重置天赋后出现图标错乱，可点击设置界面左下角的“清除缓存”或输入 /bf cc 指令刷新

#### 2. 监控技能循环

- **场景举例**：戒律牧输出循环中，“神圣之火”会触发“纯净火焰”，使 10 秒内神圣伤害提高 12%。需在效果结束前补上“神圣之火”。
- **配置方法**：在“增益”分类中添加一条新纪录，BUFF 名称填写”神圣之火“，临界提醒填写“2”，并启用。
- **效果说明**：进入战斗后，若未获得“纯净火焰”，则施放“神圣之火”触发。触发后，角色两侧会显示半月形图标。当剩余时间低于 5 秒时，图标逐渐透明化；低于设定值（2 秒）时，图标开始闪烁，提示即将失效。

补充说明：
1. 最多可设置 5 个增益监控项，触发后按设定顺序由内向外显示在角色两侧。
2. 提示位置固定，即使内侧状态空缺，外侧图标位置不变，便于快速识别。

#### 3. 使用奖励的效果

- **场景举例**：PVP 中被近战贴身后，使用瞬发“神圣新星”有机会触发“灼热之光”，从而实现瞬发“惩击”进行反击。
- **配置方法**：在“击发”分类中添加记录，BUFF 名称填写“灼热之光”，临界提醒设为“2”，并启用。
- **效果说明**：触发“灼热之光”后，角色下方显示对应图标，此时可立即施放“惩击”。效果消耗后图标消失。

补充说明：
1. 最多支持 5 项击发类状态监控，触发后图标按固定位置显示在角色下方。
2. 位置对应关系固定为：5 3 1 2 4，1 位于玩家正下方，便于快速识别。

#### 4. 监控目标状态

- **场景举例**：在团队副本（如奥妮克希亚的巢穴）中，牧师需对目标施放“防护恐惧结界”，施放前需确认该目标是否已有该效果，避免浪费。
- **配置方法**：在“目标”分类中添加一条新记录，BUFF 名称填写“防护恐惧结界”，临界提醒设为“0”，并启用。
- **效果说明**：选中目标后，若其已有该状态，则角色正上方会显示对应图标作为提示。

补充说明：
1. 最多可监控 5 个目标状态，触发时图标按固定位置显示在角色上方。
2. 位置对应关系与“击发”类相同（5 3 1 2 4），1 位于玩家正上方，便于快速识别。
3. 受游戏接口限制，本插件无法获取目标状态的剩余时间及施加者信息。若有此类高级需求，建议搭配专业目标监控插件使用，它们可以根据战斗日志等信息源推测这些信息（尽管也会存在误差）。

## 许可协议

本项目遵循开源协议，请参阅 [LICENSE](LICENSE) 文件了解详细信息。