# CurseForge Release Guide - v1.6.0

## Upload Information

**Version:** 1.6.0
**Release Type:** Release (stable)
**Game Version:** The War Within (11.0.2)
**File:** HousingDecorGuide_v1.6.0_RELEASE.zip (52KB)

## Release Title
Vamoose's Housing Decor Crafting Helper v1.6.0 - Live API Integration

## Short Description (for project page)
Track housing decoration recipes, materials, and trainers across all professions. Now with live API integration for accurate reagent lists!

## Changelog Summary (for upload)
Major update with live API integration, expansion-themed colors, grouped materials, and critical bug fixes. Complete details in CHANGELOG.txt.

## Full Description (for CurseForge project page)

---

# Vamoose's Housing Decor Crafting Helper

**Your complete guide to crafting housing decorations in World of Warcraft!**

## 🎯 What It Does

Track all 243 housing decoration recipes across 9 professions with smart shopping lists, live material tracking, and trainer locations.

## ✨ Version 1.6.0 - Major Update!

### Live API Integration 🚀
- Reagents fetched directly from WoW using `C_TradeSkillUI`
- Always accurate, auto-updates with game patches
- No more missing materials!

### Expansion-Themed Colors 🎨
- Shopping list items color-coded by expansion
- Materials inherit colors from source recipes
- Easy visual identification (Classic=Gray, TBC=Green, Wrath=Blue, etc.)

### Grouped Materials by Source 📦
- Organized into collapsible categories:
  - **To Buy** (vendor items)
  - **To Gather** (mining, herbs, lumber)
  - **To Craft** (intermediate components)
- Sort by expansion within categories
- Click headers to collapse/expand

### Professional UI Polish
- WoW-standard icons throughout
- 24x24 collapse arrows match UI conventions
- Clean, minimal design
- Persistent state (collapsed categories saved)

## 📋 Key Features

### Recipe Tracking
- 243 housing decor recipes
- 9 professions (Alchemy, Blacksmithing, Cooking, etc.)
- Classic through The War Within
- Visual progress bars per profession
- Recipe highlighting (green = known, dark = unknown)

### Smart Shopping Lists
- Add multiple recipes at once
- Auto-aggregates all materials
- Shows what you have vs. need
- Surplus tracking (e.g., "40/40+221")
- Click to remove items

### Lumber Tracking
- Dedicated section for all 11 lumber types
- Progress bars for each expansion's lumber
- Compact mode for focused farming
- Always visible in shopping panel

### Trainer Locations
- Complete database of trainers
- Coordinates for all locations
- Organized by profession and expansion
- Easy navigation

## 🎮 How to Use

1. Type `/hdg` to open
2. Browse **Recipes** tab by profession
3. Click recipes to add to shopping list
4. View **Materials Needed** grouped by source
5. Check **Trainers** tab for learning locations

**Compact Mode:** Click collapse button (top-right) for lumber-only view

## 📊 Coverage

- **Overall:** 126/243 recipes (52%)
- **Best Coverage:** Cooking (100%), Inscription (81%), Alchemy (74%)
- **Active Development:** More recipes being added regularly

## 🔧 Commands

- `/hdg` - Open addon
- `/hdg help` - Show help
- `/hdg reset` - Reset window position

## 🐛 Bug Fixes in v1.6.0

- ✅ Materials panel clearing issue resolved
- ✅ Removed conflicting refresh timers
- ✅ Fixed lumber layout alignment
- ✅ Improved refresh architecture

## 🙏 Credits

Created by **Vamoose** for the WoW housing decoration community.

## 💬 Feedback & Support

Found a bug? Have a suggestion? Please leave a comment or open a ticket!

**Note:** Recipe knowledge detection is still being refined. Some features are in active development.

---

## Tags (for CurseForge)
- Professions
- Tradeskill
- Housing
- Crafting
- UI
- Tracking
- Database

## Categories
- Tradeskill & Economy
- Professions

## External URLs
None (first release to CurseForge)

## Installation Notes
1. Extract to WoW AddOns folder
2. Restart WoW or /reload
3. Type /hdg to open

No additional configuration needed!
