# boomTime

**Repository Path**: chenbool/boom-time

## Basic Information

- **Project Name**: boomTime
- **Description**: boomTime 爆本插件
- **Primary Language**: Lua
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-09-21
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# boomTime 爆本监控

## 插件介绍

boomTime（爆本监控）是一款魔兽世界插件，专门用于追踪副本重置冷却时间。在魔兽世界中，每次使用 `/reload`、退出游戏或切换副本后，副本会有1小时的重置冷却时间。该插件帮助玩家实时监控可用的重置次数，避免错过重置时机。

## 功能特性

### 1. 副本重置监控
- **实时计时显示**：UI面板上显示10个副本重置槽位，每个槽位独立倒计时
- **自动检测**：通过监听游戏系统消息自动检测副本重置事件
- **智能清理**：过期的时间戳自动移除，显示当前可用的重置次数
- **跨角色存储**：按角色保存数据，每个角色独立追踪

### 2. 通知系统
- **团队/小队通知**：副本重置时自动发送 `{rt1}副本 已重置，请进入副本！{rt1}` 消息
- **密语通知（可选）**：可开启给自己发送私聊的功能，确保不会错过

### 3. 用户界面
- **可拖拽面板**：左键拖拽移动面板位置
- **锁定功能**：锁定后面板不可移动，防止误操作
- **显示/隐藏**：可随时切换面板显示状态
- **位置记忆**：面板位置自动保存，重启游戏后保持

### 4. 斜杠命令

| 命令 | 说明 |
|------|------|
| `/btm` | 切换面板显示/隐藏状态 |
| `/btm on` | 显示面板 |
| `/btm off` | 隐藏面板 |
| `/btm lock` | 锁定面板位置 |
| `/btm unlock` | 解锁面板位置 |
| `/btm toggle_lock` | 切换锁定状态 |
| `/btm whisper on` | 开启密语通知 |
| `/btm whisper off` | 关闭密语通知 |
| `/btm rest` | 重置面板位置到屏幕中央 |

## 软件架构

### 技术栈
- **编程语言**：Lua
- **插件接口**：World of Warcraft Interface 21303
- **框架**：WoW UI API (FrameXML)

### 文件结构

```
BoomTime/
├── BoomTime.toc      -- 插件清单文件，定义插件元信息
├── BoomTime.xml      -- UI加载配置，引入Lua脚本
├── BoomTime.lua      -- 主功能脚本，包含UI和核心逻辑
└── BoomTime_Run.lua  -- 运行时初始化脚本，处理变量初始化
```

### 核心模块

#### BoomTime.lua
- UI 面板创建与渲染
- 拖拽移动实现
- 系统消息监听
- 计时器更新逻辑
- 斜杠命令处理

#### BoomTime_Run.lua
- 保存变量初始化
- 角色配置管理

## 安装指南

### 系统要求
- 魔兽世界正式服（Retail）
- 游戏版本兼容 Interface 21303

### 安装步骤

1. **下载插件**
   - 从发布页面下载 `BoomTime.zip` 压缩包

2. **解压文件**
   - 解压后得到 `BoomTime` 文件夹

3. **复制到插件目录**
   - 将 `BoomTime` 文件夹复制到：
   ```
   World of Warcraft\_retail_\Interface\AddOns\
   ```

4. **启用插件**
   - 启动游戏
   - 在角色选择界面点击"插件"按钮
   - 勾选启用 BoomTime

5. **进入游戏**
   - 创建角色或选择已有角色进入游戏
   - 插件将自动加载运行

## 使用教程

### 初次使用

1. 登录游戏后，屏幕中央会显示副本监控面板
2. 面板显示 01-10 共10个槽位
3. 当显示"可用"时，表示该副本重置次数可用

### 查看倒计时

1. 每次副本重置后，对应槽位会显示倒计时
2. 格式为 `[MM:SS]`，例如 `[45:32]` 表示还剩45分32秒
3. 倒计时结束后，该槽位恢复为"可用"状态

### 移动面板

1. 确保面板未锁定（半透明表示已锁定）
2. 如已锁定，输入 `/btm unlock` 解锁
3. 左键拖拽面板到 desired 位置
4. 位置会自动保存

### 锁定面板

1. 输入 `/btm lock` 锁定面板
2. 锁定后面板变为半透明，不可移动
3. 防止意外拖拽导致位置变化

### 接收通知

1. 默认情况下，副本重置会发送小队消息
2. 如需密语通知自己，输入 `/btm whisper on`
3. 关闭密语通知，输入 `/btm whisper off`

## 常见问题

### Q: 为什么我的重置次数没有正确显示？
A: 请确保插件已正确加载，检查是否在角色选择界面启用了插件。另外，重置检测依赖游戏系统消息，可能需要一定时间延迟。

### Q: 面板显示"可用"但实际不可用？
A: 插件基于游戏消息检测，如果使用第三方插件屏蔽了系统消息，可能导致检测失败。建议检查消息过滤设置。

### Q: 如何重置面板位置？
A: 输入 `/btm rest` 命令可重置面板位置到屏幕中央。

### Q: 为什么时间显示不准确？
A: 时间计算已考虑时区因素。如有明显偏差，可能是游戏客户端时间不同步导致。

## 版本信息

- **版本号**：113r.191127
- **作者**：ALA @ Sloan
- **接口版本**：21303
- **语言**：简体中文

## 依赖说明

- 无外部依赖
- 使用魔兽世界内置的 SavedVariables 进行数据持久化

## 注意事项

1. 本插件仅支持魔兽世界正式服
2. 插件不会修改游戏数据，仅用于信息显示
3. 重置检测依赖游戏系统消息，不同语言版本可能存在兼容性问题
4. 建议在使用前阅读代码，确保安全可靠