# wow-plug

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

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-08-26
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wow-plug 魔兽世界经典怀旧服插件

## 一、项目介绍

wow-plug 是一个**魔兽世界经典怀旧服（Classic Era 1.13.x）右键菜单增强插件**，让你在右键点击目标或队友时，菜单里多出几个实用按钮，一键完成跟随、入队、密语、查询、复制名字、加好友、公会邀请等操作，省去手动打字和翻面板的麻烦。

项目包含两个独立插件，按需选用：

| 插件 | 功能 | 适合人群 |
|------|------|----------|
| **ClassicMenus** | 强制跟随、查询玩家 | 只需要跟随和查询的玩家 |
| **ClassicMenusPlus** | 强制跟随、邀请入队、密语、查询玩家、获取名字、复制全名、添加好友、公会邀请、设为焦点 | 需要完整功能的玩家（推荐） |

> 两个插件功能不同，**不要同时启用**，选一个装就行。

---

## 二、功能说明

### 1. 强制跟随
右键点击目标或队友 → 选"强制跟随"，角色会持续跟随目标移动。
- 屏幕中央会出现一个**停止按钮**，点击即可停止。
- 鼠标移到按钮上会显示**正在跟随谁**。
- 如果目标**消失或死亡**，会自动停止跟随并提示，不用手动点。

### 2. 查询玩家
右键 → 选"查询玩家"，弹出该玩家的详细信息（等级、装备等）。

### 3. 获取名字（仅 ClassicMenusPlus）
右键 → 选"获取名字"，自动把玩家名字填入聊天输入框，省去手动打字。

### 4. 公会邀请（仅 ClassicMenusPlus）
右键 → 选"公会邀请"，直接邀请该玩家加入你的公会。

### 5. 邀请入队（仅 ClassicMenusPlus）
右键 → 选"邀请入队"，直接邀请目标加入你的队伍。

### 6. 密语（仅 ClassicMenusPlus）
右键 → 选"密语"，聊天框自动填好 `/w 玩家名`，直接打字发消息。

### 7. 复制全名（仅 ClassicMenusPlus）
右键 → 选"复制全名"，复制跨服完整名字（`名字-服务器` 格式），方便跨服加好友。

### 8. 添加好友（仅 ClassicMenusPlus）
右键 → 选"添加好友"，把该玩家加入好友列表。

### 9. 设为焦点（仅 ClassicMenusPlus）
右键 → 选"设为焦点"，把目标设为焦点单位，方便宏命令引用。

---

## 三、安装教程（小白必看）

### 第1步：找到游戏插件目录

打开你的魔兽世界安装文件夹，依次进入：

```
魔兽世界安装目录\_classic_era_\Interface\AddOns
```

> **小提示**：
> - 经典怀旧服的文件夹叫 `_classic_era_`，别进错版本。
> - 如果看不到 `Interface` 文件夹，可能是游戏还没创建，启动一次游戏即可。

### 第2步：复制插件

把 `ClassicMenus` **或** `ClassicMenusPlus` 文件夹（二选一）整个复制到 `AddOns` 目录下。

复制后目录结构应该是这样：

```
AddOns\
├── ClassicMenusPlus\       ← 或者 ClassicMenus\
│   ├── ClassicMenusPlus.lua
│   ├── ClassicMenusPlus.toc
│   └── README.md
├── Blizzard_*\            ← 游戏自带插件
└── ...
```

### 第3步：在游戏里启用插件

1. 启动游戏，在角色选择界面左下角点**"插件"**按钮。
2. 在列表里找到 **ClassicMenus**（或 **ClassicMenusPlus**），勾选启用。
3. 点"确定"，进入游戏即可生效。

> 插件无需任何配置，装好启用就管用。

---

## 四、使用教程

1. **打开右键菜单**：右键点击一个目标玩家，或右键点击队友头像。
2. **选择功能**：在菜单底部"扩展"标题下，点击对应功能即可。
3. **停止跟随**：跟随时屏幕中央有按钮，点一下就停。

---

## 五、常见问题（FAQ）

**Q1：插件装了但菜单里没有"扩展"选项？**
- 确认游戏版本是经典怀旧服（`_classic_era_`），不是正式服或燃烧远征服。
- 确认在角色选择界面勾选启用了插件。
- 只对**目标**和**队友**生效，右键点怪物、NPC 不会出现。

**Q2：点击"强制跟随"后没反应？**
- 目标必须在你附近，太远了跟随不上。
- 目标如果隐身、消失、死亡，插件会自动停止并提示。
- 跟随过程中目标移动，插件会每 0.5 秒自动重新跟随，不用管。

**Q3：屏幕中央的停止按钮挡视线了？**
- 点一下按钮就消失。按钮只在跟随时出现，不跟随时不显示。

**Q4：启动时聊天框提示"插件无法启动，缺少必要接口"？**
- 说明游戏版本不兼容，请确认 Interface 版本为 11302（经典怀旧服 1.13.x）。
- 提示里会列出具体缺少的接口名，可反馈给开发者排查。

**Q5：ClassicMenus 和 ClassicMenusPlus 能一起装吗？**
- 不建议。两个插件功能重叠，同时启用菜单里会出现重复项。选一个装即可。

**Q6：支持哪些语言？**
- 支持简体中文（zhCN）、繁体中文（zhTW）、英文（enUS）。其他语言默认显示英文。

**Q7：ClassicMenusPlus 某些功能点了没反应？**
- 邀请入队：你必须是队长或不在队伍中才能邀请。
- 公会邀请：你必须在公会中且有邀请权限。
- 设为焦点：目标必须在视野内。

---

## 六、项目结构

```
wow-plug/
├── ClassicMenus/           # 基础版：强制跟随 + 查询玩家
│   ├── ClassicMenus.lua    # 核心代码
│   ├── ClassicMenus.toc    # 插件信息文件
│   └── README.md           # 插件说明
├── ClassicMenusPlus/       # Plus 版：9 大功能（跟随/入队/密语/查询/名字/全名/好友/公会/焦点）
│   ├── ClassicMenusPlus.lua
│   ├── ClassicMenusPlus.toc
│   └── README.md
├── 原理.md                 # 实现原理说明
├── README.md               # 项目主文档（本文件）
└── README.en.md            # 英文文档
```

---

## 七、参与贡献

1. Fork 本仓库
2. 新建 `Feat_xxx` 分支
3. 提交代码
4. 新建 Pull Request

---

## 八、致谢

- 原作者：[solon](https://github.com/solon)
- 基于 Hook 钩子技术实现，感谢魔兽世界插件社区的技术积累。