夜雨聆风团长的福音，让乱ROLL无所遁形
魔兽世界 3.3.5 团队拾取记录插件
血色曼陀罗 LootTracker 使用指南
LootTracker是一款专为魔兽世界 3.3.5版本（WLK）打造的团队拾取记录插件。自动记录团队/小队所有成员的拾取行为，支持按玩家、品质、物品名筛选，数据持久化保存，退出游戏不丢失。
一、功能介绍
1. 适用版本
·魔兽世界 3.3.5a（WLK 巫妖王之怒），Interface 版本号 30300
·兼容所有 3.3.5 客户端（国服、台服、欧服等中文/英文客户端均可用）
·纯原生 API 开发，零依赖，不需额外安装 Ace3 等插件库
2. 核心功能
全团拾取监听 监听 CHAT_MSG_LOOT 事件，实时解析所有团队/小队成员的拾取消息，仅记录本团本队成员，过滤无关的世界频道消息 | 智能物品识别 自动提取物品链接、名称、品质（灰/白/绿/蓝/紫/橙）、数量，即使 GetItemInfo 缓存未就绪也能从颜色码反推品质 |
职业染色 玩家名按职业自动着色（战士棕、圣骑粉、猎人绿、法师蓝……），一眼分辨拾取者 | 多维筛选 按玩家名筛选、按品质等级筛选（紫色及以上/蓝色及以上等）、按物品名实时搜索，三类筛选可叠加使用 |
物品 Tooltip 鼠标悬停列表中的物品行，直接弹出游戏原生物品提示框，查看属性详情 | 数据持久化 记录存入 SavedVariables，退出游戏、换号登录均不丢失，关闭电脑重启照样保留 |
导出功能 一键导出全部记录到可复制文本框（Ctrl+C），含时间、玩家、物品、品质、数量、区域，方便整理战报 | 拾取统计 /lt stats 命令即时输出每个玩家的拾取件数、紫色/橙色装备数量统计 |
灵活设置 可配置最低记录品质（只记蓝装以上）、最大保留条数、新团本自动清空、紫装提示音等 | 小地图按钮 方便快捷的 Minimap 入口按钮，支持拖动旋转到任意角度，左键开窗右键设置，悬停显示记录总数 |
3. 界面风格
·深蓝底色 + 金色边框主题，与血色曼陀罗公会 VI 统一
·主窗口可拖动、自适应屏幕边界（ClampedToScreen）
·行背景交替色，悬停高亮，选中行青色标识
二、使用说明
1. 安装方法
1.下载 LootTracker 插件压缩包，解压得到 LootTracker 文件夹
2.将 LootTracker 文件夹复制到魔兽世界安装目录下的插件路径：World of Warcraft\Interface\AddOns\
3.确保目录结构为：Interface\AddOns\LootTracker\LootTracker.toc
4.进入游戏，在角色选择界面左下角点击「插件」按钮
5.勾选血色曼陀罗拾取记录（如提示版本过旧请勾选「加载过期插件」）
6.进入游戏后，聊天框会显示 [LootTracker] v1.0.0 已加载
提示：首次加载若提示"版本不匹配"属于正常现象（Interface 版本号差异），勾选"加载过期插件"即可正常使用。
2. 命令大全
以下命令在游戏聊天框中输入（/ 开头），大小写不敏感：
命令 | 功能说明 |
/lt 或 /loottracker 或 /拾取 | 打开/关闭主窗口。默认打开记录查看界面 |
/lt help | 显示命令帮助列表 |
/lt clear | 清空所有拾取记录（操作不可撤销，执行前会弹出确认窗口） |
/lt export | 导出全部记录到文本框（制表符分隔，可全选 Ctrl+C 复制到 Excel/记事本） |
/lt exportlinks | 导出含物品链接的记录（适合粘贴回游戏聊天频道分享） |
/lt stats | 聊天框输出拾取统计：每个玩家的总件数、紫色数量、橙色数量 |
/lt config | 打开设置面板（详见下方设置项说明） |
/lt quality 0~6 | 设置最低记录品质。0=灰色 1=白色 2=绿色 3=蓝色 4=紫色 5=橙色 6=神器示例：/lt quality 4 表示仅记录紫色及以上 |
/lt minimap | 切换小地图按钮的显示/隐藏 |
3. 设置面板详解
输入 /lt config 打开的设置窗口中可调整以下参数：
设置项 | 说明 |
记录小队拾取 | 开：在小队（5人本）中也记录拾取关：仅在团队中记录 |
记录团队拾取 | 开：在团队中记录拾取关：不记录团队拾取 |
单人时也记录 | 开：不在队伍中时也记录自己的拾取关：仅队伍/团队中记录（默认） |
史诗及以上播放提示音 | 开：紫色/橙色装备被拾取时播放游戏音效提醒关：静默记录（默认开） |
进入新团本自动清空 | 开：每次进入新副本自动清空上一次副本的所有记录关：记录累积保留（默认关） |
显示小地图按钮 | 开：Minimap 上显示插件快捷按钮关：隐藏按钮（等同于 /lt minimap） |
最低记录品质 | 滑块 0~6，低于此品质的拾取不记录。默认 2（绿色及以上） |
最大保留记录数 | 滑块 500~10000，超出后从最早的记录开始删除。默认 5000 条 |
4. 窗口操作指南
操作 | 效果 |
拖动标题栏 | 移动主窗口到任意位置 |
列表行左键点击 | 将物品链接插入聊天输入框（方便发到团队频道）若聊天框未打开则按该玩家筛选 |
列表行右键点击 | 切换按该玩家筛选（再点一次取消筛选） |
鼠标悬停物品行 | 自动弹出物品 Tooltip 详情 |
拖动小地图按钮 | 旋转按钮到 Minimap 任意角度 |
小地图按钮左键 | 打开/关闭主窗口 |
小地图按钮右键 | 打开设置面板 |
小地图按钮悬停 | 显示当前记录总数与副本信息 |
5. 筛选使用示例
·只看某人的拾取：在列表中右键该玩家的任意一行，或使用玩家下拉菜单选择
·只看紫装：品质下拉选择「紫色及以上」，或 /lt quality 4
·搜索特定物品：在搜索框输入物品名（如"龙鳞"），实时过滤
·三种筛选可叠加：同时按玩家 + 品质 + 物品名筛选，精确定位
·清空筛选：点击工具栏「清空筛选」按钮即可恢复显示全部
6. 常见问题
问题 | 解答 |
进游戏后没有显示加载信息？ | 检查角色选择界面「插件」中是否勾选了 LootTracker，确保文件夹路径正确 |
团本中有些拾取没被记录？ | 检查品质设置（/lt quality），低于最低品质的不记录；确认该玩家在团内 |
记录太多了想清理？ | 使用 /lt clear 或在设置面板开启「进入新团本自动清空」 |
小地图按钮不见了？ | 使用 /lt minimap 重新显示，或在设置面板勾选「显示小地图按钮」 |
打开设置面板修改后没生效？ | 设置即时生效，直接关闭面板即可。如需持久保留勾选状态，正常退出游戏即可写入 SavedVariables |
数据安全提示：所有拾取记录保存在游戏的 SavedVariables 文件中（WTF 目录下），换号/重装插件不会影响已保存的数据；如需备份可复制 WTF\Account\账号名\SavedVariables\LootTracker.lua。
血色曼陀罗· LootTracker v1.0.0适配魔兽世界 3.3.5（WLK 巫妖王之怒）· Interface 30300纯原生 API · 零依赖 · 开箱即用
