Guild Raid Tracker 0.3.6
================================

PURPOSE
Records WoW Forever raid attendance, roster changes, boss attempts/kills,
loot drops, recipients, and officer loot classifications for later upload to
Guild Raid Tracker.

INSTALL
1. Close World of Warcraft.
2. Extract the GuildRaidTracker folder into the Forever AddOns directory:
   World of Warcraft\_forever_\Interface\AddOns\
   Some beta installations use _classic_beta_ instead of _forever_.
3. Confirm this file exists:
   Interface\AddOns\GuildRaidTracker\GuildRaidTracker.toc
4. Start WoW Forever and enable Guild Raid Tracker in the AddOns list.

QUICK START
/grt                     Open or close the tracker window
/grt show                Open or close the tracker window
/grt minimap hover       Show the banner icon while hovering the minimap or icon bar (default)
/grt minimap always      Keep the banner icon visible
/grt minimap hide        Hide the banner icon completely
/grt minimap             Toggle the icon off or restore its previous style
/grt start Molten Core   Start a raid record
/grt status              Show attendance, boss, and loot counts
/grt guild 50            Scan the guild roster and save level 50+ characters
/grt loot                List the ten newest loot records
/grt tag 3 sr            Mark loot record 3 as Soft Reserve
/grt tag 3 ms            Mark it Main Spec
/grt tag 3 os            Mark it Off Spec
/grt tag 3 bank          Mark it Guild Bank
/grt tag 3 de            Mark it Disenchanted
/grt stop                Close the raid record
/grt export              Show the upload-file location

DATA FILE
WoW writes the data after logout or /reload to:
WTF\Account\<account>\SavedVariables\GuildRaidTracker.lua

The addon does not connect to the internet. Upload the SavedVariables file through Addon import at https://guildraidtracker.com/dashboard. Upgrade from 0.3.1: close WoW, back up WTF\Account\<account>\SavedVariables\RosterForge.lua, then copy it to GuildRaidTracker.lua in the same SavedVariables directory before first launch. Keep the original backup. Replace the old Interface\AddOns\RosterForge folder with GuildRaidTracker. Do not enable both versions. Records already imported on the website are unaffected.

GUILD ROSTER
- Only the officer or raid leader running the addon needs it installed.
- The addon scans automatically after login, or use /grt guild 50 anytime.
- Characters missing from a later complete scan are marked inactive, never
  deleted, so their attendance, loot and point history remains available.
- Dungeon and raid outsiders are saved as Guests. Guild scans do not mark
  Guest records as guild leavers.

CURRENT LIMITATIONS
- Version 0.3.0 captures each boss item's in-game tooltip and icon for the
  website. Existing saved loot is enriched when the addon loads.
- Loot is automatically detected, but SR/MS/OS/bank/disenchant is confirmed
  by an officer using /grt tag.
- Boss loot is recorded from final receipt messages only. The default filter
  keeps rare-or-better items received within 180 seconds of a boss ending.
- Recipient parsing recognizes both party-member and self-loot messages.
  The raw localized loot message is preserved for the importer.
- WoW Forever can hide loot chat from addons while an encounter is active.
  Normal boss loot is generally recorded after ENCOUNTER_END.
- The addon has been statically validated but still needs an in-game raid test.

PRIVACY
The addon records guild character names, level, class, rank, online state and
roster timestamps plus raid encounters and loot messages. It does not record
whispers, guild chat, account credentials, or Battle.net information.

LICENSE
MIT License. Copyright (c) 2026 GenZC.

MINIMAP OPTIONS
The tracker window has a Minimap button that cycles Always visible, Show on hover, and Hidden. Hover mode checks the minimap, the icon, and its current icon-bar parent, then fades the icon after you move away. A faded icon does not intercept clicks. The icon is now a shield instead of a note with letters. The preference is saved between sessions. Other addons' icons are not modified. Custom icon-bar compatibility still needs an in-game check.

RECORDING POLICY
Default: raids only. /grt dungeons on enables manual personal dungeon testing.
/grt dungeons off returns to raids only. The tracker window also has a Recording button.
The addon cannot see website membership changes: switch test mode off when joining a registered guild.
The website separately enforces raid-only imports for registered guild use.
Old SavedVariables/history is retained. Leaving an allowed instance stops active recording.
