This is a mod to make swapping equipment easier through popout slot menus, equip slot buttons, gear sets and automated swaps.
ItemRackFu plugin by Gnarfoz:
http:www.wowinterface.com/downloads/info9162
ButtonFacade plugin by Romracer:
http:www.wowinterface.com/downloads/info9109
New in 2.23
- Set equips while casting will wait until casting ends. (For now this is just sets. Swapping invidual slots from a menu isn't delayed yet.)
- Buff/Mount and Stance events now have an option "Except in PVP instances" to ignore that event in BGs or arenas
- Added new option "Disable Alt+Click" to disable toggling auto queue on buttons
- Druid Tree of Life event fixed
New in 2.22
- Menus will stay open less (MouseIsOver checks for visibility also)
- /itemrack toggle accepts a second set to toggle between them (vs unequipping if one set given)
- Fixed taint issue with minimap button shine effect
- "Equip on choosing set" renamed "Equip in options" and equips individual slots as well as sets
- Added new option "Character sheet menus" to disable menus on mouseover of character sheet slots
New in 2.21
- Added new option "Equip on choosing set" to equip sets when choosing them in set tab
- Added new option "Set menu wrap" and slider to choose when to wrap the menu
- Behavior of Alt+left click vs right click of minimap button separated
- Added new option "Show minimap tooltips" to explain the crowded clicks (defaulted "On")
- Gear icon("Events running") on minimap button should appear regardless if you use a set button
- Mounted event will no longer equip while on a flight from a flight master
- Added Swimming, Druid Flight Form and Druid Swift Flight Form events
- Fixed nil error on set tooltip after deleting currently equipped set
New in 2.2
- Events!
Note for users of ItemRack prior to 2.2
- 2.2 adds a new file that won't be recognized if you update while in game. Make sure you exit the game before installing this update.
Notes for ItemRack 1.9x users
- All your sets and events from 1.9x will need to be rebuilt. The changes are too drastic to carry over.
- Before installing this update, you can delete the old ItemRack folder to get rid of 1.9 files no longer used, but it's not necessary.
- With the return of events, ItemRack 2.2+ becomes the only "official" version that will be supported if a patch breaks it. 1.9x will no longer be supported (not like there was a lot anyway). If anyone wants to carry on a fork of 1.9x you're more than welcome.
Some benefits to 2.x over 1.9x:
- The bar is now separated into buttons, independantly moveable and dockable to each other.
- Sets are built without equipping items, allowing changes even to banked sets.
- A TrinketMenu-like Auto Queue for every slot. (This mod can do everything TrinketMenu does, there's no need to run ItemRack and TrinketMenu together)
- The GUI is load on demand so you only have to suffer my XML OCD at need.
- Events are a lot easier to create for the most common types. No scripting required for most events (but you can continue to script them if you want).
- No taint, better performance, less memory than 1.9x.
Quick Start Guide
Minimap button:
- Right-click the minimap button to open options or create sets
- Left-click the minimap button to choose a set
- Shift-click the minimap button to unequip the last set equipped
- Alt-click the minimap button to toggle events on/off
Dockable buttons:
- Alt+click slots on the character sheet to create/remove buttons
- Alt+click yourself in the character sheet to create/remove a set button
- Alt+click the created buttons to toggle their auto-queue status
- Shift+drag buttons to break them apart if they're docked to each other
- Drag the menu's border around to dock it to a different side of buttons
- Right-click the menu's border to rotate the menu
- Size, alpha, spacing, etc are in options
Creating/equipping sets:
- You create sets in the Sets tab after right-clicking the minimap button
- Select slots for the set, choose a name and icon and click Save
- Once a set is saved, there are several ways to equip it:
1. Left-click the minimap button and choose the set
2. Mouseover a set button you've created (Alt+click yourself in character sheet)
3. Use a key binding you define in the set ("Bind Key" button)
4. In macros with /itemrack equip setname
5. In events or scripts that use EquipSet("setname")
Popout menus:
- Click an item or set in a menu to equip it
- Shift+click a set in a menu to unequip it
- Alt+click an item in a menu to hide/unhide it
- Hold Alt as you mouseover a slot to show all hidden items
While at a bank:
- Items/sets in the bank have a blue border.
- Selecting an item or set that's in the bank will pull it from the bank to your bags.
- Selecting an item or set that's not in the bank will attempt to put it all into the bank.
Slash Commands
/itemrack : list the most common slash commands
/itemrack opt : summon the options GUI
/itemrack equip setname : equips a set
/itemrack reset : resets buttons
/itemrack reset everything : wipes all settings, sets and events
/itemrack lock/unlock : locks and unlocks the buttons
/itemrack toggle set name[, second set name] : equips/unequips "set name" (or swaps between two sets if a second set given)
Macro Functions
EquipSet("setname") equips "setname"
UnequipSet("setname") unequips "setname"
ToggleSet("setname") toggles (equips then unequips) "setname"
IsSetEquipped("setname") returns true if "setname" is equipped
In the unlikely event that another mod (or default UI in the future) uses these function names, you can use their long version ItemRack.EquipSet(), ItemRack.UnequipSet(), etc. This mod only commandeers the shortened names if they appear to be unused.
Events
2.2 (re)introduces events. These are scripts to automatically equip and unequip gear as things happen in game.
To use an event:
1. In the 'Sets' tab, create or make sure you have a set you'd like to equip when the event happens.
2. In the 'Events' tab, click the red ? icon beside the event you want to use.
3. Choose the set for this event.
4. Ensure the event has a check beside it.
As events are enabled, a separate process watches for those events and equips (and unequips if chosen) as they happen.
If you want to create or edit an event, there are four types of events:
- Buff: These events equip gear as you gain buffs. ie, Evocation, Drinking and being on a mount.
- Stance: These events equip gear when you change stances or forms. ie, Battle Stance, Moonkin Form, Shadowform
- Zone: These events equip gear when you're in one of a list of zones. ie, the PVP event includes all arena and BG maps.
- Script: For those with lua knowledge, you can create your own event based on a game event. A couple examples are in the default events.
When dealing with events, it's good to keep some things in mind:
- You'll get the most predictable behavior by having sets that don't overlap. If you're a warrior with a Tanking, DPS and PVP set, consider not including weapons in those sets. If you decide to make an event to swap in a 2H when you go into Berserker Stance and a 1h+shield when you go into Defensive Stance, you won't step on the toes of events that swap in PVP gear in a BG/arena or a tuxedo in a city.
- A gold gear icon on the minimap button (and on the sets button if you've created one) means that events are enabled. If you decide you want to temporarily shut down all events, Alt+click the minimap button or the sets button. (You can disable events in options also)
- For non-English users, you might want to edit the events that have English text within them. I try to keep it locale-independant when possible (ie, warrior and most druid stances use the numbers instead of names), but you'll never enter "Stormwind City" on a deDE client for the city event.
- Script Events do not have a "set" defined to them like other events do. They need to EquipSet("setname") explicitly. Its set button will always be the macro keys icon.
- Advanced users of 1.9x may notice the lack of a delay option in scripted events. I've decided to pull this down into the scripting system to streamline the event process. For now, you can use ItemRack.CreateTimer and ItemRack.StartTimer defined in ItemRack.lua.
Future plans
- Move back to an associated set icon for script events
- Possible option of flags for less "persistent" events (only equip if specific state changes)
- Tighter integration/use of EquipItemByName for unique slots
- Moving options to the default UI's new option panels
- Dynamically reordering gear swaps to handle unique-equipped gems in different sets
- Supporting the existing ItemRackFu and TitanFu plugins if possible
- Native ButtonFacade support
- Possibly adding a Combat Log event type
- A set button to sit to the left of weapon slot since the character model isn't an intuitive "button"
- Moving slot key bindings back to default key binding interface
Version that's been at wowinterface.com
All updates will be at http://www.wowinterface.com/downloads/info4148-ItemRack.html
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
