# wow-uutools

**Repository Path**: game_87/wow-uutools

## Basic Information

- **Project Name**: wow-uutools
- **Description**: uutools
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-05
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uutools - 魔兽世界悠悠卫士反欺诈插件

<p align="center">
  <img src="https://img.shields.io/badge/版本-v1.3-blue" alt="版本">
  <img src="https://img.shields.io/badge/游戏-魔兽世界-yellow" alt="游戏">
  <img src="https://img.shields.io/badge/语言-Lua-green" alt="语言">
  <img src="https://img.shields.io/badge/平台-国服%7C台服%7C港服-orange" alt="平台">
</p>

为魔兽世界添加的反欺诈插件，防止交易诈骗和保护玩家财产安全。

提供 **3 个版本**，按需选择安装：

| 版本 | 目录 | 框架 | 特点 | 适合人群 |
|:---|:---|:---|:---|:---|
| **原版** | `uutools/` | 原生 Lua | 零依赖，静默运行 | 所有玩家 |
| **Ace3 版** | `uutools-Ace/` | Ace3 核心 | 框架化，命令行控制开关 | 熟悉命令的玩家 |
| **轻量库版** | `uutools-Lib/` | LibAddon + LibOptions + LibSlash | 图形设置界面 + 声明式命令 | 所有玩家 |

> 💡 **选哪个？** 不确定就选 **原版**（零依赖最稳定）或 **轻量库版**（有图形界面且体积小）。

## ✨ 功能特性

| 功能 | 说明 |
|:---|:---|
| 🛡️ 交易拦截 | 自动拦截1级陌生玩家的交易请求 |
| 🤖 防机器人 | 防止机器人自动发送的交易请求 |
| 💰 防诈骗 | 拦截脚本强制交易，防止金币诈骗 |
| 📬 邮箱保护 | 打开邮箱时自动阻止交易 |
| 🏦 银行保护 | 打开银行时自动阻止交易 |
| 🔒 静默运行 | 原版无需配置，安装即用 |
| 🔧 开关可控 | Ace3 版和轻量库版支持命令行随时开启/关闭各功能，设置自动保存 |
| 🖼️ 图形设置 | 轻量库版支持图形设置面板（ESC > 界面设置 > 插件） |
| 🛡️ 配置校验 | Ace3 版和轻量库版启动时自动检查配置合法性，异常时自动恢复默认设置 |
| 🌍 多语言 | Ace3 版和轻量库版支持简体中文、繁体中文、英文，自动适配游戏语言 |

## 📁 项目结构

```
wow-uutools/
├── uutools/                  # ① 原版（零依赖）
│   ├── uutools.lua
│   └── uutools.toc
├── uutools-Ace/              # ② Ace3 框架版
│   ├── Core.lua
│   ├── TradeGuard.lua
│   ├── Locale.lua
│   ├── Embeds.xml
│   ├── uutools-Ace.toc
│   └── libs/                 # Ace3 核心库
└── uutools-Lib/              # ③ 轻量库版
    ├── Core.lua
    ├── TradeGuard.lua
    ├── Locale.lua
    ├── Embeds.xml
    ├── uutools-Lib.toc
    └── libs/                 # LibAddon + LibOptions + LibSlash（仅5个文件）
```

## 📖 使用说明

原版为静默运行插件，安装后自动生效，无需额外配置。Ace3 版和轻量库版支持命令行控制。

### 命令列表（Ace3 版和轻量库版通用）

在聊天窗口中输入以下命令即可使用（按回车键执行）：

| 命令 | 说明 |
|:---|:---|
| `/uut` | 查看命令帮助 |
| `/uut help` | 查看命令帮助 |
| `/uut t on` / `/uut t off` | 开启/关闭交易拦截 |
| `/uut m on` / `/uut m off` | 开启/关闭邮箱保护 |
| `/uut b on` / `/uut b off` | 开启/关闭银行保护 |
| `/uut q` | 查询当前开关状态 |
| `/uut config` | 打开图形设置面板（仅轻量库版） |

### 图形设置界面（仅轻量库版）

1. 按 `ESC` → **「界面设置」** → **「插件」**
2. 找到 **「悠悠卫士 设置」**
3. 勾选/取消复选框即可开关功能
4. 点击 **「恢复默认设置」** 按钮可一键重置

### 功能说明

| 场景 | 保护措施 |
|:---|:---|
| 1级陌生玩家交易 | 自动拦截并关闭交易窗口 |
| 打开邮箱 | 自动阻止交易请求 |
| 打开银行 | 自动阻止交易请求 |
| 队友交易 | 放行，不拦截 |

### 工作机制

1. **交易拦截**：打开交易窗口时检查对方等级，1级非队友直接关闭交易
2. **邮箱/银行保护**：打开界面时启用 `blockTrades`，关闭时恢复

## 📋 版本历史

| 版本 | 更新内容 |
|:---|:---|
| v1.3.4 | 修复邮箱/银行保护开关关闭后blockTrades不恢复的Bug（Ace3版+轻量库版） |
| v1.3.3 | 轻量库版嵌入 LibSlash-1.0，命令注册改声明式，业务代码减少约23行 |
| v1.3.2 | 新增轻量库版（LibAddon-1.0 + LibOptions-1.0），图形设置界面，仅4个库文件 |
| v1.3.1 | 新增 Ace3 框架版，命令行控制开关、配置校验、多语言支持 |
| v1.3 | 原版当前版本 |
| v1.0.0 | 初始版本 |

## 🔗 相关链接

- [GitHub 源码](https://github.com/chenbool/uutools)

## 📞 联系方式

| 渠道 | 信息 |
|:---|:---|
| QQ群 | 484043598 |
| 作者 | chenbool |
| 邮箱 | 30024167@qq.com |

## 📄 许可证

MIT License - 免费开源，欢迎贡献代码