# 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-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wow-ace 位面插件

> 魔兽世界怀旧服「位面」显示与区域切换提示插件，基于 Ace3 库开发。

## 这个插件能做什么

- **位面信息窗口**：进入游戏后自动弹出一个可拖拽、可缩放的小窗口，显示位面相关信息
- **区域切换提示**：每次走到新区域，自动在聊天栏显示你预设的提示文字、绑定点（炉石位置）和子区域名
- **聊天栏命令配置**：不用改文件，直接在游戏聊天栏敲命令就能改设置
- **自动保存设置**：你的所有设置会自动保存，换角色、重装插件都不丢

## 安装教程（一步步来）

### 第 1 步：确认你有 Ace3 库

本插件依赖 Ace3 库。如果你装过其他用 Ace3 的插件，通常已经有了。检查方法：

1. 打开魔兽世界安装目录，找到 `Interface\AddOns\` 文件夹
2. 看里面有没有叫 `Ace3` 的文件夹
3. 如果没有，去 [CurseForge](https://www.curseforge.com/wow/addons/ace3) 下载 Ace3，解压到 `AddOns` 目录

### 第 2 步：放入插件

1. 把整个 `wow-ace` 文件夹复制到魔兽世界的插件目录：
   - **怀旧服**：`World of Warcraft\_classic_\Interface\AddOns\`
   - **正式服**：`World of Warcraft\_retail_\Interface\AddOns\`
2. 复制完后，`AddOns` 目录里应该有 `wow-ace` 这个文件夹，里面有 `layer.toc` 等文件

### 第 3 步：进游戏确认

1. 启动游戏，在角色选择界面左下角点「插件」按钮
2. 在列表里找到「Layer」或「位面」，确保它是打勾（启用）的
3. 进入游戏，聊天栏会出现「插件加载!」和「Hello World!」，屏幕中央会闪过「位面插件已加载」

> 如果没看到加载提示，输入 `/reload` 重载界面试试。

## 使用教程

### 打开/关闭窗口

进游戏后窗口会自动出现。关掉后想再打开，重载界面即可：在聊天栏输入 `/reload` 回车。

### 用命令改设置（推荐）

在聊天栏输入以下命令：

| 命令 | 作用 | 举例 |
|------|------|------|
| `/layer` 或 `/ly` | 打开设置面板 | `/layer` |
| `/layer msg 你的文字` | 设置区域切换时显示的提示文字 | `/layer msg 欢迎来到新地图` |
| `/layer toggle` | 开启/关闭区域切换提示 | `/layer toggle` |

### 调整窗口大小

直接拖动窗口边缘就能缩放。最小能缩到 100×80，最大能放到 800×600，不会拖到看不见。

## 常见问题排错（FAQ）

### Q1：进游戏没看到窗口，也没看到加载提示

**可能原因与解决**：
1. **没装 Ace3 库** → 屏幕中央会红字提示「缺少 Ace3 库」。按上面安装教程第 1 步装好 Ace3
2. **插件没启用** → 在角色选择界面点「插件」按钮，把「Layer」打勾
3. **没重载界面** → 聊天栏输入 `/reload` 回车

### Q2：屏幕中央红字提示「缺少 Ace3 库」

说明 Ace3 库没装好。请确认 `Interface\AddOns\Ace3` 文件夹存在，且里面有 `.toc` 文件。

### Q3：切换区域时没提示

检查是否关闭了提示开关：输入 `/layer toggle` 重新开启。

### Q4：提示文字太长被拒绝

提示文字最多 100 个字。请缩短后重新设置。

### Q5：窗口拖太小看不到了

窗口有最小尺寸保护（100×80），不会真的拖没。如果实在找不到，输入 `/reload` 重载，窗口会回到默认位置和大小。

### Q6：换角色后设置还在吗

在。所有设置都自动保存在 `WTF\Account\你的账号\SavedVariables\LayerTable.lua`，换角色不丢。

## 插件信息

| 项目 | 内容 |
|------|------|
| 版本 | 1.0 |
| 作者 | ALA @ bool |
| 兼容客户端 | 魔兽世界怀旧服（接口 11303） |
| 依赖库 | Ace3（必须） |
| 默认状态 | 启用 |
| 保存变量 | LayerTable |
| 聊天命令 | `/layer`、`/ly` |

## 文件说明

| 文件 | 说明 |
|------|------|
| `layer.toc` | 插件清单，告诉游戏怎么加载、依赖什么 |
| `layer.xml` | 加载入口，指引到主脚本 |
| `layer.lua` | **主程序文件**，所有功能都在这里 |
| `ace/` | 开发参考目录，里面是 Ace3 各种组件的用法示例，插件运行时不会加载 |
| `原理.md` | 插件实现原理详解（偏技术，普通用户可不看） |

> 说明：`ace/` 目录和根目录的「副本」文件是开发时留的参考样例，插件实际运行只用到 `layer.toc`、`layer.xml`、`layer.lua` 三个文件。普通用户无需关心它们。