# wow-ace

**Repository Path**: chenbool/wow-ace

## Basic Information

- **Project Name**: wow-ace
- **Description**: wow-ace 使用
- **Primary Language**: Lua
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-08-10
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wow-ace

魔兽世界位面 (Layer) 显示插件，基于 Ace 库开发。

## 简介

wow-ace 是一个用于魔兽世界显示当前所在位面的插件。位面是魔兽世界某些区域中存在的不同副本镜像，用于分散玩家数量。插件可以在玩家进入不同位面时显示相关信息。

## 特性

- **位面信息显示** - 在小地图或界面显示当前所在位面编号
- **GUI 交互界面** - 提供可视化框架，包含输入框和按钮组件
- **命令行配置** - 支持 `/wel` 或 `/wh` 命令进行参数配置
- **区域事件监听** - 监听 ZONE_CHANGED 事件，自动检测位面变化
- **多位置信息** - 显示当前位置、绑定点、子区域等信息

## 技术栈

| 库 | 用途 |
|---|---|
| AceAddon-3.0 | 插件框架 |
| AceGUI-3.0 | UI 界面组件 |
| AceConsole-3.0 | 命令行支持 |
| AceEvent-3.0 | 事件系统 |
| AceConfig-3.0 | 配置管理 |

## 文件说明

| 文件 | 说明 |
|---|---|
| layer.lua | 主插件文件，创建 GUI 界面，包含插件生命周期管理 |
| layer.toc | 插件清单文件，定义插件元数据 |
| layer.xml | XML 加载入口 |
| ace/ace.lua | AceGUI 示例 - 框架、输入框、按钮的用法 |
| ace/ace-cmd.lua | 命令行配置示例 - 注册 /wel 和 /wh 命令 |
| ace/ace2.lua | TabGroup 选项卡组件示例 |

## 核心代码

### 创建 GUI 框架

```lua
local frame = AceGUI:Create("Frame")
frame:SetTitle("Layer")
frame:SetStatusText("位面插件")
frame:SetLayout("Flow")
frame:SetWidth(300)
frame:SetHeight(200)
```

### 注册插件

```lua
local AceAddon = LibStub('AceAddon-3.0'):NewAddon("Layer", "AceConsole-3.0", "AceEvent-3.0")
```

### 初始化回调

```lua
function AceAddon:OnInitialize()
    self:Print("插件加载!")
    UIErrorsFrame:AddMessage("插件加载", 1.0, 1.0, 1.0, 5.0)
end
```

### 注册命令

```lua
LibStub("AceConfig-3.0"):RegisterOptionsTable("Layer", options, {"wel", "wh"})
```

### 事件监听

```lua
function AceAddon:OnEnable()
    self:RegisterEvent("ZONE_CHANGED")
end

function AceAddon:ZONE_CHANGED()
    -- 显示位面信息
end
```

## 安装

1. 将 `wow-ace` 文件夹复制到 `World of Warcraft/_retail_/Interface/AddOns/` 目录
2. 重启游戏或使用 `/reload` 重载插件
3. 在插件列表中启用 "Layer" 或 "位面"

## 使用

1. 插件加载后显示 "插件加载" 消息
2. 使用 `/wel` 或 `/wh` 命令打开配置界面
3. 输入消息内容后，区域变化时会显示该消息
4. 插件会自动监听位面变化并输出相关信息

## 插件信息

- **版本**: 1.0
- **作者**: ALA @ bool
- **兼容接口**: 11303
- **默认状态**: 启用
- **保存变量**: LayerTable