PhaseWatcher

PhaseWatcher is a lightweight World of Warcraft addon designed to track and display Phase IDs, ZoneUIDs, and NPC GUID information. It provides essential phasing data to help players and developers verify if they are in the same shard or layer as their target.

🌟 Features

• Phase & GUID Tracking: Real-time monitoring of NPC and Player Phase IDs.
• Modern API Support: Built for WoW 11.0+ and 12.0+, utilizing MenuUtil and the native Settings API to eliminate taint.
• Accurate Parsing: Correctly interprets decimal ZoneUIDs and handles protected "Secret Values" in instances.
• Customizable UI: Full control over font size, transparency, update interval, and window behavior via a modern Settings panel.
• Visual Indicators: Color-coded status for Player (Green), Target (Teal), Cached (Grey), and Secret/Hidden (Orange) sources.

📋 Changelog

v2.1.0 - Modernization & Localization Fixes

🐛 Bug Fixes

• Slash command crash: Fixed string.trim → strtrim which made all slash commands unusable.
• ZoneUID parsing: Relaxed upper bound from 999999 to 1e8 to avoid rejecting valid high‑range phase IDs.
• Database migration: Table‑type defaults (e.g. background color) now merge missing sub‑keys, preventing nil‑alpha issues.
• Right‑click menu localization: Added dedicated translation keys (BUTTON_RESET_POSITION, BUTTON_CLEAR_CACHE) for zhCN/zhTW clients.

✨ Improvements

• Modern Settings Panel: Completely rebuilt using Settings.RegisterVerticalLayoutCategory + Settings.RegisterProxySetting. All checkboxes and sliders are now native UI elements.
• Slider live labels: Sliders for update interval, font size, and transparency use MinimalSliderWithSteppersMixin.Label.Right for real‑time value display with units.
• Scaled position saving: Window position is now stored relative to UIParent center while compensating for UI scale, keeping the frame stable across resolutions.

v2.0.0 - Major Update: Architecture Refactor & 12.0 API Support

This update was a complete rewrite to fully support World of Warcraft 11.0+ (The War Within) and upcoming 12.0 API changes, addressing previous API taint issues and parsing errors.

🌟 Highlights

• Full 11.0+ / 12.0 API Support:
  • Replaced deprecated UIDropDownMenu with the native MenuUtil for context menus, eliminating UI Taint issues during combat.
  • Updated to the new Settings API (Settings Category) for full compatibility with the modern UI.
• Architecture Refactor (Pure Lua):
  • Removed XML dependencies in favor of Pure Lua UI construction for better stability.
  • Modularized code structure (Core, UI, Localization) for cleaner logic.

🐛 Fixes & Optimizations

• Critical Fix for Secret Values: Implemented strict protection against "Secret Values" (hidden GUIDs in instances/raids) to prevent addon crashes in restricted environments.
• GUID Parsing Fix: Corrected the logic for parsing NPC Phase IDs. It now correctly interprets the decimal ZoneUID from the GUID, fixing previous inaccuracies.
• Performance: Optimized settings sliders to prevent excessive updates while dragging.

✨ New Features

• Enhanced Appearance Settings:
  • Added options to customize Font (System/Chat/Combat), Font Size, Window Style (Blizzard Dialog/Tooltip/Flat/None), Transparency, Background Color, and Border Color.
  • Settings panel now uses Radio Buttons for easier selection.
• Visual Improvements:
  • Color-coded sources: Green (Player), Teal (Target/Mouseover), Grey (Cached), Orange (Secret/Hidden).
  • Added drag hints and detailed tooltips.

---

PhaseWatcher (位面监视器)

PhaseWatcher 是一款专为魔兽世界设计的轻量级插件，用于追踪和显示位面 ID (Phase ID)、区域 UID (ZoneUID) 以及 NPC GUID 信息。它能帮助玩家和开发者确认当前位面状态，确保你与目标处于同一镜像或分层中。

🌟 功能特性

• 位面与 GUID 追踪：实时监控并显示 NPC 和玩家的位面 ID。
• 现代 API 支持：完美适配 WoW 11.0+ 和 12.0+，使用 MenuUtil 和原生 Settings API，彻底解决 Taint 问题。
• 精准解析：正确解析 GUID 中的十进制 ZoneUID，并严格保护副本中的 "Secret Values" (隐藏 GUID)。
• 高度可定制：通过现代化的设置面板完全控制字体大小、透明度、更新间隔及窗口行为。
• 视觉指示：清晰的颜色编码状态 —— 绿色(玩家)、青色(目标)、灰色(缓存)、橙色(受限/隐藏)。

📋 更新日志

v2.1.0 - 现代化与本地化修复

🐛 错误修复

• 斜杠命令崩溃：修复了 string.trim 错误（改为 strtrim），恢复 /pw 命令功能。
• ZoneUID 解析：放宽上限至 1e8，避免丢弃有效的高范围位面 ID。
• 数据库迁移：对表类型默认值（如背景色）进行浅合并，防止缺失 alpha 键导致显示异常。
• 右键菜单本地化：新增专用翻译键 (BUTTON_RESET_POSITION、BUTTON_CLEAR_CACHE)，修复中文环境下显示英文按钮的问题。

✨ 改进

• 现代化设置面板：使用 Settings.RegisterVerticalLayoutCategory + Settings.RegisterProxySetting 完全重构，所有复选框和滑块均为原生控件。
• 滑块实时标签：更新间隔、字体大小和透明度滑块通过 MinimalSliderWithSteppersMixin.Label.Right 实时显示带单位的数值。
• 缩放感知的位置保存：窗口位置以 UIParent 中心为基准保存，并补偿 UI 缩放，确保跨分辨率稳定。

v2.0.0 - 核心变动：架构重构与 12.0 API 适配

本次更新是对插件的全面重写，旨在完美支持魔兽世界 11.0+ (地心之战) 及未来的 12.0 版本，并解决了旧版本存在的 API 污染和解析错误问题。

🌟 主要更新

• 全面适配 11.0+ / 12.0 API：
  • 移除了过时的 UIDropDownMenu，改用原生 MenuUtil 构建右键菜单，彻底解决了战斗中可能出现的 UI 污染 (Taint) 问题。
  • 适配了新的设置面板 API (Settings Category)，确保配置界面在最新客户端中正常工作。
• 架构重构 (Pure Lua)：
  • 移除了 XML 依赖，采用纯 Lua 构建 UI，提升了加载稳定性和维护性。
  • 模块化拆分 (Core, UI, Localization)，代码逻辑更清晰。

🐛 修复与优化

• Secret Value 崩溃修复：针对副本/团本中的 "Secret Values" (隐藏 GUID) 实施了最严格的保护措施，防止插件在受限环境下因尝试读取受保护数据而崩溃。
• GUID 解析修正：修复了 NPC 位面 ID 解析逻辑。现在能正确识别 GUID 中的十进制区域 ID，不再错误地将其作为十六进制处理，大幅提高了检测准确率。
• 性能优化：优化了设置面板滑块的响应逻辑，避免在拖动时频繁触发后台更新。

✨ 新增功能

• 增强的外观设置：
  • 新增自定义 字体 (系统/聊天/战斗)、字体大小、窗口风格 (暴雪对话框/提示框/扁平/无背景)、透明度、背景颜色 和 边框颜色 的选项。
  • 设置面板现在使用单选按钮 (Radio Buttons) 进行更直观的选择。
• 状态指示优化：
  • 新增颜色编码：绿色(玩家)、青色(目标/鼠标)、灰色(缓存)、橙色(受限)。
  • 新增拖拽提示和详细的鼠标悬停 Tooltip。