Hi friends,
I wanted to introduce you to
Wardrobe9, an Automated Wardrobe Management addon for GearSwap.
NOTE: Ver 2.0 now released (May 5, 2026)
Tired of manually shuffling gear between bags every time you switch jobs? Wardrobes completely full and still want to gear new jobs on your character?
Wardrobe9 is a Windower 4 addon that reads your GearSwap Lua files, figures out what gear you need, checks if it's in your wardrobes, and moves it there automatically.
Put simply,
Wardrobe9 makes sure the gear referenced in your Lua files is actually in your wardrobes — and fixes it automatically when it isn't.
How It Works
Wardrobe9 provides a visual UI inside your Mog House with a simple three-step workflow:
SCAN — Builds a complete list of every item you own across all bags, and finds your GearSwap Lua files.
PLAN — You select your Lua files (populated from the Gearswap DATA folder) and Wardrobe9 compares every gear reference against your wardrobes. You'll see exactly what's present, what's missing, and what needs to move.
SWAP or FILL — Automatically moves your gear using the mode that suits you.
Two Execution Modes
After planning, you choose how Wardrobe9 handles the moves:
SWAP — Prioritises swapping out an unused item of the same equipment type (ring-for-ring, body-for-body, etc.) to make room. Falls back to free slots if nothing to swap. This is ideal for people with full wardrobes who set specific geartypes to specific wardrobes (i.e. All headpieces in wardrobe2, etc.)
FILL — Prioritises filling empty wardrobe slots first. Only evicts an unused same-type item if no free space remains.
Validation Tools (New in 2.0)
After scanning and selecting your Lua files, two validation buttons are available:
VAL MISS — Shows every item referenced in your selected Luas that isn't currently in your wardrobes. Results are split into items missing entirely (not found in any bag) and items found in other bags but not yet in a wardrobe.
VAL UNUSED — Shows every item sitting in your wardrobes that isn't referenced by any of your selected Luas. Great for identifying gear you can safely move out to free up wardrobe space.
Select multiple Lua files at once to validate across all your jobs in a single pass.
Features
Reads your selected GearSwap Luas and extracts every gear reference from your sets, including augmented items.
Scans all bags and wardrobes (Wardrobe 1–8, Safe, Safe 2, Storage, Locker, Satchel, Sack, Case).
Clearly reports what's already in wardrobes, what's found elsewhere, and what's missing entirely.
Moves are always planned first and shown to you before anything is executed.
Validate missing gear across one or multiple job Luas at once.
Identify unused wardrobe items to reclaim space.
Configuration
Everything is configurable in the
w9_config.lua file. It will allow you to:
Change the default position of the user interface on load.
Lock specific items so they're never moved (Warp Ring, Echad Ring, etc. are locked by default).
Protect entire equipment categories from being swapped out (weapons are protected by default).
Exclude source bags — your Inventory is excluded by default so Wardrobe9 never touches it.
Choose which wardrobes (1–8) are eligible destinations.
Set the return bag priority for evicted items (Safe, Storage, Locker, etc.).
Define custom gear variables (ex. WAR_AF_HEAD) to ensure gear with custom variables in your Lua isn't missed.
Important Notes
The UI is only available inside your Mog House. It appears automatically when you zone in and hides when you leave.
By default, weapons and items in your Inventory are not moved. This is intentional. You can change it in the config if you want.
If you are in Windowed mode: Button positions may appear slightly offset from their click targets. This appears to be a Windower 4 platform limitation (due to texts). Borderless Windowed or Fullscreen is recommended.
If your cursor appears behind the addon: This is typically caused by the Hardware Mouse setting being disabled in Windower. Enabling this in the Windower launcher settings is recommended.
Why?
If you play multiple jobs on one character, you know the pain. Full wardrobes, gear scattered across bags, and no easy way to move necessary gear from your bags into your wardrobes. Wardrobe9 connects your GearSwap files directly to your storage and handles moving everything for you.
What's New in 2.0?
An entirely updated User Interface :)
VAL MISS — Validate your selected Luas for missing gear across all bags.
VAL UNUSED — Identify unused items in your wardrobes that aren't referenced by any selected Lua.
Bug fix: Fixed an error where in some circumstances augmented gear inside nested GearSwap set tables were not being extracted during planning and validation.
Cheers!
Screenshots of VER 2.0
SCAN being used
PLAN being used -
Identifying missing items + augment mismatch identification
PLAN being used Pt2 -
proposed movements upon using SWAP or FILL
FILL being executed
VAL:MISS being used
VAL:UNUSED being used
