# 🏠 Vamoose's Housing Decor Crafting Helper

**The ultimate companion for crafting all 245 housing decorations in World of Warcraft!**

Track recipes, manage materials, and craft with ease across all 9 professions with a crafting queue, auction house integration, and account-wide profession tracking.

---

## 📰 **Featured on Icy Veins!**

> *"Goblin Mode Just Turned Housing Decor Into a Gold Printer"*

🔗 [Read the full article on Icy Veins](https://www.icy-veins.com/wow/news/goblin-mode-just-turned-housing-decor-into-a-gold-printer/)

---

## 🚀 **What's New in v2.2.1 - Bug Fixes & Performance**

- 🔧 **VE Compatibility** - Fixed white box when running with Vamoose's Endeavors addon
- ⚡ **Lumber Performance** - Fixed memory growth during extended farming sessions
- 🧹 **Lumber UI Simplified** - Removed rarely-used focus tracker and inline reset buttons

### 🆕 **Recent in v2.2.0**

- 🏠 **Housing Theme** - Beautiful wood panel backgrounds with decorative foliage
- 🎨 **Theme Selector** - Switch themes from title bar button

📖 *See CHANGELOG.txt for complete version history*

---

## 🎨 **Features**

### 📚 **Recipe Browser**
Browse **245 housing decor recipes** across all 9 professions with powerful filtering.

- 🔍 **Search Box** - Find recipes by name or materials (+Mats toggle)
- ❌ **Uncollected Only** - Hide recipes for decor you already own
- 📊 **All | Ready Toggle** - Filter by material availability
- 🟡 **Gold text** = recipes you've learned
- ⚪ **White text** = recipes an alt knows (tooltip shows which alt)
- ✅ **Green checkmark** = items you've collected
- 📖 **Dual Badges** - See recipes known (teal) + decor collected (gold) per profession

### 🎨 **3D Decor Preview**
**See before you craft!** Browse decorations (not just crafted - all of them!) with interactive 3D models.

- 🖼️ **3D Model Viewer** - Drag to rotate and view from any angle
- 📚 **Catalog Browser** - Browse ALL housing decor, not just craftable recipes
- 🏷️ **64 Tag Filters** - Filter by size, faction, style, expansion
- 📊 **Collection Progress** - See "X / Y (Z%)" collected with color coding
- ⭐ **Alt Awareness** - Gold star = you know it, Grey star = alt knows it
- ➕ **Add All to Queue** - Add all filtered craftable items at once

### 🛒 **Crafting Queue**
**Intelligent material aggregation** with real-time tracking.

- 👥 **Grouped by Character** - Items sorted by who can craft them
- 🎨 **Profession Icons** - Visual identification next to each item
- 📦 **Material Totals** - Combines materials from all selected recipes
- 💼 **Inventory Tracking** - Shows have vs. need amounts
- 🛍️ **AH Integration** - Full Auctionator & TSM support with quantities
- 🔧 **Craft Button** - Shows craftable count, +/- quantity selector

### 👥 **Alts Tab**
**Account-wide profession tracking** across all your characters.

- 📊 **Summary Grid** - Every profession × expansion at a glance
- 🎨 **Color-Coded Skills**:
  - **White** = No skill data
  - **Yellow** = Skill too low for decor
  - **Teal** = Ready to craft
- 📖 **Recipe Awareness** - "Known by: AltName" on recipe tooltips
- 🔄 **Auto-Refresh** - Updates when profession window opens

### 🪵 **Lumber Tracker & Radar HUD**
**Pinnable widget** for expansion-specific lumber with temporal radar.

- 📌 **Pin Mode** - Keep visible when main window closes
- 📊 **Farming Stats** - Active session tracking with rate/hour
- 📡 **Radar HUD** - Circular radar showing recent gathering locations
- 🎨 **Respawn Colors** - Red/Yellow/Green blips show node status
- 📏 **Distance Rings** - 150y and 300y for easy navigation
- 🪵 All 12 lumber types across expansions (Classic through Midnight)

### 📜 **Data Tab**
**Track your crafting and farming history.**

- 📊 **Acquisition History** - When decor was crafted or learned
- 🪵 **Farming History** - Lumber sessions with duration, rate, zone
- 💰 **Price Tracking** - AH prices and material costs at craft time
- 📋 **CSV Export** - Export all history data

### ⚡ **Power Crafting (Raw Materials)**
**See what you actually need to gather.**

- 🔄 **Direct | Raw Toggle** - Switch between immediate and base materials
- 📊 **DAG Resolution** - Expands crafted reagents recursively (up to 10 levels)
- 🧮 **True Material Costs** - Shows gathering/vendor items, not intermediate crafts
- 🔗 **Craft Chain Awareness** - Handles multi-profession dependencies

### 💰 **Goblin Tab (Profit Analysis)**
**Find the most profitable crafts!**

- 📊 **Profit Analysis** - See sell price, material cost, profit, and margin
- 🪵 **Lumber Value** - Implied gold per lumber when crafting each item
- 🔢 **Sortable Columns** - Sort by any metric (profit, margin, sell price, etc.)
- 🔍 **Filters** - By profession, expansion, profitability, known recipes
- 📋 **Material Breakdown** - Click row to expand direct vs. raw costs
- 🔄 **Auctionator Scan** - Trigger AH scans directly from the tab

### 🗺️ **Trainer Locations**
**Never search for trainers again.**

- 📍 All profession trainers by expansion
- 🔵 Alliance & 🔴 Horde locations with coordinates
- 🧭 TomTom integration for waypoints
- 👥 **Needs Training** - Shows which alts need more skill in each expansion

---

## 🚀 **Quick Start**

Type **`/hdg`** to open the main window.

### 💡 **Pro Tips**

**Recipe Interactions:**
- 🖱️ **Click recipe** → Add to crafting queue
- 🔨 **Click hammer icon** → Open in profession window

**Material Interactions:**
- 🖱️ **Click** → Set AH search text
- ⬆️ **Shift+Click** → Search in Auctionator/TSM
- 🖱️ **Right-Click** → Add to Auctionator search list
- ⌨️ **Ctrl+Click** → TSM price check

**Tabs:**
- 📋 **Recipes** → Browse and queue recipes with search/filters
- 💰 **Goblin** → Profit analysis and lumber value
- 🎨 **Preview** → 3D models, catalog browser, tag filters
- 👥 **Alts** → Account-wide profession skills
- 📊 **Data** → Crafting/farming history
- 🗺️ **Trainers** → Profession trainer locations
- ⚙️ **Config** → Settings and credits

---

## 📥 **Installation**

1. 📂 Download and extract to `World of Warcraft/_retail_/Interface/AddOns/`
2. ✅ Folder should be named `HousingDecorGuide`
3. 🔄 Type `/reload` or restart WoW
4. 🎉 Type `/hdg` to start!

---

## 📌 **Requirements**

**Required:**
- 🎮 World of Warcraft: The War Within (11.1.0+)

**Optional (Recommended):**
- 🔨 **Auctionator** - AH search integration
- 💰 **TradeSkillMaster (TSM)** - Price checking & market data

---

## 💬 **Commands**

- `/hdg` - Toggle main window
- `/hdg tags` - List all decor tags with counts
- `/hdg decor` - Filter profession window to House Decor recipes

---

## 🐛 **Support & Feedback**

Found a bug or have a suggestion? **Please report on CurseForge!**

We're actively maintaining and improving this addon based on your feedback.

---

**👤 Author:** Vamoose
**📦 Version:** 2.2.1
**🎮 Game Version:** 11.1.0+ / 12.0 (The War Within / Midnight)
