Files
pfExtend/README-zhCN.md
2026-09-20 21:04:34 +08:00

170 lines
7.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# pfExtend
[English](README.md) | 简体中文
pfExtend 是 [pfQuest](https://github.com/shagu/pfQuest) 的扩展插件,提供怪物掉落显示、任务链可视化、任务奖励查询等功能。兼容 **Turtle WoW**(1.12.0 客户端)。
## 功能特性
### ShowLoots - 怪物掉落显示
鼠标悬停在怪物身上时,自动在提示框中显示完整的掉落列表。
![ShowLoots 浏览器](img/Snipaste_2026-02-10_17-51-52.jpg)
**核心功能:**
- **实时掉落预览**:鼠标悬停即可在游戏提示框中查看完整掉落列表
- **掉率可视化**:显示精确掉落百分比,并用颜色标识(绿色=常见,红色=稀有)
- **智能过滤**:按物品品质过滤(粗糙、普通、优秀、精良、史诗、传说)
- **收藏系统**:标记物品为收藏,在掉落列表中高亮显示(收藏物品置顶)
- **详细浏览器**:悬停时按 `Alt+Ctrl` 打开完整掉落浏览器窗口,显示:
- 带品质颜色的物品链接
- 精确掉率及颜色标识
- 物品来源(NPC、物体)
- 各来源的区域位置
- 引用掉落表支持(间接掉落)
- 可点击的物品链接查看详情
**支持的掉落类型:**
- **单位(NPC)掉落**:直接击杀怪物掉落
- **物体掉落**:宝箱、容器、矿点、草药等
- **引用表**:复杂掉落表,链接多个来源(如"世界掉落"表)
**配置选项:**
- 启用/禁用功能
- 设置提示框中显示的最大物品数量
- 按最低物品品质过滤(隐藏垃圾物品)
- 在浏览器中显示物品 ID
---
### QuestHelper - 任务助手
集成在世界地图中的强大任务链可视化工具,并提供任务奖励查询与任务详情查看。
![QuestHelper 浏览器](img/Snipaste_2026-02-10_17-50-45.jpg)
**核心功能:**
- **交互式任务树**:以可展开的树形结构显示当前区域所有可用任务
- **任务链可视化**:自动构建并显示完整任务链(前置任务 → 后续任务)
- **智能任务过滤**:自动按以下条件过滤任务:
- 种族兼容性
- 职业要求
- 专业要求
- 等级要求
- 事件任务
- 前置任务完成状态
**任务状态标识:**
| 颜色 | 标签 | 含义 |
|------|------|------|
| <span style="color:#3eff2b">●</span> 绿色 | 进行中 | 当前在任务日志中 |
| <span style="color:#ffff2b">●</span> 黄色 | 可接取 | 现在可以接取 |
| <span style="color:#ff2b2b">●</span> 红色 | 前置 | 缺少前置任务 |
| <span style="color:#ff2b2b">●</span> 红色 | 高等级 | 未达到等级要求 |
| <span style="color:#5a5a5a">●</span> 灰色 | 已完成 | 已完成(如后续全部完成则变暗) |
| <span style="color:#5a5a5a">●</span> 灰色 | 种族/职业/专业 | 不满足要求 |
| <span style="color:#2b3eff">●</span> 蓝色 | 事件 | 节日或事件任务 |
| <span style="color:#ffff2b">●</span> 黄色 | 隐藏 | 从物品掉落开始 |
**地图交互集成:**
- **地图切换按钮**:世界地图上的快速访问按钮(`QH` 按钮)
- **任务标记**:点击任意任务可在世界地图上标记
- **自动地图标记**:显示任务给予者位置(NPC、物体、物品)
- **智能聚类**:将附近的任务标记分组以减少混乱
- **跨区域追踪**:
- 点击追踪其他区域的任务(自动切换地图)
- Ctrl+点击查找并追踪各自区域的前置任务
**任务链导航:**
- **可展开树**:点击 `+`/`-` 展开或折叠任务链
- **双击**:一次展开/折叠整个子树
- **自动展开**:打开列表时自动展开到当前正在进行中的任务
- **自动滚动**:切换区域时自动滚动到相关任务
- **持久标记**:任务标记保持显示直到手动移除
**任务日志任务链:**
- 任务日志中有后续任务的条目旁显示链条按钮,点击弹出该任务的后续环节查看窗口
- 任务链窗口中:单击跳转到世界地图定位,Shift+单击插入任务链接到聊天框
**任务奖励显示:**
- 任务提示框(tooltip)中自动追加奖励信息:
- 经验值
- 满级金钱(数据来源仅提供满级折算金钱)
- 固定奖励物品 / 自选奖励物品(带品质颜色与数量)
- 可在设置中开关(任务助手 → 任务提示中显示奖励)
- 奖励数据覆盖 6000+ 任务(含全部乌龟服自定义任务),数据来源 [OctoWow Database](https://octowow.st/db/)
**任务详情窗口:**
- 在任务链列表或任务链窗口中**右键点击任务名称**打开详情窗口,显示:
- 任务标题(含等级,按难度着色)
- 任务目标与当前进度(已在任务日志中的任务显示实时进度)
- 完整描述文本
- 奖励:经验、满级金钱、物品图标列表(图标悬停查看物品详情,Shift+点击插入物品链接)
- 窗口可随意拖动,Esc 关闭
**高级功能:**
- **前置查找器**:当前任务不可用时自动定位前置任务
- **多区域支持**:处理在多个区域或位置可用的任务
- **物品起始任务**:追踪从物品掉落开始的任务(显示掉落来源位置)
- **统一缓存**:优化的数据库,实现快速任务区域查找
---
## 依赖插件
- **[pfQuest](https://github.com/shagu/pfQuest)** - 必需的数据库提供插件
- **[pfQuest-turtle](https://github.com/shagu/pfQuest-turtle)** / **[pfQuest-octo](https://github.com/paokkerkir/pfQuest-octo)** - Turtle WoW 的额外数据库(仅 Turtle WoW 需要)
- **[pfUI](https://github.com/shagu/pfUI)** - 推荐的 UI 框架(可选)
## 安装方法
1. 下载最新版本 (`pfExtend_X.X.X.zip`)
2. 解压到你的 WoW 插件文件夹:`Interface\AddOns\`
3. 确保文件夹名为 `pfExtend`(不是 `pfExtend_X.X.X`)
4. 重启游戏或重载界面 (`/reload`)
## 命令
| 命令 | 说明 |
|------|------|
| `/pfex` | 打开 pfExtend 配置窗口 |
## 配置
可通过以下方式访问设置:
- 斜杠命令:`/pfex`
- 浏览器窗口的设置按钮(齿轮图标)
![配置面板](img/Snipaste_2026-02-10_17-52-11.jpg)
## 数据库更新
掉落显示与任务链功能需要一次性数据库初始化:
- 安装后首次登录时自动更新
- 可通过设置手动更新
- pfQuest 数据库变更时需要更新
任务奖励数据为插件内置文件(无需初始化),覆盖香草与乌龟服自定义任务。
## 开发者说明
`questGaindb/` 目录为任务奖励数据的抓取工作区(玩家无需使用):
- 内置 Python 抓取脚本,从 [OctoWow Database](https://octowow.st/db/) 批量获取任务奖励(物品/经验)
- 重新生成数据:进入该目录运行 `python scrape.py all`,生成的数据文件会自动同步到插件目录
- 详见 `questGaindb/README.md`
## 兼容性
- **客户端**:魔兽世界 1.12.0(经典版),兼容 **Turtle WoW**
- **依赖**:pfQuest(Turtle WoW 还需 pfQuest-turtle 或 pfQuest-octo)、pfUI(可选)
- **冲突**:无已知冲突
## 其它
- **作者**:Cliencer
- **基础框架**:pfQuest by Shagu
- **UI 框架**:pfUI by Shagu
- **其他贡献者**: roby-brok