GuildHelperV3 (GH3)

# GuildHelper v3 Changelog

## v3.3.15

### BIS

- Loot Helper now filters non-gear items more aggressively by requiring real weapon or armor item classes before self-loot, GH3 peer offers, or manual group offers can enter the BIS Drops review queue.

- Tooltip and gear validation were tightened for `All Tradeable Loot`, which reduces false-positive rows from trade goods, reagents, mailbox retrievals, and other non-equippable loot.

- GH3 whisper and group-chat messages now sanitize unsupported inline atlas or texture tags from item text before calling Blizzard chat APIs, which fixes `SendChatMessage(): Invalid escape code in chat message` errors.

- Stored drop-review rows and loot-history entries now normalize item text at queue time so popup rows, history, and follow-up actions reuse the same cleaned item text.

- Compact and full BIS Drops popup layouts now remember separate saved locations, so each mode can reopen where it was last placed instead of sharing one position.

### UI

- Fixed BIS Drops row layout so wrapped claimant and roll summaries grow row height dynamically instead of overlapping the next line or the next row.

- Updated the BIS Drops title-bar compact toggle to use arrow-style GH3 buttons beside the close button instead of the older `+` and `-` labels.

- BIS Drops popup position saving now persists the current popup location immediately when it is moved, and restore logic now reopens compact and full layouts from their own saved anchors.

## v3.3.12

### BIS

- Added a grouped BIS drop-review popup that batches burst loot events for a short delay so multiple tradable matches can land in the same GH3 review table instead of opening one popup per drop.

- Added a `Loot` button beside the BIS export controls that opens a dedicated Loot Helper configuration window for queue mode, popup behavior, sound, and trade-complete whisper settings.

- BIS Loot Helper can now run in `BIS Only` mode or a best-effort `All Tradeable Loot` mode that queues self-looted equippable gear for quick group-offer follow-up when Blizzard does not expose a perfect tradable-only signal.

- `All Tradeable Loot` now also surfaces GH3 peer offers from the current party or raid, so addon users can coordinate more than just their own self-looted rows.

- BIS drop review rows now support direct `W`, `O`, `T`, and `D` actions for whispering the holder, offering the item to the current party or raid, attempting a trade, or dismissing the row without action.

- Manual `O` offers now also broadcast to other GH3 users in the current group so their addon can open a matching review row instead of relying only on party-chat text.

- BIS drop review rows now support direct `C` and `R` actions for structured GH3 claims and synced 1-100 loot rolls, with roll results appearing in popup rows for GH3 users while still posting to group chat.

- BIS drop-review messages were polished so GH3 sends clearer whisper and group-chat text when requesting tradable loot or announcing that a tradable item is available.

- GH3 now tracks trade-window completion and can whisper the other player with a success summary after a completed trade closes.

- Self-offer rows now use the `T` action as a trade-target dropdown so you can choose an active group member without dedicating row space to a separate picker control.

- Loot Helper now keeps a bounded recent history log instead of an unbounded audit trail, which limits stored entries by both age and count to keep the saved data small.

- Loot Helper now lets you choose between strict tooltip-based tradable detection and a broader best-effort party-loot review mode when using `All Tradeable Loot`.

- Loot Helper can now pin the BIS Drops popup to a remembered position and optionally keep active rows until you dismiss them, which makes end-of-run trading cleanup easier.

- Active drop-review rows now keep full names and stay visible when the related player leaves group, so GH3 can still help you whisper them later if you want to re-form the party and trade.

- BIS self-alert suppression now ignores item-upgrade-vendor interactions so upgrading an already-owned BIS item does not fire a fake self-drop whisper.

### UI

- Added a GH3-styled BIS Drops popup with grouped review rows, row badges, left-group and roll-status badges, filter and sort controls, action tooltips, hyperlink item hover tooltips, a draggable minimized top-two preview mode that strips row action chrome while keeping a restore control, pin-to-position support, claimant and roll summaries with winner emphasis, hover details, a dismiss action, and an open sound cue so tradable drop follow-up is easier to manage during active runs.

- Added local preview slash commands so the Loot Helper UI can be opened and populated with representative test rows without joining a party or running dungeon or raid content.

## v3.3.11

### Maintenance

- Maintenance now paginates the action queue at 50 rows per page instead of building the full stale-member list at once, which prevents the pane from locking up when large cleanup queues are present.

- Fixed Maintenance queue rules so `Missing From Roster` entries do not appear before the configured stale threshold. Recent misses from incomplete or transient roster captures are no longer treated as immediate cleanup candidates.

- Guild roster capture now requires two consecutive missed home-guild roster passes before a stored member is marked as having left the guild, which reduces false `Missing From Roster` waves caused by partial Blizzard roster updates.

### BIS

- BIS Gear Select now uses the selected toon and selected Loot Spec more consistently when opening journal-backed item pickers and previewing item metadata.

- Journal loot filtering was hardened so GH3 reapplies the requested class and spec filter while walking Encounter Journal tiers, difficulties, instances, and encounters instead of falling back to stale journal state.

### UI

- The My Toons `Export All` button was moved to the top-right of the Member Pane header while still exporting the full My Toons CSV instead of the currently selected toon.

## v3.3.10

### BIS

- BIS Gear Select is now the primary in-game editing workflow, with journal-backed item picking, button-style Spec and Loot Spec selectors, and cleaner per-row source selection instead of the older dropdown-heavy form.

- Added explicit `Tier` and `PvP` BIS source support. Tier rows now pull from Blizzard journal and loot-set data more reliably, while PvP rows can be tracked directly by Blizzard item ID or Wowhead URL when the Encounter Journal does not expose the vendor stock.

- BIS help copy and Stat Goals guidance were rewritten to match the current Gear Select workflow, including raw stat-goal entry and clearer Tier and PvP instructions.

- The BIS Gear Table now shows Instance and Boss columns, renames State to Status, and uses row hover text for notes instead of the older lookup-confidence badge messaging.

- Fixed a BIS editor regression where saving or previewing rows could wipe existing targets when blank preview values were returned.

### UI And Accessibility

- Converted the BIS Gear Table filters, Roster column picker, Groups add-member controls, My Toons editor selectors, Mythic+ selectors, and Settings font pickers to the shared GH3 menu-button style so the major panes use a more consistent control pattern.

## v3.3.9

### BIS

- Added per-spec BIS stat goals with raw-value tracking so Crit, Haste, Mastery, Versatility, Avoidance, Speed, Dodge, and Leech can be compared against saved targets instead of percentage-only displays.

- BIS stat cards now show cleaner current, goal, and delta values in a compact layout, and the main BIS action buttons were moved into the open header space above the summary frame.

- Stat Goals now opens a direct entry popup with one field per tracked stat so Murlok or guide values can be typed in directly instead of pasted through the text-import workflow.

- Live current-toon stat snapshots are now saved locally per toon and spec and reused later for offline review in My Toons views.

- Fixed a BIS service load failure caused by the raw stat-helper conversion so the addon no longer errors during startup with `BISService` missing.

### UI And Stability

- Shared BIS export and import popups now anchor their text areas below the wrapped help copy instead of using a fixed offset, which fixes the overlapping text and textbox layout in the Simple, Template, and Import dialogs.

- The BIS Stat Goals popup now reopens cleanly without anchor-family errors and uses the shared GH3 input helpers correctly.

## v3.3.8

### BIS

- BIS loot alerts now suppress duplicate whispers for the same item within the alert window, which avoids separate self-loot and party-loot lines both whispering about the same drop.

- BIS upgrade-track detection now reads the actual upgrade tooltip line more strictly so Champion items no longer get misclassified as Mythic or Heroic just because those words appear elsewhere in the tooltip.

- BIS loot chat processing now runs through a small queued worker instead of doing the full match pass directly on each loot event, which reduces frame hitches during boss and trash loot bursts.

- Group loot recipient matching is now cached briefly between loot lines so repeated BIS checks do less repeated party-name parsing during active dungeon pulls.

- Added the Profession Skinning to the dropdown.  Was an oversight.

### Stability

- My Toons and roster ownership checks now use a cached main-character lookup instead of repeatedly bouncing through full player-record refresh work, which fixes the `script ran too long` error seen during combat-resume and login flows.

## v3.3.7

### Mythic+

- Party Planning now supports carry-target analysis in Member Breakdown so you can click a party member, then switch between Party Gains, Score Goal, and Key Goal views without leaving the planner.

- Score Goal mode now recommends the lowest helpful key for each dungeon toward carry milestones such as 2000, 2500, and 3000, while Key Goal mode highlights each player's current best until they meet shared goals like +10, +12, or +15.

- Party keystone rows are now one-click planner shortcuts that load the selected member's current dungeon and key level directly into the target controls.

### BIS

- BIS imports now accept stronger itemId-backed workflows, including full Template itemId columns, raw Blizzard item IDs, Wowhead item URLs, and WoW item links pasted into the itemId field.

- BIS import parsing was hardened for spreadsheet pastes so flattened `slot / itemName / itemId` rows, preserved row numbers, and collapsed-column recovery behave more consistently during review.

- BIS imports now always show an import review report that separates supplied-ID, journal-resolved, client-cache, name-only, duplicate, and unresolved rows so players can verify lookup confidence before trusting alerts.

- BIS debug output now includes alert lookup mode, extracted itemId details, client-cache name resolution, and journal match metadata so unresolved imports are easier to diagnose.

- BIS gear-table and tracked-target rows now show hover lookup confidence labels such as `ID+Src`, `ID`, `Name`, and `Review`, and the shared table tooltip path was fixed so those hover details do not error.

### Sync And Stability

- Whisper transport now rejects invalid whisper peers before attempting addon sends, which prevents malformed target names from reaching the sync layer.

## v3.3.6

### Activity Planner

- Activity Planner schedules now store creator timezone metadata alongside the absolute event timestamp so each viewer sees the event in their own local time while still preserving the creator's intended wall-clock schedule.

- Recurring activities now generate future occurrences from the creator's saved schedule hour, minute, weekdays, and timezone offset instead of relying only on the original raw timestamp.

- Activity details now show local time, creator time, and creator timezone context, and the editor explains that schedule fields are entered in the current user's local timezone.

### Mythic+

- Party Planning now keeps the portal rail visible while moving planning controls into the upper-right header area so key, score-goal, and key-goal workflows stay available without replacing the seasonal portal view.

- Member Breakdown was rebuilt into a dungeon matrix with party members on rows and abbreviated current-season dungeons on columns.

- The Member Breakdown matrix now changes by mode: Party Gains shows estimated on-time score gain, Score Goal shows the lowest helpful key toward the selected milestone, and Key Goal shows each player's current best until the selected threshold is met.

### BIS

- Gear Table and slot Details now include direct `?` help buttons that jump to the BIS Help Center article.

- BIS help copy was shortened to match the actual spreadsheet import workflow and reduce clutter in the pane.

- Tracked Targets now uses a wider item column and compact priority labels so item names clip less aggressively and the priority column stays readable.

- BIS source fallback now recognizes tier-family items that share a possessive name prefix, which fixes raid-tier pieces such as `Devouring Reaver's ...` being left as `Other` after import.

### UI And Accessibility

- Settings now includes `Skurri` as an additional pane font option for both pane titles and pane text.

### Performance And Stability

- Opening the BIS pane no longer forces a fresh Encounter Journal build during normal view rendering, which reduces hitching when switching into the BIS view.

- BIS loot matching now uses a cached lookup index instead of walking the full tracked list on every loot message.

- BIS bag and equipment refreshes now avoid immediate inventory rescans during combat and defer that work until normal updates resume.

## v3.3.3

### Mythic+

- Party Planning now shows party keystones as selectable rows so the target dungeon and level can be loaded directly from the group's tracked keys.

- Mythic+ score gain estimates were updated to use a more realistic current-season score model instead of a flat per-level gain guess.

- The old placeholder Mythic+ Info tab was replaced with a current-season leaderboard view, and the Season tab was simplified so it focuses on season coverage instead of repeating the My Toons layout.

### BIS

- BIS drop notices now use whisper-style alerts for the important tracked loot and tradable-share cases so they are easier to notice than general chat messages.

- Incoming tradable BIS claims now whisper the looter directly, and outgoing share requests still whisper the player who picked up the item.

- BIS Help and import guidance were simplified around the actual Template workflow: click Template, paste into a spreadsheet, replace the sample rows, then import the finished list.

- BIS import guidance now mentions the Excel Text to Columns comma-delimited step for cases where pasted template rows land in a single column.

- BIS Simple and Template popups now show real example item rows in the copy area, and the popup text area was fixed so the sample rows stay visible above the dark background.

- BIS slot and target rows now use track-band colors so below-Champion, Champion, Heroic, Mythic, optional, and missing states are easier to read at a glance.

- BIS journal autofill now uses broader imported-name matching so externally sourced item names have a better chance of resolving to Blizzard item IDs and source metadata.

### UI And Accessibility

- Settings now includes pane-only font style selectors for pane titles and pane text so players can switch to a more readable font family without changing layout-sensitive font sizes.

- The pane font setting applies to content-page text styling only and does not change the sidebar menu, menu buttons, or the main GH3 frame title.

- Help was rebuilt into a KB-style Help Center with left-side topic navigation and process-focused articles for setup, BIS, Mythic+, sync, linked guilds, and admin workflows.

## v3.3.1

### Mythic+

- Added a dedicated Mythic+ view with My Toons, Party Planning, Season, and Info tabs.

- Current-character Mythic+ capture now tracks live rating, current keystone, season dungeon progress, and portal unlock visibility when Blizzard data is available.

- Party Planning now summarizes synced group Mythic+ records, highlights missing dungeon coverage, and gives a faster planning view for building runs.

- Season and portal views now keep no-data rows visible so launch-week and low-data characters are still readable instead of appearing empty.

### BIS

- Added a full BIS tracker with per-toon, per-spec slot lists and support for multiple targets per slot.

- BIS imports now accept CSV, tab-separated Excel paste, and simplified slot-plus-item templates, with duplicate skipping and broad slot/header aliases.

- Owned and equipped BIS states are now detected automatically for the current character, including upgrade-track awareness and live refresh on bag or equipment changes.

- BIS source autofill now does best-effort raid and dungeon matching from Blizzard's Encounter Journal, with fallback handling for tier-set style item families.

- Added BIS loot opportunity alerts, group-share addon messages for tradable drops, and best-effort Great Vault BIS offer detection.

- The BIS gear table now highlights slot rows by status: green for primary BIS equipped, blue for an equipped alternative target, and yellow when no tracked BIS target is equipped.

### UI And Stability

- Added BIS import, export, template, confirm, and debug flows to the shared popup styling path so they render consistently with the rest of GH3.

- Shared table rendering now supports row-level color overrides, which is used by BIS status rows and keeps selection styling readable.

- Added a Settings menu with feature toggles for Mythic+, BIS, Raid Bingo, and Groups so menu items and their related background processing can be disabled for troubleshooting or personal preference.

- DataSync now warns when feature toggles have disabled automatic Mythic+ or Groups activity so reduced background traffic is visible instead of looking broken.

## v3.2.7

### Sync

- Roster sync now uses table status checks plus manifest-first delta exchange, which cuts unnecessary sync size and avoids falling back to full snapshot sync during normal updates.

- Large changed-record requests are now chunked as record requests instead of downgrading to full snapshot transfer.

- Roster sync diagnostics now capture chunk counts, byte totals, and requested-record counts so late-night sync tests are easier to verify.

- Sync Diagnostics now includes a copyable Last Roster Sync report popup for manifest, record-request, record-response, and snapshot totals.

- Roster sync sessions now wait longer before timing out, which helps slow cross-guild roster syncs finish cleanly.

- Incoming sync sessions now appear in the active session list on the receiving client, so both peers can see when a sync is in progress.

- Peers that answer real sync traffic now clear stale probe-timeout state correctly, and timed-out peers can be removed from the sync list with a Remove Peer action.

### Roster And Profiles

- Officer Notes were removed from roster and My Toons storage, UI, and sync payloads, and existing saved data is scrubbed during normal refresh paths.

- My Toons now supports delete-with-sync tombstones, automatic undelete on relog, and 90-day tombstone cleanup for retired characters.

- The My Toons Save button was moved to the member-pane header for faster profile editing.

### Exports

- Added Guild Roster Export All for officers and guild masters, with CSV-friendly output that includes offline review data and human-readable timestamps.

- Added My Toons Export All for every player, with CSV-friendly output for offline profile review.

- Added Groups Export Party/Raid for officers and guild masters to export the live members currently in the player's party or raid for attendance and promotion tracking.

- Added Groups Export Events for officers and guild masters to export GH3 event records separately from live party or raid attendance.

### UI And Stability

- Export and diagnostics popup windows now open in front of the main addon window instead of behind it.

- Popup close buttons and actions now use the shared GH3 button styling path so labels render correctly.

## v3.2.6

### Sync

- Manual sync now performs a true two-way exchange so pushed data reaches the other player without requiring them to sync back first.

- Probe Peer now includes discovered online home-guild addon users, so home-guild syncing no longer depends on being grouped.

- Sync All now prioritizes smaller shared tables before roster data and skips federation sync when no approved linked guild is present.

- Conflict handling now prefers the newest real data for My Toons, Board, Groups, and cross-guild roster records instead of creating avoidable manual conflicts.

- Roster conflict detection now ignores volatile fields such as online status and last-seen timing, reducing false conflicts.

- Conflict rows now include a Compare button so local and remote values can be inspected and copied for troubleshooting.

### Raid Bingo

- Prize pool is now locked to the active Raid Bingo session so players cannot locally change payouts during a live game.

- Raid Bingo state sync now carries the locked prize pool through start, reset, state updates, and end-of-game results.

- Only the leader can post Raid Bingo winners and payout messages.

- Help text was rewritten with simpler leader and player steps and now points users to the disclaimer section.

### Roster And Profiles

- Birthday changes now apply across all of your saved My Toon entries instead of needing to be entered per toon.

- BattleTag changes now apply across all of your saved My Toon entries as well.

- My Toons class-based dropdowns now reflect Midnight combat profile changes for classes such as Demon Hunter and Hunter, including hybrid profile support where applicable.

- Roster sync metadata no longer bumps on online-only refresh changes, which reduces unnecessary sync churn.

### UI And Stability

- Fixed the member and groups calendar year-jump behavior.

- Added clearer conflict detail capture for new sync conflicts to make remaining edge cases easier to diagnose.