RoguePickPocketTracker

The ultimate pickpocketing companion for World of Warcraft Classic rogues! Track your thievery with style, compete for achievements, and optimize your routes with detailed analytics.

🚀 Key Features at a Glance

💰 Automatic Money & Item Tracking - Never lose track of your ill-gotten gains
🏆 Achievement System - Funny milestone rewards from "Finger Exercises" to "Scrooge McDuck"
📍 Location Analytics - Heat-map style zone and location-based statistics
📊 Session Reports - Detailed summaries after each stealth session
🎯 Success Rate Monitoring - Track attempts vs. successes for optimization
💬 Group Sharing - Broadcast your accomplishments to party/guild chat
⚙️ Rich Options Panel - Customizable settings and detailed statistics view
🔧 Granular Reset Options - Reset specific data types without losing everything

📋 Getting Started

Installation

Download the latest release from GitHub
Extract to your World of Warcraft\_classic_era_\Interface\AddOns\ directory
Restart WoW or type /reload in-game
Start pickpocketing - the addon begins tracking automatically!

First Steps

Type /pp to see your current statistics
Visit /pp options to configure settings and view achievements
Try /pp zone to see location-based analytics
Use /pp share to show off your progress to friends

🏆 Achievement System

Earn bragging rights with our comprehensive achievement system featuring funny names and difficulty scaling:

🎯 Session Challenges

Master single-session pickpocketing sprees:

Finger Exercises → Shadow Lord (1 to 25 mobs per session)
Shiny Trinket → Treasure Hunter (1 to 5 items per session)

📈 Lifetime Milestones

Build your criminal empire over time:

Getting Started → Legendary Thief (10 to 10,000 total pickpockets)
Coin Collector → Scrooge McDuck (1 silver to 1,000 gold earned)
First Find → Museum Curator (1 to 1,000 total items)
Tourist → Globe Trotter (pickpocket across 1 to 20+ zones)

Access achievements via /pp achievements or the options panel!

📍 Location Analytics

Optimize your pickpocketing routes with detailed zone and location tracking:

Zone Statistics - See which areas are most profitable
Location Breakdown - Sub-zone analysis for pinpoint accuracy
Success Rate Analysis - Identify the best farming spots
Heat-Map Data - Build comprehensive area-by-area strategies

Zone Commands

/pp zone - Current zone stats
/pp zone all - All zones overview
/pp zone Stormwind City - Detailed zone breakdown
/pp zone location - Specific location stats

💬 Slash Commands

Main Commands:

/pp - Show current statistics and help
/pp options - Open the comprehensive options panel
/pp achievements - View your achievement progress

Sharing & Social:

/pp share - Share totals and recent session summary
/pp share achievements - Share achievement progress
/pp share locations - Share your top 3 pickpocket spots
/pp auto share - Toggle automatic sharing to chat

Data Management:

/pp reset [type] - Granular reset options:
- achievements - Reset only achievements
- coins - Reset only money and items
- locations - Reset only zone/location data
- all - Reset everything (requires confirmation)

Detailed Analytics:

/pp items - Show cumulative item breakdown
/pp zone - Current zone statistics
/pp zone all - All zones overview
/pp zone [name] - Specific zone details
/pp zone [name] all - Complete location breakdown

Utilities:

/pp togglemsg - Toggle loot notification messages
/pp debug - Toggle debug mode for troubleshooting

🎮 How It Works

The addon seamlessly integrates with your gameplay by monitoring:

🥷 Stealth Detection - Automatically starts sessions when you enter stealth
✋ Spell Casting - Detects Pick Pocket usage and attempts
💰 Money Changes - Tracks increases to your character's money
📦 Loot Messages - Parses chat for pickpocketed items
⚔️ Combat Log - Records successes and failures for analytics

Session Management

Session Start: Entering stealth or casting Pick Pocket
Session End: Stealth expires + 2-second grace period
Session Reports: Automatic summary if anything was gained

⚙️ Configuration

All settings auto-save and include:

Setting	Description
Show Messages	Toggle pickup notifications
Auto Share	Automatically share session summaries
Debug Mode	Enable detailed logging
Alert Opacity	Customize achievement notification transparency

Plus comprehensive tracking of coins, attempts, items, zones, locations, and achievement progress.

🔧 System Requirements

Game Version: World of Warcraft Classic Era (Interface 11507+)
Character Class: Rogue (addon designed specifically for rogues)
Dependencies: None - completely standalone

❓ Troubleshooting

Addon not tracking?

✅ Verify you're playing a Rogue character
✅ Enable debug mode with /pp debug
✅ Check addon is loaded in your AddOns menu
✅ Ensure you're pickpocketing (not just looting corpses)
✅ Try /reload to refresh the UI

Need help? Check the Issues page or submit a bug report!

🚀 Future Features

Exciting features in development:

🔓 Lockbox Tracking - Monitor lockpicking statistics
🏆 Lockbox Achievements - New milestone categories
💬 Lockpicking Services - Auto-advertise your skills
🖥️ Permanent UI Elements - Optional always-visible tracking
📱 Session Toast Notifications - Achievement-style alerts

🤝 Contributing

We welcome contributions from the community! Here's how to get involved:

🐛 Reporting Issues

Use the GitHub Issues page
Include your WoW version, addon version, and steps to reproduce
Check existing issues before submitting duplicates

💻 Development Setup

Fork the repository on GitHub
Clone your fork locally
Make changes and test thoroughly in-game
Submit a Pull Request with a clear description

🏗️ Building Releases

./buildAndRelease.sh  # Automated packaging and GitHub release

The project uses GitHub Actions for automated releases when tags are pushed.

📝 Code Style

Follow existing Lua conventions in the codebase
Comment complex logic clearly
Test changes with multiple scenarios before submitting

💡 Feature Requests

Open an Issue with the "enhancement" label
Describe the feature and its benefits clearly
Consider contributing the implementation yourself!

📄 License

This project is open source and available under a permissive license. Feel free to:

✅ Use and modify for personal use
✅ Distribute and share with others
✅ Fork and create derivative works
✅ Contribute improvements back to the community

Happy Pickpocketing! 🥷💰

Created with ❤️ by Wurby for the WoW Classic community

Rogue Pick Pocket Tracker