# Vamoose's Housing Decor Guide

**Your complete companion for housing decor in World of Warcraft — find it, track it, craft it, buy it.**

All 1,690 housing decorations in one addon. Browse every acquirable item, plan vendor shopping routes with TomTom waypoints, queue crafting recipes with material tracking, and monitor profit margins — all with account-wide alt awareness.

---

## 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.4.0 — The Acquire Tab

Previously the addon only covered crafted recipes. Now it covers **everything** — every vendor, every quest reward, every achievement unlock, every world drop, every crafted item. One tab to answer: *"What am I missing, and how do I get it?"*

**NEW: Acquire Tab**
- Browse **1,646 acquirable items** from every source in the game
- **By Vendor** — Browse 200+ vendors alphabetically, filter by zone, see their full stock in a 3D gallery with prices and rep requirements
- **By Item** — Flat searchable list of every item, with source icons showing how to get each one
- **Map All** — Drop TomTom waypoints on every vendor matching your filters for efficient shopping routes
- **Crafted Items** — Select any crafted item to see reagents and add it directly to your Crafting Queue
- **Filters** — Narrow by Expansion, Zone, Reputation, Source type, Uncollected only, and text search

**Also new in this release:**
- **Find Vendor** button in Preview tab — jump straight to the Acquire tab for any vendor-sold item
- **Decor Collection Stats** in Data tab — items owned, placed, stored, with category breakdown and CSV export
- **In-App Guide** — "How to Use" panel with icon legend and step-by-step use cases

See CHANGELOG.txt for full version history.

---

## Acquire Tab — Vendor Shopping & Item Finder

**The single source of truth for every acquirable decoration.**

Plan efficient shopping routes across 200+ vendors, or search the flat item list to find exactly what you're missing. Supports vendor items, quest rewards, achievement unlocks, world drops, crafted items, treasures, and promotions.

- **By Vendor** — Browse vendors alphabetically. Expand to see stock, collected counts (e.g. 3/5), and prices. Filter by zone, expansion, or reputation. Click any vendor for full details.
- **By Item** — Alphabetical list of all 1,646 acquirable items with source icons, collected status, and rep/faction indicators.
- **Filters** — Expansion, Zone, Reputation, Source type, Uncollected only, and text search. Combine freely.
- **Map All** — Drop TomTom waypoints on every vendor matching your current filters. Great for zone-focused shopping runs.
- **Set Waypoint / Show on Map** — Navigate directly to any vendor with TomTom or the world map.
- **Crafted Items** — See profession, expansion, and reagent list. "Add to Crafting Queue" sends recipes to the Recipes tab.
- **How to Use Guide** — Built-in guide with icon legend and common use cases.

---

## 3D Decor Preview

**See before you craft or buy.** Browse all housing decorations with interactive 3D models.

- **Catalog Browser** — Browse ALL 1,690 housing decor items, not just craftable recipes
- **64 Tag Filters** — Filter by size, faction, style, expansion
- **Collection Progress** — See "X / Y (Z%)" collected with color coding
- **Find Vendor** — Jump directly to the Acquire tab for any vendor-sold item
- **Add All to Queue** — Add all filtered craftable items at once

---

## Recipe Browser & Crafting Queue

**245 housing decor recipes** across all 9 professions with intelligent material management.

- **Search** — Find recipes by name or materials (+Mats toggle)
- **All | Ready** — Filter by material availability with tier grouping
- **Crafting Queue** — Grouped by character, with profession icons and "who can craft this" awareness
- **Material Tracking** — Real-time have vs. need with inventory awareness
- **Power Crafting** — DAG-based raw material resolution expands crafted reagents recursively
- **AH Integration** — Full Auctionator & TSM support with quantities and scan button
- **Craft Button** — Quantity selector with +/- controls and "Max N" option

---

## Goblin Tab — Profit Analysis

**Find the most profitable crafts.**

- **Profit Analysis** — Sell price, material cost, profit, and margin for every recipe
- **Lumber Value** — Implied gold per lumber when crafting each item
- **Sortable Columns** — Sort by any metric
- **Region Avg & TSM %** — TSM integration for regional market data
- **Material Breakdown** — Click to expand direct vs. raw costs
- **CSV Export** — Export all profit data

---

## Alts Tab — Account-Wide Tracking

**See every character's profession skills at a glance.**

- **Summary Grid** — Every profession x expansion across all characters
- **Color-Coded** — White (no data), Yellow (below threshold), Teal (ready to craft)
- **Skills & Recipes Views** — Toggle between skill levels and known recipe counts
- **Recipe Awareness** — "Known by: AltName" on recipe tooltips throughout the addon

---

## Lumber Tracker & Radar HUD

**Pinnable widget with temporal radar for gathering routes.**

- **Pin Mode** — Keep visible when main window closes
- **Farming Stats** — Active session tracking with rate/hour and zone
- **Radar HUD** — Circular radar showing recent gathering locations with respawn colors
- **Account-Wide** — Sums inventory across all characters including Warband Bank
- All 12 lumber types: Classic through Midnight

---

## Additional Features

- **Trainer Locations** — All profession trainers by expansion with TomTom waypoints
- **Data Tab** — Crafting/acquisition history, farming sessions, and CSV export
- **Decor Collection Stats** — Items owned, placed, stored with category breakdown
- **Theme System** — Housing (Blizzard gold), HDGDefault (teal), Solarized, and more
- **Localization** — 9 languages: DE, ES, FR, IT, RU, KO, ZH, PT, and English
- **Talking Head Quotes** — Flavor quotes while farming and crafting

---

## Quick Start

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

**Tabs:** Recipes | Goblin | Preview | Acquire | Trainers | Alts | Data | Config

**Commands:**
- `/hdg` — Toggle main window
- `/hdg tags` — List all decor tags
- `/hdg decor` — Filter profession window to decor recipes

---

## Requirements

**Required:**
- World of Warcraft: The War Within (11.1.0+) / Midnight (12.0)

**Recommended:**
- **TomTom** — Vendor waypoints and Map All
- **Auctionator** — AH search integration
- **TradeSkillMaster (TSM)** — Price data and market analysis

---

## Support & Feedback

Found a bug or have a suggestion? Please report on CurseForge or join our Discord!

Discord: https://discord.gg/RWZaxJaHFP

---

**Author:** Vamoose
**Version:** 2.4.0
**Game Version:** 11.1.0+ / 12.0 (The War Within / Midnight)
