This is a mod to make swapping equipment easier through popout slot menus, equip slot buttons, gear sets and automated swaps.
__ New in 2.25 __
* Fix for Titan's Grip and dual spec
* Fix for Shaman's dual wield
* Updated .toc for 3.1
__ 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
Here's a version 2.25 of ItemRack that includes the prismatic gem fix. I can't take credit for the fix as I didn't write it; I just merely ported it to the new version of ItemRack.
This version also includes the nitro boot fix with the item queues:
Originally posted by uncaringbear Does the latest version of Itemrack address the problem of armor sets with Prismatic gems, or do we just keep on using the version put out by gergemaine (which did fix the problem)?
No, this update doesn't contain this fix. Just checked the source.
Does the latest version of Itemrack address the problem of armor sets with Prismatic gems, or do we just keep on using the version put out by gergemaine (which did fix the problem)?
There's an error with the ammo slot and 3.1. I'll post the message when I get home.
Date: 2009-04-17 18:04:09
ID: 2
Error occured in: Global
Count: 1
Message: ..\FrameXML\PaperDollFrame.lua line 1202:
attempt to index local 'self' (a nil value)
Debug:
[C]: ?
..\FrameXML\PaperDollFrame.lua:1202: oldCharacterAmmoSlot_OnClick()
ItemRack\ItemRackButtons.lua:92:
ItemRack\ItemRackButtons.lua:87
I'm really glad Outfitter stopped production for awhile, because I then discovered Itemrack. It is FAR better than that other one ever was. Excellent UI, very intuitive, very functional, more attractive. Back when I still worked in an office, I worked for a computer GUI company, so my opinion comes from professional experience.
Originally posted by azmodanrom VERY good idea.
a lot of times i sold / put in bank an item thinking i no longer need it, but it was used for some offspec build :/
Originally posted by elvindiva I have used Closet gnome, outfitter and ItemRack. I must say Itemrack tops them all. Would it be possible to add a feature to list the set name in the tooltip of the item when you mouse over it?
It would help prevent selling gear that is part of a set thinking it was something you picked up as a quest award that you planned on cashing in.
Thank you
VERY good idea.
a lot of times i sold / put in bank an item thinking i no longer need it, but it was used for some offspec build :/
I have used Closet gnome, outfitter and ItemRack. I must say Itemrack tops them all. Would it be possible to add a feature to list the set name in the tooltip of the item when you mouse over it?
It would help prevent selling gear that is part of a set thinking it was something you picked up as a quest award that you planned on cashing in.
Coming over from Outfitter after this whole addon policy change.
Outfitter had a few triggers for changing outfits that IR doesn't seem to have by default (and I don't know enough LUA to write a script for):
-When a player joins/leaves a group
-When a player starts looking for fish (so you can swap to fishing gear)
-When health drops below a certain level
-When the player starts eating or drinking
. . . and I personally liked clicking to open stuff like showing the other options for a slot, rather than hovering. Hovering can be a bit of a pain especially when tooltips are involved. Things disappear too easily & quickly.
Originally posted by gergemaine I've created a fix for the Dragon's eye unique(3) problem in Itemrack, but I need people to test it out.
If you do have prismatic gems equipped, it will take a fraction of a second longer to swap out your gear because it dequips the items with prismatic gems first. After swapping out your gear it will take another fraction of a second extra as it will attempt to move the dequipped items into the correct bag slots as to avoid cluttering up your bag.
You can download it at http://www.aenigma-guild.com/software/ItemRack_JC.zip (this should replace your ItemRack directory. You still need the ItemRackOptions directory.) please back up your addons/savedvariables data before trying out my code. I provide it with good faith that it will work for you but there are no guarantees or warranties.
Please let me know via PM or post if this does or does not work for you. Thanks!
-Yume (Burning Legion)/Elucidate (Gnomeregan)
Thank you so much for making this version for us JC'ers. So far, it seems to work just fine. The additional slight delay is not a problem.
