GetGud Tracker — v0.10.3 GUILD BETA
=====================================

a NRML Joint
PRESS BUTTONS • FIND GAPS • GET BETTER


WHAT IS GETGUD TRACKER?
-----------------------
GetGud Tracker is a lightweight execution-analysis addon.

It does NOT tell you what ability to press next.

Instead, it helps answer:
- How cleanly was I pressing buttons?
- Where did I hesitate?
- Did I lose meaningful uptime?
- How did this pull compare to my others?
- How did I perform across the whole dungeon / raid wing?


QUICK START
-----------
1. Install the GetGudTracker folder into:

   World of Warcraft\_retail_\Interface\AddOns\

2. Make sure the final path is:

   ...\AddOns\GetGudTracker\GetGudTracker.toc

3. Log in.

4. Type:

   /ggt

5. The addon will automatically build a spell library for your current
   character + specialization.

6. Run content normally.

7. Open:

   /ggt -> Reports

   to review pull and instance data.


CORE FEATURES
-------------
LIVE TIMELINE
- Shows your recent player-cast spell history.
- Spell spacing reflects real time between casts.
- Activity line provides a visual reference for mechanical uptime.
- Adjustable:
  - frame position
  - exact X / Y position
  - frame size
  - spell icon size
  - icon-to-line spacing
  - line thickness
  - background opacity
  - line opacity
  - visibility conditions

SPELL LIBRARY
- Character + spec isolated.
- Automatically scans the active spellbook.
- Groups abilities into:
  - Combat / Rotation
  - Cooldowns
  - Items / Trinkets
  - Utility / Other
  - Secondary / Passive Events
- Action-bar abilities are generally tracked automatically.
- Proc/tick/passive noise is generally untracked automatically.
- Left-click a spell to Track / Untrack it.
- Right-click to restore GetGud's automatic tracking choice.
- Search is available.
- Optional spell tooltips.
- Optional keybind labels.

VISIBILITY
- HUD can be hidden without stopping tracking.
- /ggt hide
- /ggt show
- Hide while mounted.
- Hide while Skyriding.
- Show HUD only during combat.

PULL REPORTS
- Raw mechanical uptime.
- Active time.
- Downtime.
- Fight duration.
- Meaningful gap timestamps.
- Longest gap.
- Repeated gap-pattern detection.
- Pull-to-pull comparison.
- Short comparable-pull trends.
- Favorites.
- Notes.

GROUPED INSTANCE REPORTS
- Raid / LFR wings are grouped together.
- Dungeon runs are grouped together.
- Mythic+ runs are grouped together.
- Groups can be collapsed / expanded.
- Child entries show:
  - Trash Pack
  - Boss
  - KILL / WIPE
  - uptime
  - duration

FULL INSTANCE SUMMARY
- Duration-weighted overall uptime.
- Boss-only weighted uptime.
- Trash-only weighted uptime.
- Boss kills / attempts.
- Meaningful gaps across the run.

MYTHIC+ REPORTING
- Dungeon name.
- Keystone level.
- Blizzard time limit.
- Run time.
- TIMED / OVERTIME state.
- Amount under / over timer.
- Keystone upgrade level when available.
- Death count.
- Death-time penalty.
- Score change when available.

RECORDED USES
- Combat potion usage.
- Pre-pots within 10 seconds before combat.
- Player-sourced Bloodlust / Heroism / Time Warp / equivalent effects.
- Player-used drums.
- Potions and player-used drums live under Items / Trinkets in the Spell
  Library instead of Secondary / Passive Events.

GROUP TELEMETRY
---------------
v0.10.3 can combine trustworthy potion + Lust/Drums markers from multiple
GetGud users in the same party/raid.

Each client shares ONLY actions it observed from its own player.

Example:
  Telemetry 2/5 players
  00:02  Bloodlust  - Chuck
  00:03  Potion     - Nate

If Blizzard locks addon messaging during restricted combat/M+, GetGud stores
the outbound messages on the run and retries after combat/completion.

Coverage is mandatory:
  Telemetry 2/5 players

means the other three players are UNKNOWN. GetGud never converts missing
telemetry into "they did not potion" or "they did not Lust."

The feature can be disabled under:
  General -> Group Telemetry


SLASH COMMANDS
--------------
/ggt
    Open GetGud Tracker.

/ggt hide
    Hide the live HUD while tracking continues.

/ggt show
    Show the live HUD.

/ggt info
    Open the Info page.

/ggt last
    Show the most recent pull summary in chat.

/ggt ignorelast
    Legacy shortcut: untrack the most recently observed spell.

/ggt blacklist <spell>
    Legacy shortcut: untrack a spell.

/ggt unblacklist <spell>
    Legacy shortcut: track a spell.

/ggt profile NAME
    Switch to a named settings profile.

/ggt profiles
    List available profiles.


BETA FEEDBACK
-------------
The most useful feedback right now is:

1. ACCURACY
   - Does uptime feel believable?
   - Do gap timestamps match what actually happened?
   - Does pull start / end timing feel correct?
   - Are bosses and trash grouped correctly?

2. CLASS / SPEC BEHAVIOR
   - Are your normal buttons in the right Spell Library category?
   - Is anything important missing?
   - Is proc/tick garbage being shown as a player action?
   - Are trinkets / potions detected correctly?

3. INSTANCE REPORTING
   - Do raid / LFR wings group correctly?
   - Does a full dungeon remain one grouped run?
   - Does Mythic+ show the correct dungeon name, key level and timer?

4. UI
   - Anything clipped?
   - Anything overlapping?
   - Anything difficult to read?
   - Any settings that feel missing?

5. PERFORMANCE / ERRORS
   - Lua errors.
   - UI taint / protected-action warnings.
   - Unusual CPU usage.
   - Memory growth after extended play.

Screenshots are extremely helpful.

Please include:
- class
- spec
- content type
- what you expected
- what GetGud did instead


KNOWN BETA LIMITATIONS
----------------------
- Trash Pack currently means one contiguous player-combat session.
- Full generic dungeon / raid wall-clock time is best-effort.
  Mythic+ completion time uses Blizzard's authoritative result.
- Group-wide Lust detection is not yet considered trustworthy in restricted
  combat.
- Buff Lane / PI / Lust visual windows are not implemented yet.
- Universal boss phase markers are not implemented yet.
- Cooldown-hold analysis is planned but not live yet.
- Coaching is currently execution-pattern based, not spec-rotation advice.
- Keybind detection is best-effort and may still have edge cases with unusual
  action-bar setups.


DESIGN PHILOSOPHY
-----------------
GetGud Tracker is meant to analyze execution, not play the game for you.

The goal is:
- lightweight
- readable
- truthful
- useful across classes
- useful without requiring Warcraft Logs
- useful without becoming a rotation helper

Press buttons. Find gaps. Get better.


v0.10.2 Guild Beta hotfix
-------------------------
- Combat potions now classify under Items / Trinkets.
- Potions default Tracked and can be shown as intentional item-use icons.
- Bag scanning pre-populates potion use spells before they are cast.
- Existing v0.10.1 potion entries learned under Secondary / Passive Events
  repair automatically when the potion is present in the player's bags.
- Player-used drums use the item/consumable classification.
- Class Lust spells remain class abilities.
- Potion/drum display classification does NOT close mechanical gaps or change
  uptime math.


v0.10.3 Guild Beta
------------------
- Added GetGud-to-GetGud group telemetry.
- Registered addon communication prefix: GetGudTracker.
- Shares only the local player's potion + Lust/Drums markers.
- Adds per-run telemetry coverage (for example 2/5 players).
- Adds player attribution and timestamps to covered pull markers.
- Queues outbound messages when Blizzard returns AddOnMessageLockdown.
- Honors the addon-message throttle with a small retry queue.
- Persists unsent telemetry on the active run so /reload does not erase a
  restricted M+ queue.
- Adds a General toggle for group telemetry.
- Does not inspect or serialize secret party-member combat values.
- Missing telemetry remains UNKNOWN, never "No."
