位面计时器
泰坦重铸版本配置专为魔兽世界泰坦时光服设计的插件，用于跟踪位面存在时间和获取位面ID。
# 位面计时器 (ZoneTimer)
专为魔兽世界泰坦时光服设计的插件，用于跟踪位面存在时间和获取位面ID。
## 功能特点
### 1. 位面计时器
- 实时跟踪位面存在时间
- 支持增加时间（1分钟、5分钟、1小时）
- 支持重置计时器
- 自动更新显示
### 2. 位面ID获取
- 鼠标悬停NPC自动获取位面ID
- 点击按钮获取目标NPC的位面ID
- 显示当前位面ID
- 检测位面变化并提示
### 3. 用户界面
- 简洁明了的主面板
- 小地图按钮快速访问
- 支持窗口拖拽移动
- 实时更新服务器时间
### 4. 命令系统
- `/zt` 或 `/zonetimer` - 打开计时器面板
- `/zt reset` - 重置计时器
- `/zt coords` - 显示当前位面ID
- `/zt help` - 显示帮助信息
## 安装方法
1. 下载插件文件
2. 将 `ZoneTimer` 文件夹复制到游戏目录：
- 魔兽世界怀旧服：`World of Warcraft\_classic_era_\Interface\AddOns\`
- 魔兽世界泰坦时光服：`World of Warcraft\_classic_\Interface\AddOns\`
3. 启动游戏，在角色选择界面启用插件
## 使用指南
### 打开面板
- 点击小地图上的时钟图标
- 或输入命令 `/zt` 或 `/zonetimer`
### 获取位面ID
1. 鼠标悬停在任何NPC或怪物身上
2. 或选择一个NPC或怪物作为目标
3. 点击面板上的"获取目标"按钮
4. 插件会自动解析GUID并显示位面ID
### 跟踪位面时间
1. 打开计时器面板
2. 计时器会自动开始运行
3. 如需调整时间，点击对应的增加时间按钮
4. 如需重置计时器，点击"重置"按钮
### 查看当前位面ID
- 打开计时器面板，底部会显示当前位面ID
- 或输入命令 `/zt coords`
## 技术说明
### 插件版本
- 版本：v1.0.2
- 兼容游戏版本：魔兽世界怀旧服（3.3.5）、泰坦时光服（3.8.0）
### 数据存储
- `ZoneTimerDB`：全局数据库，存储计时器数据、位面ID和设置
- `ZoneTimerCharDB`：角色数据库，存储角色特定数据
### 位面ID解析
- 支持字符串格式GUID（如：Creature-0-6505-571-3952-26593-00000A17A6）
- 支持十六进制格式GUID（如：0x0000000000000000）
- 自动提取实例ID作为位面ID
### 界面适配
- 自动检测游戏版本
- 适配不同版本的UI系统
- 支持8.0+版本的BackdropTemplate
## 常见问题
### Q: 无法获取位面ID
A: 请确保：
1. 鼠标悬停或选择了一个NPC/怪物
2. 目标不是玩家（无法从玩家获取位面ID）
3. 目标有有效的GUID
### Q: 计时器不更新
A: 请确保：
1. 插件已正确加载
2. 游戏客户端时间同步正常
3. 如仍有问题，尝试输入 `/zt reset` 重置计时器
### Q: 小地图按钮不显示
A: 插件默认显示小地图按钮，如未显示可能是：
1. 被其他插件遮挡
2. 小地图按钮区域已满
3. 尝试输入 `/zt` 打开面板
## 更新日志
### v1.0.2（2026-02-14）
- 新增功能：鼠标悬停在猎人宠物或其他玩家宠物身上时不再显示位面变化
- 优化了位面ID获取逻辑，避免误获取宠物的位面信息
- 使用UnitIsOtherPlayersPet API检测其他玩家的宠物
### v1.0.1（2026-02-12）
- 修复API调用错误，使用UnitIsUnit替代不存在的UnitIsOwned函数
- 添加对玩家宠物和召唤物的检查，不获取这些单位的位面ID
- 优化UI布局，实现位面时间和按钮分两行显示
- 调整窗口大小为300*200，优化界面布局
- 所有元素居中显示，提升用户体验
### v1.0.0（2026-02-11）
- 初始版本
- 实现位面计时器功能
- 实现位面ID获取功能
- 添加UI界面和小地图按钮
- 实现命令系统
## 联系作者
如有问题或建议，欢迎联系作者：
- 插件名称：ZoneTimer（位面计时器）
- 作者：SoulBeastMaster
- 版本：v1.0.0
## 许可证
本插件采用 MIT 许可证，可自由使用和修改。
---
感谢使用位面计时器插件！祝您游戏愉快！