RCHistoryLookup

Overview

RCHistoryLookup is a lightweight companion addon for RCLootCouncil. It introduces a "History" column to the voting frame, displaying the number of times each candidate has received loot for the same reason within recent lockout periods (CDs). This provides immediate, data-driven context to assist loot councils in making objective distribution decisions.

Core Features

• Voting Frame Integration: Seamlessly adds a "History" column displaying real-time loot acquisition counts for the current responseID.
• Intelligent Highlighting: Candidates with the lowest loot count within the same responseID group (can be tied) are highlighted using the response's designated color (e.g., Green for Main Spec, Orange for Off Spec). Other candidates are displayed in white.
• Decoupled Architecture: Operates completely independently of the core RCLootCouncil addon. Updating the main RCLootCouncil folder requires zero modifications to this plugin.

Tracking Rules

• Dynamic Lockout Period (CD): 1 CD equals 1 week. The reset time is calculated dynamically using official WoW APIs based on the actual server reset time, ensuring perfect compatibility across all regions (NA/EU/Asia).
• Default Span: Evaluates the most recent 3 CDs (the current week plus the previous two weeks).
• Customizable: The tracking duration can be modified in the settings.

Configuration

To adjust the number of tracked weeks:

1. Open settings via /rc config.
2. Navigate to General -> Loot History.
3. Locate the Quick View Period input box next to "Record Personal Loot".
4. Enter a positive integer to set your desired CD tracking span.

Important Notes

• Data Dependency: Historical data is strictly sourced from the local RCLootCouncilLootDB.
• Master Looter Requirement: The Master Looter (ML) must have Send History enabled for raid members to receive and record loot data. If disabled by the ML, all history counts will display as 0.

插件简介

RCHistoryLookup 是 RCLootCouncil 的轻量级辅助插件。它在投票界面为每位候选人新增一列「历史」，显示其在近期若干个 CD 内以相同理由获得装备的次数，辅助团队进行客观、数据驱动的分配决策。

核心功能

• 投票框扩展： 在投票框新增「历史」列，实时显示每位候选人在当前 responseID 下的近期获装次数。
• 智能高亮提示： 同一 responseID 分组内，历史次数最少的候选人（可并列）的文字颜色将高亮为该理由对应的颜色（与「回应」列一致，如主规绿色、副规橙色）。其余候选人显示白色。
• 完全解耦： 与 RCLootCouncil 核心架构完全解耦。RC 插件更新后只需正常替换 RC 文件夹，本插件无需任何改动即可持续运行。

统计规则

• 动态 CD 计算： 1 CD = 1 周。摒弃了硬编码时间，采用魔兽世界官方 API 动态获取服务器真实重置时间，完美兼容国服/亚服/美服/欧服的重置差异及夏令时变化。
• 默认周期： 默认统计最近 3 个 CD（本周 + 前两周）。
• 自定义周期： 可在设置中自由调整统计的 CD 数量。

设置指南

修改统计周期的方法：

1. 聊天框输入 /rc config 打开设置。
2. 导航至 General (常规) -> Loot History (拾取历史)。
3. 在「Record Personal Loot」右侧找到新增的 快速浏览周期 输入框。
4. 填入正整数即可修改统计周期。

注意事项

• 数据来源： 历史数据来源于本地 RCLootCouncilLootDB。
• 团长设置依赖： 强依赖于物品分配者（ML）开启 Send History (发送历史) 选项，团员才会收到记录。若 ML 未开启该功能，所有人的历史次数均会显示为 0。