[SIZE=6][B]Vamoose's Housing Decor Crafting Helper[/B][/SIZE]

[B]Your complete guide to crafting housing decorations in World of Warcraft![/B]

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

[HR][/HR]

[SIZE=5][B]✨ What's New in v1.6.0[/B][/SIZE]

[SIZE=4][B]🚀 Live API Integration[/B][/SIZE]
[LIST]
[*]Reagents fetched directly from WoW using [FONT=Courier New]C_TradeSkillUI[/FONT]
[*]Always accurate - auto-updates when Blizzard changes recipes
[*]No more incomplete material lists!
[*]Database reagents used as fallback
[/LIST]

[SIZE=4][B]🎨 Expansion-Themed Colors[/B][/SIZE]
[LIST]
[*]Shopping list items color-coded by expansion
[*]Materials inherit expansion colors from source recipes
[*]Easy visual identification at a glance
[*][COLOR=#999999]Classic: Gray[/COLOR] | [COLOR=#66B366]TBC: Green[/COLOR] | [COLOR=#6699CC]Wrath: Blue[/COLOR] | [COLOR=#CC7F33]Cataclysm: Orange[/COLOR]
[*][COLOR=#4DB380]MoP: Jade[/COLOR] | [COLOR=#B37F4D]WoD: Bronze[/COLOR] | [COLOR=#80E64D]Legion: Fel Green[/COLOR] | [COLOR=#CCB333]BfA: Gold[/COLOR]
[*][COLOR=#9966CC]Shadowlands: Purple[/COLOR] | [COLOR=#3399FF]Dragonflight: Blue[/COLOR] | [COLOR=#FF7F33]TWW: Orange[/COLOR]
[/LIST]

[SIZE=4][B]📦 Grouped Materials by Source[/B][/SIZE]
[LIST]
[*]Materials organized into collapsible categories:
[LIST]
[*][B]To Buy[/B] - Vendor items (💰 gold coin icon)
[*][B]To Gather[/B] - Mining, herbs, lumber (📜 map icon)
[*][B]To Craft[/B] - Intermediate components (⚙️ gears icon)
[*][B]Unknown[/B] - Uncategorized items (❓ question mark)
[/LIST]
[*]Click category headers to collapse/expand
[*]Sorted by expansion within each category
[*]State persists between sessions
[/LIST]

[SIZE=4][B]🎯 Professional UI Polish[/B][/SIZE]
[LIST]
[*]WoW-standard icons throughout (scrolls, books, broom, arrows)
[*]24x24 collapse arrows match UI conventions
[*]Clean, minimal design with smaller fonts
[*]Expansion colors make everything instantly recognizable
[/LIST]

[HR][/HR]

[SIZE=5][B]📋 Core Features[/B][/SIZE]

[SIZE=4][B]Recipe Tracking[/B][/SIZE]
[LIST]
[*]243 housing decoration recipes
[*]9 professions: Alchemy, Blacksmithing, Cooking, Enchanting, Engineering, Inscription, Jewelcrafting, Leatherworking, Tailoring
[*]Classic through The War Within expansion coverage
[*]Visual progress bars for each profession
[*]Recipe highlighting: [COLOR=#33FF33]Green = Known[/COLOR] | Dark = Unknown
[*]Overall crafting progress: [B]126/243 (52%)[/B]
[/LIST]

[SIZE=4][B]Smart Shopping Lists[/B][/SIZE]
[LIST]
[*]Add multiple recipes at once
[*]Auto-aggregates all materials needed
[*]Shows what you have vs. what you need
[*]Surplus tracking (e.g., "40/40+221" = have 261 total)
[*]Click items to remove from list
[*]Broom icon to clear entire list
[*]Expansion-colored backgrounds
[/LIST]

[SIZE=4][B]Lumber Tracking[/B][/SIZE]
[LIST]
[*]Dedicated section for all 11 lumber types
[*]Progress bars for each expansion's lumber
[*]Always visible in shopping panel
[*]Compact mode for focused farming sessions
[*]Track: Ironwood, Olemba, Coldwind, Ashwood, Bamboo, Shadowmoon, Fel-Touched, Darkpine, Arden, Dragonpine, Dornic Fir
[/LIST]

[SIZE=4][B]Trainer Locations[/B][/SIZE]
[LIST]
[*]Complete database of recipe trainers
[*]Coordinates for all trainer locations
[*]Organized by profession and expansion
[*]Easy navigation with tabbed interface
[/LIST]

[HR][/HR]

[SIZE=5][B]🎮 How to Use[/B][/SIZE]

[SIZE=4][B]Basic Workflow[/B][/SIZE]
[LIST=1]
[*]Type [FONT=Courier New]/hdg[/FONT] to open the addon
[*]Browse the [B]Recipes[/B] tab by profession
[*]Click recipes to add to your [B]Shopping List[/B]
[*]View [B]Materials Needed[/B] grouped by source (Buy/Gather/Craft)
[*]Check [B]Trainers[/B] tab for learning locations
[/LIST]

[SIZE=4][B]Compact Mode[/B][/SIZE]
Click the collapse button (top-right corner) to switch to lumber-only view - perfect for focused farming sessions!

[SIZE=4][B]Slash Commands[/B][/SIZE]
[LIST]
[*][FONT=Courier New]/hdg[/FONT] - Open addon
[*][FONT=Courier New]/hdg help[/FONT] - Show commands
[*][FONT=Courier New]/hdg reset[/FONT] - Reset window position
[/LIST]

[HR][/HR]

[SIZE=5][B]📊 Profession Coverage[/B][/SIZE]

[LIST]
[*][B]Alchemy:[/B] 17/23 (74%)
[*][B]Blacksmithing:[/B] 9/25 (36%)
[*][B]Cooking:[/B] 11/11 ([COLOR=#33FF33]100%[/COLOR])
[*][B]Enchanting:[/B] 9/23 (39%)
[*][B]Engineering:[/B] 7/25 (28%)
[*][B]Inscription:[/B] 50/62 (81%)
[*][B]Jewelcrafting:[/B] 5/25 (20%)
[*][B]Leatherworking:[/B] 10/24 (42%)
[*][B]Tailoring:[/B] 8/25 (32%)
[/LIST]

[B]Overall Progress:[/B] [COLOR=#FFFF00]126/243 (52%)[/COLOR]

[I]Note: More recipes are being added regularly as data becomes available.[/I]

[HR][/HR]

[SIZE=5][B]🔧 Technical Details[/B][/SIZE]

[LIST]
[*][B]File Size:[/B] 52KB
[*][B]Lines of Code:[/B] 3,539
[*][B]Game Version:[/B] The War Within (11.0.2)
[*][B]Performance:[/B] Lightweight, minimal memory footprint
[*][B]API Integration:[/B] Uses C_TradeSkillUI for live data
[/LIST]

[HR][/HR]

[SIZE=5][B]🐛 Bug Fixes in v1.6.0[/B][/SIZE]

[LIST]
[*]✅ [B]Materials panel clearing:[/B] Now clears properly when last item removed from shopping list
[*]✅ [B]Refresh timing:[/B] Removed conflicting delayed timers (0.1s, 0.5s, 1.0s, 2.0s)
[*]✅ [B]Lumber layout:[/B] Fixed 3-column alignment with centered progress bars
[*]✅ [B]Architecture:[/B] Decoupled refresh system prevents race conditions
[*]✅ [B]Code cleanup:[/B] Reduced RefreshMaterials from 193 to 113 lines
[/LIST]

[HR][/HR]

[SIZE=5][B]📦 Installation[/B][/SIZE]

[SIZE=4][B]First Time Install[/B][/SIZE]
[LIST=1]
[*]Download the latest version
[*]Extract to your [FONT=Courier New]World of Warcraft/_retail_/Interface/AddOns/[/FONT] folder
[*]Restart WoW or type [FONT=Courier New]/reload[/FONT]
[*]Type [FONT=Courier New]/hdg[/FONT] to open
[/LIST]

[SIZE=4][B]Upgrading from Previous Version[/B][/SIZE]
[LIST=1]
[*]Replace old addon files with new version
[*]Type [FONT=Courier New]/reload[/FONT] in-game
[*]Your shopping lists and settings are preserved
[/LIST]

[B]No additional configuration needed![/B]

[HR][/HR]

[SIZE=5][B]🙏 Credits & Support[/B][/SIZE]

Created by [B]Vamoose[/B] for the WoW housing decoration crafting community.

[SIZE=4][B]Found a Bug? Have a Suggestion?[/B][/SIZE]
Please report issues or feature requests in the comments below or open a ticket!

[SIZE=4][B]Special Thanks[/B][/SIZE]
To all the early testers and everyone who provided feedback during development!

[HR][/HR]

[SIZE=5][B]⚠️ Known Limitations[/B][/SIZE]

[LIST]
[*]Material categorization (To Buy/Gather/Craft) currently uses placeholder logic - all items show in "Unknown" category
[*]Categorization data will be added in a future update
[*]Recipe knowledge detection is still being refined
[*]Some features are in active development
[/LIST]

[HR][/HR]

[SIZE=5][B]🔮 Planned Features[/B][/SIZE]

[LIST]
[*]Complete material categorization (Buy/Gather/Craft)
[*]Additional recipe coverage
[*]Shopping list export
[*]Farming route suggestions
[*]More customization options
[/LIST]

[HR][/HR]

[SIZE=4][I]Happy crafting, and welcome home! 🏠[/I][/SIZE]
