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

![Main Interface](https://raw.githubusercontent.com/DJilanov/ally-level-addon-wow-tbc/main/screenshots/01-main-interface.png)

*See your current recommendation with optimization modes and faction progress tracking*

### Outland Dungeon Map

![Outland Map](https://raw.githubusercontent.com/DJilanov/ally-level-addon-wow-tbc/main/screenshots/02-outland-map.png)

*Interactive map showing all dungeon locations and level ranges*

### Detailed Loot Information

![Dungeon Loot](https://raw.githubusercontent.com/DJilanov/ally-level-addon-wow-tbc/main/screenshots/03-dungeon-loot.png)

*Browse boss loot tables to plan your runs*

### Boss Abilities & Strategy

![Boss Abilities](https://raw.githubusercontent.com/DJilanov/ally-level-addon-wow-tbc/main/screenshots/04-boss-abilities.png)

*Study boss mechanics before you pull*

### Dungeon Maps

![Dungeon Map](https://raw.githubusercontent.com/DJilanov/ally-level-addon-wow-tbc/main/screenshots/05-dungeon-map.png)

*View detailed layouts for each instance*

### Location & Requirements

![Dungeon Location](https://raw.githubusercontent.com/DJilanov/ally-level-addon-wow-tbc/main/screenshots/06-dungeon-location.png)

*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!**