# Vamoose's Dye Studio
**A dye companion for WoW Housing. Browse all 62 dyes by color, build custom palettes, plan your purchasing with target stocks, and dye decor live with a Blizzard-replacement picker.**
A standalone dye companion. No other addons required (Auctionator optional for Send-to-AH).
---
## What's New in v2.1.0
- The Canvas decor picker now has a Category dropdown above the list to narrow decor by Housing category.
- A new Scope filter at the top of the Canvas tab narrows the available dyes to a curated theme or one of your custom palettes. Default is "All Dyes".
- Saved loadouts for the selected decor appear as color chips below the channel pickers in the preview panel. Click a chip to apply that loadout.
- Each row in the Canvas decor picker now shows droplet icons for the decor's dye channels, plus a count badge for how many saved loadouts you have for that decor.
- The Canvas picker now lists every available dyeable decor, including ones you don't own.
- Saving the same color combination twice for one decor no longer creates a duplicate entry.
- The Clear button now resets all three channel pickers.
- Up to 10 saved loadouts per decor (the chip wall is a single row of 10 plus the "+" save tile).
---
## Features
### Dye Browser
Browse all 62 housing dyes with multiple ways to organize them.
- **Colors tab** — 12 hue-based families (Red, Orange, Yellow, Green, Teal, Blue, Purple, Pink, Brown, Grey, Black, White). Click a chip to filter; click "All" to see grouped sections.
- **Custom tab** — Your own saved palettes with side popout. Click any palette to filter; Edit mode lets you click dyes to add/remove. Import/export strings to share.
- **Theme tab** — 23 curated palettes (factions, classes, seasons).
- **Herbs tab** — Reverse-lookup which dyes each herb crafts into, with current AH prices per herb and stock counts.
- **Owned filter** — Title-row toggle shows only dyes in your inventory (bags + bank + reagent bank + warband).
- **Search** — Filter the dye list by name; works across all tabs.
- **Shift-click** any dye to search the Auction House by name.
### Stock Tab
Plan your dye purchasing across your full collection target rather than one dye at a time.
- **Per-color-group targets** — "Target 3 of every red dye" sets the floor for the whole group. Collapsible per-group sections show have, target, and need.
- **Per-dye overrides** — Want 10 Horde Red specifically? Override the group default; a small revert button lets you reset back to the group baseline.
- **Master +/-** — Bumps every group target up or down by 1 (shift+click for 10).
- **Two modes**:
- **Buy** — restock by buying finished dyes from the AH
- **Craft** — restock by buying herbs and crafting. The side panel shows the consolidated herb shopping list with each herb's cheapest unit price and total cost
- **One-click Restock-and-Send-to-AH** — Sends a shopping list to Auctionator (separate VDS-Dyes and VDS-Herbs lists per mode). Auctionator is optional. If it's not installed, the send button shows a prompt instead of erroring.
- **Cost rollups** — Top stat strip shows at-target, total, deficit, and cost. Bottom button shows total spend before you commit.
### Custom Palettes
Create, edit, and share color combinations.
- **Up to 20 palettes** with up to 20 dyes each
- **Auto-named when you create one** — "Palette 1", "Palette 2"... or type your own
- **Edit mode** — Click any dye in the main list to toggle membership. The dye chips above show the current contents
- **Import / Export** — Share palettes as encoded strings. The import dialog accepts the current `VDS:` format and the legacy `VDSR:` format from the beta
- **Rename / Delete / Export** buttons under the palette list
### Live Dye Mode
Replaces Blizzard's dye picker with VDS when you open a decor's dye slot.
- **Auto-open** — Toggle "Replace Blizzard's dye picker" in Config. On by default. The VDS window opens automatically inside the housing editor when you click a dye slot.
- **Per-slot focus** — The active slot has a gold border (matching the Canvas channel picker). Click any dye to apply to the focused slot.
- **Cost preview** — "+N dye(s) -N back" tracks Blizzard's dye-bottle costs as you preview changes.
- **Owned-only warnings** — Slot labels go red when you're previewing a dye you don't own.
- **Cancel / Apply** — Standard Blizzard flow. Apply commits, Cancel reverts to original.
### Canvas Tab
Preview dye combinations on a 3D decor model before applying them to a real decor.
- **Decor picker with category filter** — Category dropdown narrows the list to a Housing category (Furnishings, Walls, etc.)
- **Scope filter at the top** — Narrows the available dyes to a curated theme or one of your custom palettes; default is "All Dyes"
- **Available decor** — Lists every available dyeable decor, owned or unowned
- **Per-row channel droplets and loadout count** — Each picker row shows droplet icons for the decor's dye channels and a count badge for saved loadouts
- **Loadout chip wall** — Saved loadouts for the selected decor appear as color chips below the channel pickers in the preview panel. Click a chip to apply
- **Per-channel editor** — Pick a channel, pick a dye, see it on the model immediately
- **3D ModelScene preview** — Drag to orbit, scroll to zoom
- **Saved loadouts per decor** — Auto-named "Loadout 1", "Loadout 2"... or type your own. Saving the same combination twice no longer creates a duplicate. Up to 10 loadouts per decor
- **Save via the chip wall** — The "+" tile at the end of the loadout chip wall saves the current channel selections as a new loadout
- **Random / Clear** — Quick-action buttons under the channel editor. Random fills channels from the current Scope; Clear empties all three channels
- **Loadouts also appear in Live mode's gallery** — Live's Gallery view shows the same loadouts as 3D preview tiles with hover-X to delete
---
## Quick Start
Type **`/dyes`** or **`/vds`** to open the Dye Studio.
### Commands
- `/dyes` or `/vds` — Toggle Dye Studio
- `/vds debug` — Toggle debug logging
- `/vds minimap` — Toggle the minimap icon
- `/vds hardreset` — Wipe all VDS data (requires /reload)
### Pro Tips
- **Click a dye** to select it (detail strip shows below). **Shift-click** to search the AH by name.
- **Stock tab is the new shopping workflow.** The per-row cart count is gone; targets in the Stock tab drive the Restock-and-Send-to-AH flow.
- **Canvas right-click** clears the active channel. **Canvas left-click** applies the dye to the active channel.
- **Live mode** keeps the same window open inside Blizzard's housing editor.
- **Custom palettes** — Click "+ New" and press Enter to accept the auto-name. Click "Edit" to start clicking dyes to add or remove.
- **Help button (?)** in the title bar shows the full feature guide.
- **Minimap button** — Click to toggle the studio, drag to reposition. Hide it with `/vds minimap` or the Config toggle.
---
## Installation
1. Download from CurseForge (or extract to `World of Warcraft/_retail_/Interface/AddOns/`)
2. Folder must be named `VamoosesDyeStudio`
3. `/reload` in-game
4. Type `/dyes` to open
---
## Requirements
- World of Warcraft: Midnight (12.0.0+)
- Access to Housing (level requirement)
---
## More Addons by Vamoose
---
## Support & Feedback
Found a bug or have a suggestion? Report it on our Discord.
---
**Author:** Vamoose
**Version:** 2.1.0
**Game Version:** 12.0.5 (Midnight)
---
*Keywords: dye, dyes, dyeing, color, colors, colour, colours, housing, house, decor, decoration, palette, palettes, theme, pigment, herb, herbs, crafting, restock, auction, auctionator, midnight, 12.0.5, blizzard replacement, dye picker, canvas, loadout, swatch, dye studio, vamoose*
