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

- Optional: [Auctionator](https://www.curseforge.com/wow/addons/auctionator) for Stock tab's Send-to-AH

---

## More Addons by Vamoose

- **[Vamoose's Housing Decor Guide](https://www.curseforge.com/wow/addons/housing-decor-guide)** — Track, craft, preview, and acquire all 1,700+ housing decorations across all professions

- **[Vamoose's Endeavors](https://www.curseforge.com/wow/addons/vamooses-endeavors)** — Housing endeavor tracker: tasks, XP, house level, coupons, cross-faction leaderboard

- **[Vamoose's Neighbors](https://www.curseforge.com/wow/addons/vamooses-neighbors)** — Neighborhood directory with plot owners, waypoints, and initiative tracking

- **[Vamoose's Companion](https://www.curseforge.com/wow/addons/vamooses-companions)** — A companion personality that reacts to your adventures with contextual commentary

- **[Vamoose's Pet Patrol](https://www.curseforge.com/wow/addons/vamooses-pet-patrol)** — Find uncollected wild battle pets in your current zone

- **[Vamoose's Guild Crafter](https://www.curseforge.com/wow/addons/vamooses-guild-crafter)** — Find which guildies can craft what you need

- **[LiteWQ](https://www.curseforge.com/wow/addons/litewq)** — Lightweight world quest tracker with reward icons, subzone rollup, and warband alt tracking

---

## Support & Feedback

Found a bug or have a suggestion? Report it on our Discord.

Discord: https://discord.gg/RWZaxJaHFP

Buy Me a Coffee: https://buymeacoffee.com/vamoose

---

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

Vamooses Dye Studio

LibDBIcon-1.0