A comprehensive World of Warcraft Classic Era addon for tracking grinding sessions, analyzing efficiency, and maximizing your farming profits.

GrindCompanion is a lightweight yet powerful addon for WoW Classic Era that helps you optimize grinding sessions. Track XP/hour, gold/hour, mob statistics, and loot in real-time with interactive graphs and comprehensive session history.

• Real-Time Tracking - Live ETA to level, kills remaining, and currency earned
• Interactive Analytics - Four graph types with clickable data points and trend analysis
• Session History - Unlimited persistent storage with advanced filtering
• Mob Statistics - Per-mob tracking with currency, XP, and highest quality drops
• Multi-Character Support - Filter by character, class, race, and realm
• Smart Loot Tracking - Automatic vendor values and customizable AH pricing (with Auctionator)

1. Download the latest release
2. Extract to World of Warcraft\_classic_era_\Interface\AddOns\
3. Restart WoW or /reload
4. Look for the minimap button or type /gc

/gc start - Begin tracking 
/gc stop - End session and save 
/gc sessions - View history and analytics 
/gc - Show current stats 
/gc toggle - Toggle grind summary window (show/hide) 
/gc toggle on - Show grind summary window 
/gc toggle off - Hide grind summary window 
/gc minimap - Toggle minimap button visibility 
/gc debug - Toggle pricing debug mode 
/gc testah - Test Auctionator integration 
/gc select-ah start - Enable shift+click to add AH items 
/gc select-ah stop - Disable shift+click mode 
/gc ah-items - List tracked AH items

Minimap Button: Left-click for quick-access menu, drag to reposition

• Sessions History - Open the full session browser
• Start/Stop Session - Begin or end tracking
• Add AH Item - Quick access to item picker
• Hide Minimap Button - Remove button (use /gc minimap to restore)

For detailed command examples and workflows, see Commands Reference.

• Features Guide - Detailed feature descriptions and UI elements
• Commands Reference - Complete command list and usage examples
• Troubleshooting - Common issues and solutions
• Development - Architecture, data structures, and contributing
• FAQ - Frequently asked questions

Auctionator Support (Optional): Install Auctionator for automatic AH price estimates. You can customize which items to track for AH value using /gc select-ah start (shift+click items) or through the Options panel.

• Gold Farming - Compare spots by gold/hour, track mob returns, monitor AH values
• Leveling - Optimize routes with XP/hour trends, real-time ETA, zone comparisons
• Rare Farming - Track highest drops per mob, analyze loot quality trends
• Multi-Character - Compare efficiency across characters and classes

Press Esc → Interface → AddOns → GrindCompanion to:

• Toggle visibility of display rows
• Hide/show minimap button
• Customize AH item tracking (add/remove items from bags)
• Adjust your tracking experience

MIT License - see LICENSE file for details.

• Issues/Features: GitHub Issues
• Contributing: See CONTRIBUTING.md

Enjoying GrindCompanion? Star the repo and share with fellow grinders!