The ultimate leveling companion for World of Warcraft's 20th Anniversary TBC phase!
# DJ Dungeon Spam Guide
**The ultimate leveling companion for World of Warcraft's 20th Anniversary TBC phase!**
Master the art of dungeon spam leveling from 60-70 with intelligent recommendations, comprehensive loot guides, and real-time reputation tracking. Never wonder which dungeon to run next!
---
## šÆ What Does This Addon Do?
DJ Dungeon Spam Guide analyzes your character's level, reputation, and progression to **automatically recommend the optimal dungeon** for your next run. It tracks your progress across all 15 TBC dungeons and 6 factions, helping you maximize XP gains, reputation, and loot efficiency.
Whether you're a fresh level 60 stepping through the Dark Portal or a seasoned level 70 farming your last Exalted reputation, this addon has you covered!
---
## ⨠Key Features
### š² Smart Dungeon Recommendations
- **Intelligent Algorithm**: Considers your level, faction reputation, and dungeon completion
- **Multiple Optimization Modes**: Choose between maximizing XP, reputation, or balanced progression
- **Heroic Preparation**: Tracks progress toward Honored reputation for heroic keys
- **Run Estimates**: Shows exactly how many runs needed to cap reputation or reach the next level
### š Comprehensive Tracking
- **Real-Time Updates**: Automatic tracking of dungeon runs, XP gains, and reputation changes
- **All 15 TBC Dungeons**: From Hellfire Ramparts to Black Morass
- **6 Faction Progress Bars**: Visual tracking for Honor Hold, Cenarion Expedition, Lower City, Keepers of Time, The Sha'tar, and The Consortium
- **Statistics Dashboard**: See your total runs, time invested, and progression at a glance
### šŗļø Interactive Maps & Guides
- **Outland Overview Map**: See all dungeon locations with level ranges
- **Individual Dungeon Maps**: Detailed layouts for each instance
- **Boss Loot Tables**: Know what drops before you run
- **Boss Abilities & Strategies**: Quick reference for mechanics and tactics
- **Location Information**: Zone, entrance location, and requirements
### šØ Beautiful Interface
- **Clean, Modern UI**: Blizzard-style frames that match the game's aesthetic
- **Minimap Button**: Quick access to all features
- **Color-Coded Status**: Instantly see recommended dungeons (green) vs completed ones (gray)
- **Responsive Design**: Updates automatically as you play
---
## šø Screenshots
### Main Interface - Smart Recommendations

*See your current recommendation with optimization modes and faction progress tracking*
### Outland Dungeon Map

*Interactive map showing all dungeon locations and level ranges*
### Detailed Loot Information

*Browse boss loot tables to plan your runs*
### Boss Abilities & Strategy

*Study boss mechanics before you pull*
### Dungeon Maps

*View detailed layouts for each instance*
### Location & Requirements

*Find entrance locations and check requirements*
---
## š Installation
### Via CurseForge Client (Recommended)
1. Install the CurseForge app
2. Search for "DJ Dungeon Spam Guide"
3. Click Install
4. Launch WoW!
### Via Wago App
1. Install the Wago app
2. Browse addons and search for "DJ Dungeon Spam Guide"
3. Install with one click
4. You're ready to go!
### Manual Installation
1. Download the latest release
2. Extract the `DJDungeonSpamGuide` folder
3. Place it in your WoW AddOns directory:
```
World of Warcraft/_anniversary_/Interface/AddOns/
```
4. Restart WoW or type `/reload` in-game
---
## š” How to Use
### Quick Start
1. Type `/ds` or `/dungeonspam` to open the main window
2. Check your **Current Recommendation** at the top
3. Choose your optimization mode (Maximize XP, Balanced, or Maximize Rep)
4. Run the recommended dungeon!
5. The addon automatically tracks your progress
### Slash Commands
- `/ds` or `/dungeonspam` - Toggle the main window
- `/ds recommend` - Show current recommendation in chat
- `/ds status` - Display your character's status
- `/ds runs` - View your dungeon run counts
- `/ds reset` - Reset all tracking data (with confirmation)
- `/ds help` - Show all available commands
### Optimization Modes
**š Maximize XP**
- Prioritizes dungeons with highest XP per hour
- Best for speed leveling
- Recommended for levels 60-69
**āļø Balanced** (Recommended)
- Balances XP gains with reputation progress
- Ensures steady progression toward heroic keys
- Great for most players
**ā Maximize Rep**
- Focuses on reaching Honored/Revered/Exalted
- Essential for heroic key farming
- Perfect for level 70 players
**𦸠Heroics Mode**
- Available at level 70 with Honored reputation
- Tracks heroic-specific rewards
- Coming soon!
---
## š Dungeon Progression Path
The addon guides you through TBC dungeons in optimal order:
**60-62**: Hellfire Ramparts → Blood Furnace
**62-64**: Slave Pens → Underbog
**64-66**: Mana-Tombs → Auchenai Crypts
**66-68**: Old Hillsbrad → Sethekk Halls
**68-70**: Shadow Labyrinth, Steamvault, Shattered Halls
**70**: Mechanar, Botanica, Arcatraz, Black Morass
Each dungeon is associated with specific factions that provide heroic keys at Honored reputation!
---
## šļø Factions & Heroic Keys
| Faction | Dungeons | Heroic Key |
|---------|----------|------------|
| **Honor Hold** | Hellfire Ramparts, Blood Furnace, Shattered Halls | Flamewrought Key |
| **Cenarion Expedition** | Slave Pens, Underbog, Steamvault | Reservoir Key |
| **Lower City** | Auchenai Crypts, Sethekk Halls, Shadow Labyrinth | Auchenai Key |
| **Keepers of Time** | Old Hillsbrad, Black Morass | Key of Time |
| **The Sha'tar** | Mechanar, Botanica, Arcatraz | Warpforged Key |
| **The Consortium** | Mana-Tombs | N/A |
All heroic keys require **Honored** reputation with the respective faction.
---
## š§ Frequently Asked Questions
**Q: Does this work for Horde?**
A: Currently designed for Alliance factions. Horde support may come in future updates!
**Q: Will this track heroic dungeons?**
A: Heroic mode tracking is planned for a future release!
**Q: Can I manually mark dungeons as completed?**
A: The addon automatically tracks dungeon entries. Manual marking is coming soon!
**Q: Does this work with other leveling addons?**
A: Yes! DJ Dungeon Spam Guide is designed to work alongside other addons.
**Q: I found a bug, where do I report it?**
A: Join the [Discord](https://discord.gg/v8BVn9qf) and message **KFC Spineshatter**, report on [GitHub Issues](https://github.com/DJilanov/ally-level-addon-wow-tbc/issues), or leave a comment below!
---
## š® Perfect For
ā
Players leveling from 60-70 in TBC
ā
Dungeon spam enthusiasts
ā
Reputation farmers
ā
Anyone preparing for heroics
ā
Min-max levelers who want optimal routes
ā
Groups organizing dungeon runs
---
## š ļø Technical Details
- **Game Version**: World of Warcraft 20th Anniversary Edition (TBC Phase)
- **Interface Version**: 20505
- **Saved Variables**: Yes (progress persists between sessions)
- **Memory Usage**: Lightweight (<1 MB)
- **Performance Impact**: Minimal
---
## š¢ Support & Feedback
Love the addon? Leave a comment and rating!
Found a bug or have a suggestion? Let me know!
**š¬ Discord Support**: Join the [support Discord](https://discord.gg/v8BVn9qf) and message **KFC Spineshatter** for help with the addon
**GitHub**: [ally-level-addon-wow-tbc](https://github.com/DJilanov/ally-level-addon-wow-tbc)
**Author**: Dimitar Jilanov
---
## š Changelog
### Version 1.0.0
- Initial release
- Smart dungeon recommendation engine
- All 15 TBC dungeons tracked
- 6 faction reputation bars
- Interactive Outland map
- Detailed boss loot tables
- Boss abilities and strategies
- Dungeon maps and location info
- Multiple optimization modes
- Minimap button
- Comprehensive slash commands
---
## š Credits
Dungeon data and statistics sourced from TBC Classic research and community contributions.
---
**Ready to optimize your leveling journey? Download now and never waste a dungeon run again!**

