# Vamoose's Housing Decor Crafting Helper

A comprehensive addon to help you track, plan, craft, and acquire all housing decorations across all professions in World of Warcraft.

## Version 2.4.0 - The Acquire Tab

- **NEW: Acquisition Tab** - Vendor shopping guide with 1,646 acquirable items across all source types
- **NEW: All Source Types** - Vendor, Achievement, Quest, Drop, Crafted, Treasure, and Promotion items
- **NEW: "How to Use" Guide** - In-app guide panel with Getting Started, Common Use Cases, and icon reference
- **NEW: "Find Vendor" Button** - Preview tab links non-crafted vendor items directly to Acquisition tab
- **NEW: Decor Collection Stats** - Data tab shows unique items owned, stored, placed, and top categories

See CHANGELOG.txt for complete details.

---

## Features

### Acquisition Tab (NEW in 2.4.0)
- **1,690 housing decor items** from all source types in one searchable list
- **Two views**: "By Vendor" (browse vendors grouped by zone) and "By Item" (flat alphabetical)
- **Vendor details**: Name, zone, coordinates, faction/rep requirements, and stock gallery
- **Source icons**: Achievement crest, quest bang, crosshair, anvil, loot sparkle, crafting orders
- **Filters**: Expansion, Zone, Reputation, Source type, Uncollected, Endeavor toggle
- **"Map All"**: Drop TomTom waypoints for all vendors matching your filters
- **"Set Waypoint" / "Show on Map"**: Navigate to any vendor
- **Crafted items**: View reagents and add to crafting queue directly from Acquisition tab

### Recipe Browser
- **245 housing decor recipes** across 9 professions
- Recipes organized by profession and expansion
- **Gold highlighting** for recipes you've learned
- **Green checkmarks** for items you've collected
- Click any recipe to add it to your crafting queue

### Decor Preview Tab
- **3D Model Viewer** - See exactly what each decoration looks like
- **Full 3D Rotation** - Drag horizontally and vertically to view all angles
- **Catalog Browser** - Browse ALL housing decor, not just craftable recipes
- **64 Tag Filters** - Filter by size, faction, style, expansion
- **Collection Toggle** - Switch between craftable recipes and full catalog
- **Uncollected Filter** - Focus on items you still need
- **"Find Vendor"** - Jump to Acquisition tab for non-crafted vendor items

### Alts Tab (Account-Wide Tracking)
- **Account Summary Grid** - Every profession x expansion at a glance
- **Color-Coded Skills** - White (no data), Yellow (below threshold), Teal (ready)
- **Recipe Awareness** - "Known by: AltName" on recipe tooltips

### Crafting Queue
- Aggregates all materials needed for selected recipes
- Real-time inventory tracking
- **Auctionator/TSM integration** - Search AH directly from materials
- Left-click decrements, right-click removes

### Lumber Tracker
- **Pinnable** - Keep visible when main window closes
- **Materials Expansion** - Show all required materials with price estimates
- Tracks all 12 expansion-specific lumber types (Classic through Midnight)
- Auto-restores on login if pinned

### Data Tab
- **Decor Collection Statistics** - Unique items owned, items in storage, items placed
- **Top 5 Categories** - Breakdown by housing category with item counts
- **Farming History** - Track your gathering sessions
- **Export CSV** - Export collection data

### Trainer Locations
- All profession trainers by expansion
- Alliance and Horde locations with coordinates
- TomTom integration for waypoints

---

## Usage

Type `/hdg` to open the main window.

### Tips
- **Left-click** recipe to add to crafting queue
- **Click** material to set AH search text
- **Shift-click** material to search Auctionator/TSM
- **Right-click** material to add to Auctionator search list
- **Ctrl-click** material for TSM price check
- **Click hammer icon** to open recipe in profession window
- **Click "Find Vendor"** in Preview tab to jump to Acquisition tab

---

## 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

- World of Warcraft: Midnight (12.0+)
- Optional: Auctionator (AH search integration)
- Optional: TradeSkillMaster (price checking)
- Optional: TomTom (vendor waypoints)

---

## Support

- **CurseForge**: [Vamoose's Housing Decor Crafting Helper](https://www.curseforge.com/wow/addons/vamooses-housing-decor-crafting-helper)
- **Discord**: https://discord.gg/EVcQEz32hA

Found a bug? Report on CurseForge or GitHub!

---

**Author:** Vamoose
**Version:** 2.4.0
**Game Version:** 12.0+ (Midnight)
