# ndui-extend

**Repository Path**: chenbool/wow

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-07-15
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NDui 扩展

## 插件简介

| 项目 | 内容 |
|------|------|
| 插件名称 | NDui 扩展 |
| 作者 | Sloan |
| 版本 | 1.0 |
| 框架 | Ace3 |
| 游戏版本 | 11.3.0 (Interface: 11304) |

## 功能概览

| 模块 | 文件 | 功能描述 | 开关状态 |
|------|------|----------|----------|
| 头像增强 | oUF/init.lua | 控制玩家头像显示/隐藏 | 默认开启 |
| 战斗提示 | ccy/Combat.lua | 进入/离开战斗时显示提示 | 默认开启 |
| 属性换算 | FuEqStats/init.lua | 鼠标悬停装备显示属性换算 | 默认开启 |
| 位面显示 | layer/init.lua | 小地图显示所在大陆 | 默认开启 |
| 交易保护 | trade/init.lua | 防诈骗+邮箱/银行交易阻止 | 默认开启 |

---

## 功能详细说明

### 1. 头像增强

| 配置项 | 类型 | 说明 |
|--------|------|------|
| 头像增强 | 下拉选择 | 默认隐藏 / 禁止隐藏 / 完全隐藏 |

| 显示模式 | 说明 |
|----------|------|
| 默认隐藏 | 根据战斗状态自动显示/隐藏 |
| 禁止隐藏 | 始终显示头像 |
| 完全隐藏 | 始终隐藏头像 |

**触发条件**：
- 玩家进入战斗时显示
- 切换目标时显示
- 血量/能量变化时检测

---

### 2. 战斗提示

| 配置项 | 类型 | 默认值 |
|--------|------|--------|
| 战斗增强 | 开关 | 开启 |
| Y坐标 | 输入框 | -160 |

**显示效果**：
- 进入战斗：显示"进入战斗"提示 + 淡入动画
- 离开战斗：显示"离开战斗"提示 + 淡出动画

---

### 3. 装备属性换算

| 配置项 | 类型 | 默认值 |
|--------|------|--------|
| 属性换算 | 开关 | 开启 |

**支持的属性换算**：

| 主属性 | 战士 | 圣骑士 | 猎人 | 盗贼 | 牧师 | 萨满 | 法师 | 术士 | 德鲁伊 |
|--------|------|--------|------|------|------|------|------|------|--------|
| 力量→攻强 | 2 | 2 | 1 | 1 | 1 | 2 | 1 | 1 | 2.4 |
| 力量→格挡 | 0.05 | 0.05 | - | - | - | 0.05 | - | - | - |
| 敏捷→近战攻强 | - | - | 1 | 1 | - | - | - | - | 1 |
| 敏捷→远程攻强 | 1 | - | 2 | 1 | - | - | - | - | - |
| 敏捷→暴击 | 0.05 | 0.05 | 0.019 | 0.034 | 0.05 | 0.05 | - | - | 0.05 |
| 敏捷→闪避 | 0.05 | 0.05 | 0.038 | 0.07 | 0.05 | 0.05 | - | - | 0.05 |
| 敏捷→护甲 | 2 | 2 | 2 | 2 | 2 | 2 | - | - | 2 |
| 智力→暴击 | - | 0.017 | - | - | 0.017 | 0.017 | 0.017 | 0.017 | 0.017 |

| 副属性 | 换算公式 |
|--------|----------|
| 耐力→生命 | 耐力 × 10 (普通种族) |
| 耐力→生命 | 耐力 × 10.5 (牛头人) |
| 智力→法力 | 智力 × 15 |

---

### 4. 位面显示

| 显示内容 | 说明 |
|----------|------|
| 显示位置 | 小地图右上角 |
| 显示格式 | "玩家名位于大陆名" |
| 触发条件 | 进入世界 / 区域变化 |

---

### 5. 交易保护

| 保护类型 | 触发事件 | 保护行为 |
|----------|----------|----------|
| 防诈骗 | TRADE_SHOW | 1级角色自动关闭交易 |
| 邮箱保护 | MAIL_SHOW / MAIL_CLOSED | 打开邮箱时阻止交易 |
| 银行保护 | BANKFRAME_OPENED / BANKFRAME_CLOSED | 打开银行时阻止交易 |

---

## 安装教程

1. 下载插件压缩包
2. 解压到 `World of Warcraft\_retail_\Interface\AddOns\` 目录
3. 目录结构：
   ```
   AddOns/
   └── NDui_Extend/
       ├── NDui_Extend.toc
       ├── ui.lua
       ├── init.xml
       ├── embeds.xml
       ├── ccy/
       │   └── Combat.lua
       ├── FuEqStats/
       │   └── init.lua
       ├── layer/
       │   └── init.lua
       ├── trade/
       │   └── init.lua
       ├── oUF/
       │   └── init.lua
       └── Libs/
           └── (Ace3库文件)
   ```
4. 重启游戏
5. 在插件列表中勾选启用

---

## 使用说明

| 命令 | 说明 |
|------|------|
| `/nde` | 打开插件设置界面 |

---

## 配置选项总览

| 功能 | 配置项 | 类型 | 默认值 | 取值范围 |
|------|--------|------|--------|----------|
| 头像 | 头像增强 | 下拉 | 禁止隐藏 | 1/2/3 |
| 战斗 | 战斗增强 | 开关 | 开启 | true/false |
| 战斗 | Y坐标 | 输入 | -160 | 数值 |
| 属性 | 属性换算 | 开关 | 开启 | true/false |

---

## 文件结构

```
NDui_Extend/
├── NDui_Extend.toc      # 插件入口文件
├── ui.lua               # 主配置与初始化
├── init.xml             # 初始化文件
├── embeds.xml           # 嵌入库声明
├── ccy/
│   └── Combat.lua       # 战斗提示模块
├── FuEqStats/
│   └── init.lua         # 装备属性换算模块
├── layer/
│   └── init.lua         # 位面显示模块
├── trade/
│   └── init.lua         # 交易保护模块
├── oUF/
│   └── init.lua         # 头像控制模块
└── Libs/
    └── Ace3/            # Ace3库
```

---

## 更新日志

| 版本 | 日期 | 更新内容 |
|------|------|----------|
| 1.0 | - | 初始版本发布 |

---

## 参与贡献

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

---

## 许可证

MIT License