Gold Digger

Gold Digger — v3.6

Gold Digger is a lightweight World of Warcraft addon that tracks your gold flow during a play session in real time. It focuses on clarity, accuracy, and a clean Blizzard-style UI — without unnecessary complexity.

Version 3.6 adds an "Open main window on login" setting so you can choose whether the main window appears automatically on login or stays hidden until you open it manually.

---

✨ Features

💰 Session Tracking

• Tracks income, expenses, and profit during the current session
• Accurate Gold per Hour calculation based on active time only
• Session timer that pauses automatically when tracking is paused
• Tracks gold gained or lost from all game activities

---

📊 Detailed Breakdown

Expandable sections allow you to inspect where your gold comes from and where it goes.

Gold source detection categorizes gains and expenses across different activities.

Income Sources

• Loot
• Vendors
• Mail
• Auction House
• Trading
• Quest rewards
• Bank (Guild Bank, Warband Bank)
• Other sources

Expense Sources

• Vendor purchases
• Repairs
• Mail costs
• Auction House fees
• Trading costs
• Bank (Guild Bank, Warband Bank)
• Taxi (flight master costs)
• Other spending

Each entry displays:

• Blizzard-style icon
• Amount gained or spent
• Tooltip with source details

---

📜 Session Event Log

Gold Digger records individual gold events during each session.

Each log entry includes:

• Timestamp
• Amount gained or spent
• Detected source of the transaction

Session logs allow you to review exactly when and how gold changes occurred during gameplay.

Logs are also stored when a session is saved to history.

---

🔍 Session Log Viewer

A dedicated log viewer window opens when inspecting a session.

• Displays every recorded gold event
• Shows timestamp, source, and gold amount per entry
• Paginated — 11 entries per page with Prev / Next navigation
• Page indicator shows Page X of Y (N entries)
• Opens at the last page — most recent events are visible immediately
• Window title includes the session ID
• Moveable window with saved position

---

🧭 Dynamic Blizzard-Style UI

The main window uses a clean, compact layout consistent with Blizzard interface design.

• Structured rows for key session data
• Expandable sections for detailed analytics
• Icon-based buttons with tooltips
• Visual feedback for interactive elements
• Automatically adjusts height based on visible content

Displayed metrics (configurable):

• Profit (always shown)
• Session ID
• Income (expandable)
• Expenses (expandable)
• Gold per Hour (shows -- for the first 30 seconds)
• GPH comparison vs. best session
• Session Time
• Auto-reset countdown (when timer is enabled)

---

🪟 Compact Mode

A minimal two-row window for active play when screen space matters.

Toggle via the gear menu, Settings → UI, or /gd compact.

In compact mode:

• Shows only Profit, Gold per Hour, and Session Time
• Hides title, session ID, income/expense rows, GPH comparison, and Pause/Reset buttons
• When the auto-reset timer is active, Session Time merges into a single row: 17m 19s / 60m
• The merged timer turns orange under 10 minutes and red under 2 minutes

---

⚙️ Window Display Options

You can customize which metrics appear in the main window.

Options include toggling visibility of:

• Session ID
• Income
• Expenses
• Gold per Hour
• GPH Comparison (disabled automatically when GPH is hidden)
• Session Time
• Timer Countdown (disabled automatically when timer is off)
• Compact Mode — minimal window for active play

Profit is always displayed as it represents the primary session value.

Changes apply instantly without reloading.

---

📄 Session Log Settings

Options to control session log behavior:

• Show log events in chat — prints gold events live in chat
• Max Session Log Entries — limits how many events are stored during a session

---

⏱️ Active Time System

Gold Digger measures true active session time, not real-world elapsed time.

• Paused sessions do not accumulate time
• AFK pauses do not inflate Gold/hour values
• Logout time is not counted
• Provides realistic performance metrics

---

⏸️ Pause & Resume

You can pause tracking at any time.

• Manual pause/resume button
• Optional automatic pause while AFK
• Session timer indicates paused state
• Gold changes are ignored while paused
• Manual resume overrides automatic AFK pause

---

🧠 Session Persistence

Your current session continues seamlessly across reloads or relogs.

• Session state saved automatically
• Active or paused state restored on login
• No loss of progress mid-session

---

📜 Session History

Previous sessions are stored and viewable.

• Dedicated history window
• Profit, duration, and Gold/hour for each session
• Sortable columns — click Date, Profit, Duration, or GPH to cycle sort states: first click descending (▼), second ascending (▲), third resets to default session ID order; active column highlighted with a gold arrow; sort state is remembered across sessions
• Summary statistics across all recorded sessions
• Total profit and total tracked time
• Average profit and average Gold/hour
• Best session indicators
• Session count
• Configurable history size
• Option to clear all history
• Live session row — current session always visible at the top (toggleable in settings)

The history window always shows the current active session as a live row pinned at the top, above all saved sessions. The live row displays real-time profit, duration, GPH, and active/paused status. Hovering shows the same source breakdown tooltip as saved sessions. Right-clicking opens a context menu with Show Log for the current session log. Can be toggled in Settings → History.

Each saved history row is clickable — right-clicking opens a context menu with:

• Show Log — view the full event log for that session
• Delete — remove that session with a confirmation dialog

Hovering over a history row shows a source breakdown tooltip with income and expenses grouped by source, plus the character name and zone recorded when the session was saved.

---

🔒 Window Controls

The interface includes several utility controls:

• Minimap Button — click to toggle the main window, right-click for options, drag to reposition; tooltip shows live profit, GPH, time, and full income/expense source breakdown
• Options Menu — quick access to addon settings
• Reset — start a new session
• History — open session history
• Show Session Log — open the log viewer for the current session
• Pause/Resume — control tracking
• Lock — prevent accidental movement
• Compact Mode — toggle minimal view

Window behavior:

• Movable when unlocked
• Position saved automatically
• Layout adjusts dynamically to content
• No manual resizing required

---

🎮 Commands

Primary slash commands:

/gd /golddigger

Additional commands:

/gd show — Show or hide the main window /gd lock — Lock or unlock window position /gd reset — Start a new session /gd status — Print a one-line session status to chat /gd summary — Print full session summary to chat /gd pause — Pause tracking /gd resume — Resume tracking /gd history — Toggle history window /gd clearhistory — Clear stored session history /gd settings — Open addon settings /gd options — Open addon settings /gd log — Open the session log viewer /gd log X — Print the last X log entries to chat /gd compact — Toggle compact mode on/off /gd timer — Toggle auto-reset timer on/off

---

🧩 Design Philosophy

Gold Digger aims to provide:

• Accurate financial insight without micromanagement
• A clean, unobtrusive interface
• Reliable session statistics
• Useful analytics without Auction House automation

It is intentionally lightweight and complements both casual play and serious gold farming.

---

⚙️ Requirements

• World of Warcraft: Retail
• No external libraries required
• Compatible with default UI and most UI overhauls

---

🛠️ Known Limitations

• Source detection relies on visible UI context and game events
• Rare edge cases may still be categorized as "Other"
• Extremely rapid transactions may be grouped together

---

❤️ Feedback & Contributions

Suggestions, bug reports, and feature ideas are welcome.

Gold Digger is designed to evolve based on real player needs.

---

📌 Version

Current Version: v3.6.0 Author: AU9500

---

Track smarter. Farm richer.