# wow-BoomTime

**Repository Path**: game_87/wow-boom-time

## Basic Information

- **Project Name**: wow-BoomTime
- **Description**: BoomTime
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-05
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BoomTime 爆本监控插件

<p align="center">
  <img src="https://img.shields.io/badge/版本-113r.191127-blue" alt="版本">
  <img src="https://img.shields.io/badge/游戏-魔兽世界-yellow" alt="游戏">
  <img src="https://img.shields.io/badge/语言-Lua/XML-green" alt="语言">
</p>

为魔兽世界玩家打造的副本重置时间追踪插件，实时显示副本次数剩余时间。

---

## ✨ 功能特性

| 功能 | 说明 |
|:---|:---|
| 🔄 副本重置追踪 | 自动监听系统消息，记录副本次数 |
| ⏱️ 实时倒计时 | 显示距离下次可用副本次数剩余时间 |
| 📢 自动通报 | 副本重置时自动发送团队通知 |
| 🖱️ 可拖拽面板 | 支持鼠标拖动调整位置 |
| 🔒 锁定/解锁 | 右键菜单可锁定面板防止误触 |

---

## 🏗️ 实现原理

### 事件监听机制

```
PLAYER_ENTERING_WORLD  →  玩家进入世界时初始化
CHAT_MSG_SYSTEM        →  监听副本重置系统消息  
ZONE_CHANGED_NEW_AREA  →  区域变化时更新状态
```

### 副本重置检测

```lua
-- 将游戏内置消息转换为 Lua 模式
INSTANCE_RESET_FAILED   →  "重置失败: (.+)"
INSTANCE_RESET_SUCCESS  →  "重置成功: (.+)"
```

### 时间计算

```lua
-- 清理过期数据 (1小时前)
for i = #instance_timer_sv, 1, -1 do
    if instance_timer_sv[i] < time() then
        tremove(instance_timer_sv, i)
    end
end

-- 倒计时显示
display_time = instance_timer_sv[i] - time()
```

### UI 面板创建

```lua
-- 创建可拖拽框架
board = CreateFrame("Frame", nil, UIParent, "BackdropTemplate")
board:SetMovable(true)
board:SetScript("OnMouseDown", function() self:StartMoving() end)
board:SetScript("OnMouseUp", function() self:StopMovingOrSizing() end)
```

### 数据持久化

| 变量 | 说明 |
|:---|:---|
| `boomTimeSv` | 全局共享变量 |
| `boomTimeSv.instance_timer_sv` | 副本次数数组 |
| `boomTimeSv.target_warn_sv` | 目标警告设置 |

---

## 📁 项目结构

```
BoomTime/
├── BoomTime.lua           # 主逻辑 (UI创建、事件处理)
├── BoomTime_Run.lua      # 入口文件 (初始化、事件注册)
├── BoomTime.toc          # 插件清单 (元信息配置)
├── BoomTime.xml          # UI定义 (脚本加载顺序)
├── 原理.md               # 实现原理详解
├── Ignore.info           # 忽略文件列表
├── LICENSE               # MIT 许可证
└── README.md             # 项目文档
```

---

## 📥 安装方法

```bash
# 1. 下载插件压缩包
# 2. 解压到以下目录
World of Warcraft/_retail_/Interface/AddOns/BoomTime/

# 3. 重启游戏或使用 /reload 加载插件
```

---

## 📖 使用说明

| 操作 | 说明 |
|:---|:---|
| 🖱️ 左键拖动 | 移动面板位置 |
| 🖱️ 右键菜单 | 锁定/关闭面板 |

> ⚠️ 插件默认显示 **5** 次数，每个次数有效期 **1 小时**

---

## 🌍 支持服务器

- ✅ 国服
- ✅ 台服  
- ✅ 港服

---

## 📝 版本历史

| 版本 | 日期 | 更新内容 |
|:---|:---|:---|
| 113r.191127 | 2019-11-27 | 初始版本 |

---