GuildPrizeTracker v0.5.3

A guild participation, raffle, and reward tracking addon for World of Warcraft.

FEATURES
- Guild roster scanning
- Raid attendance points
- Boss kill point tracking
- Mythic+ group point tracking
- Guild sync for members running the addon
- Random and weighted raffles
- Alt/main linking to prevent duplicate raffle entries
- Manual bonus points with reason text
- Recent event history
- Sync status/version check table
- Minimap button to open the addon
- CSV export for spreadsheets

COMMANDS
/gpt open - Open or close the addon window
/gpt roster - Scan guild roster
/gpt raffle - Pick a random eligible winner
/gpt wraffle - Pick a weighted winner based on points
/gpt raidstart - Award raid attendance to current raid/group
/gpt boss [name] - Manually award boss kill points to current group/raid
/gpt mplusgroup [level] - Award Mythic+ points to current group
/gpt add Name Amount Reason - Add or subtract bonus points
/gpt alt Main Alt - Link an alt to a main character
/gpt unalt Alt - Remove an alt link
/gpt sync on - Enable guild sync
/gpt sync off - Disable guild sync
/gpt synctest - Send a sync test
/gpt syncstatus - Open/view sync status
/gpt export - Export CSV text
/gpt min Number - Set minimum raffle points
/gpt officer on|off - Toggle soft officer guard

TABS
Players: Shows guild members and their current point totals. Columns include Points, Raids, Bosses, Mythic+, and Bonus. Use this tab for normal tracking and raffle management.

Recent Events: Shows a log of addon activity such as roster scans, raid awards, boss kill awards, Mythic+ awards, bonus points, raffle winners, and sync messages.

Sync Status: Shows which online guild members have responded to addon sync checks, their addon version, last seen time, and whether they may need the addon installed or updated. Guild members must have GuildPrizeTracker installed and sync enabled to appear as Sync OK.

Alt Tracking: Lets officers link alt characters to a main character. Raffles treat linked alts as the same person, helping avoid awkward duplicate-win situations.

ALT TRACKING NOTE
World of Warcraft addons cannot automatically see a player's Battle.net account, account-wide character list, or reliably know which characters are alts. This is a privacy/API limitation. GuildPrizeTracker supports manual main/alt linking. A future version can add optional self-report sync or guild-note import.

RAIDER.IO NOTE
WoW addons cannot live-query websites directly. Raider.IO-style data must come from either the Raider.IO addon data already installed locally, manual import/export, or an external tool. Future versions may add a soft integration/import workflow.

INSTALL
Place the GuildPrizeTracker folder into:
World of Warcraft/_retail_/Interface/AddOns/

Then reload the game and run /gpt open.


Version 0.5.4 Notes
- Officer Guard should stay ON for guild use. Officers/Guild Master can award raid, add bonus points, reset week, manually award M+, and run raffles. Regular members can open the addon, view standings, and participate in sync.
- Mythic+ group sync is best-effort: at least one guild member in the run needs the addon installed with Guild Sync ON. The addon reports the current guild members it sees in that run.
- Random and weighted raffles now show a pop-up winner box as well as a chat message and event log entry.


OFFICER GUARD / PERMISSIONS
When Officer Guard is ON, management actions are locked to detected addon managers. This includes raffles, resets, point awards, bonus points, and attendance awards. Regular members can still open the UI, view standings, use sync, and show status.

Manager detection checks these signals:
- Guild Master status
- Ability to edit officer notes when available from the WoW API
- Guild rank index at or above the allowed officer threshold, default 2
- Rank names containing "officer"

Guild Masters can tune the rank threshold with:
/gpt officerrank 2

WoW rank indexes start at 0 for Guild Master. Officer ranks are often 1 or 2 depending on the guild setup.

MYTHIC+ AND BOSS TRACKING NOTE
M+ completion points can sync from guild members running the addon. Boss kill points are awarded when the addon receives boss kill events during the run. If a player only reports the completed key but the addon did not see the boss kill events, the M+ column may update while the Bosses column does not.


Tab guide:
Players - View the current guild point table. This is the clean overview for points, raid attendance, boss kills, Mythic+ completions, and bonus points.
Awards - Officer tools for adding manual bonus points and manually awarding the current group for a Mythic+ completion.
Recent Events - Audit log showing recent roster scans, point awards, boss kills, sync checks, raffle rolls, and other addon activity.
Sync Status - Shows online guild members, who has the addon installed, version info, and last sync seen. Use Send Sync Test to check adoption.
Alts - Link alts to a main character so raffles treat multiple characters as one player/account.

Raffle modes:
Random Raffle - Everyone who meets the minimum point requirement gets one equal entry.
Weighted Raffle - Points act like raffle tickets. More points means better odds, but the winner is still randomly selected.


Version 0.5.8 notes:
- Hover over buttons for tooltips explaining what each control does.
- Raffle Help popup is fixed.
- Minimap icon alignment adjusted for the circular border.


Self Main Sync:
Players can run /gpt setmain MainName one time. After that, any alt they log into with GuildPrizeTracker installed reports that main name during sync/version checks. This avoids officers manually linking every alt while staying within WoW addon API limits.

Version Checks:
Use /gpt versioncheck or the Check Versions button on Sync Status. Online guild members with the addon installed reply with their current version and saved main name. Characters with no reply are shown as missing addon/no response.

## v0.6.8 Notes
- Sync Status shows one row per main/player. Linked alts are folded into the main row.
- If someone just installed the addon, have an officer/manager online and click Check Versions or run /gpt requestdata. Managers can also run /gpt pushdata.
- The addon window now uses a higher frame priority so it should appear over common meters and cooldown trackers.


Version 0.7.0 Notes
- The UI is grouped by purpose so new users can find raffle, sync, and officer tools more easily.
- Use Sync Points or Refresh Points if a viewer does not see the newest totals yet.
- Export CSV opens a scrollable copy window.


Version 0.7.1 Notes
- Everyone can use Sync Points / Refresh Points to request the latest official data from an online manager.
- 'Sync ack from NAME' means that character has the addon installed and replied to your sync/version check.
- CSV export opens in a larger copyable scroll window.
