# 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.5

**Live mode Apply button reliability**

- Apply now lights up correctly when you stage dye changes on decor that started with empty channels. Previously Apply stayed greyed with no visible cost on, for example, a fresh washbasin where you'd picked three owned dyes for three empty slots. Root cause: the old gate relied on a Blizzard API that returns 0 in the empty-fill scenario. The new gate compares your current picks against the channel state when you first clicked the decor.

- Apply now stays disabled when you preview a dye you don't actually own in your bags. Blizzard previews dyes regardless of inventory, so the world would briefly show the unowned color and Apply would silently revert to the original on commit. The new ownership check prevents the silent revert and waits until you pick up the missing dyes.

- After a successful Apply, the baseline refreshes to the just-committed state. Previously the baseline was frozen at the moment you first clicked the decor, so a sequence like "apply purple, then clear" wouldn't re-enable Apply for the clear.

**Cost preview**

- The "+N dyes" / "-N back" label next to Auto-save now derives from your slot picks instead of the same broken Blizzard API. Previously the label blanked out in the empty-fill scenario; now correctly shows "+3 dyes" for a three-channel fill. The Apply gate and the cost label always agree because they read from the same source.

**Channel picker**

- Each channel slot now shows the owned count of the assigned dye, matching the dye list above (for example, "Arcwine x3"). Picking a dye you don't own shows "--" and turns the name red so you can see the affordability issue at the slot row itself.

**Auto-save no longer creates blank snapshots**

- Hitting Apply after a "Clear all" used to autosave a blank loadout in the Saved Variants sidebar. Now skips the autosave when the commit is a full wipe, so the sidebar stays clean. Manual Snapshot button gets the same fix.

---

## 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.5

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

File DetailsDownloadInstall

Vamoose's Dye Studio v2.1.2

File Name

Supported Versions

File Details
Download Install