GrindCompanion

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

📋 Overview

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.

Key Features

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)

Screenshots

Live Session Tracking - Leveling Mode

Real-time display showing XP tracking, estimated time to level, and kills remaining

Live Session Tracking - Max Level Mode

Max level display focusing on currency and loot tracking

Session History & Analytics

Comprehensive session browser with interactive graphs and detailed statistics

Detailed Mob Tracking

Per-mob statistics showing kills, currency, XP, and highest quality drops

Multi-Character Support

Filter and compare sessions across multiple characters with race/class icons

🚀 Quick Start

Installation

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

Basic Usage

/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.

📊 What Makes It Different?

Feature	GrindCompanion	Basic Trackers
Interactive Graphs	✅ 4 types with clickable points	❌ Text only
Per-Mob Analytics	✅ Detailed stats + highest drops	❌ Aggregate only
Session History	✅ Unlimited with filtering	⚠️ Limited
Multi-Character	✅ Filter by class/race/realm	⚠️ Basic
AH Integration	✅ Auctionator API	❌ Manual
Adaptive UI	✅ Leveling/max-level modes	❌ Static

📚 Documentation

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

🔌 Integration

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.

🎯 Use Cases

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

🛠️ Configuration

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

📜 License

MIT License - see LICENSE file for details.

📞 Support

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

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