This is a mod to make swapping equipment easier through popout slot menus, equip slot buttons, gear sets and automated swaps.
__ 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.
__ New in 2.87 - By Kharthus __
* New option for Hide the ItemRack buttons during pet battles
__ New in 2.86 - By Kharthus __
* Hide the ItemRack buttons during pet battles
__ New in 2.85 - By Kharthus __
* TOC update for 5.2 patch
__ New in 2.84 - By Kharthus __
* Fixed Monk off-hands
__ New in 2.83 - By Kharthus __
* TOC update for 5.1 patch
__ New in 2.82 - By Kharthus __
* Fixed dual spec events
__ New in 2.81 - By Kharthus __
* Attempt to fix GlyphUI problem
__ New in 2.8 - By Kharthus __
* Updates for MoP
- Change log up to this version removed from hosting site and archived in Change Log.txt
Originally posted by Gello Try resaving the set associated with the evocation event.
Hmmm... that didn't help either. If it matters, I don't have a lot of other mods loaded - just:
ct raid assist
ct boss mods
damage meters
decursive
item rack
I tried completely removing the prior version, by the way - before installing 1.95. (I also deleted my WTF and WDB folders.)
Originally posted by Gello I'll look into it tonight. Thanks!
Thanks so much - itemrack is an absolutely essential mod for me - I use it constantly!
If you need me to try anything else, or need further info from me, just let me know. For what it's worth, me and a guildie who both use itemrack have basically the same gear we're trying to swap during evocation:
normal set: (3 slots)
mageblade
offhand
wand with +frost
evocation set: (2 slots)
staff with a ton of spirit
glowstar rod of spirit (wand)
I found the problem with the evocation event. It was using the SPELLCAST_STOP event which prior to 1.10 was fired at the start and end of channeling spells. Now it only fires at the start.
If you change the trigger to PLAYER_AURAS_CHANGED it will work. You can probably change the delay to 0 also if you want for a more immediate swap which is safer with PLAYER_AURAS_CHANGED.
Hi gello, i have one question:P Although i've been using itemrack since its first release version, i never came in need of the following thing before:
Is there any way, to create a set that will have no icon (in other words when i equip that specifc set, it will not change previous set's icon). For example: I played a bit with the trinket switching events depending on cooldowns, as found in the itemrack events thread and i created the corresponding sets with the trinkets i want to be equiped. What i want, is when those sets "fire up" to not to affect my current set's icon, mostly for cosmetic purposes:P
My apologies for not posting this in the associated thread in the released forum, I simply cannot locate it. I found your thread on events, but not the actual mod.
In any event.
I'm currently digging around in EngBags (formerly EngInventory, now with banking) and trying to figure out a better method of defining sorting. While doing this, I've noticed that itemrack and engbags are trying to do some similiar work, and I wondered, briefly, if there would ever be a "bank this set" or "unbank this set" option? **So there's the evil feature request**
Having it neatly deliminate new sets as custom sorts in EngBag is something I'll be playing with on my own. **If I find a good way to do this, I'll toss the code your way and towards the current maintainer of EngBags. It's enough of a headache that I wouldn't ask for it**
I suppose the third question would be -- where is the right thread for this type of discussion?
2.0 will definitely handle bank sets. In the popup menu when you're at a bank, items and sets that are in the bank have a blue border. Selecting those items will swap them from bank to your bags. Also each menu (including sets) has a bank menu item (blue-bordered empty slot). If you click the empty bank slot and then an item or set, it will swap the item or set to bank. The code for this part is pretty much done. I still think clicking the empty slot and then the item/set is kind of awkward, so that may change.
Previously I tried to incorporate worn gear into the bank/unbank bit but it just complicated things so I tore it out and redid it with the above simpler approach.
The final bank method is a lot easier now. While the bank is open:
- Items and sets in bank have a blue border.
- Click a banked item or set in the menu to pull it from bank to bags.
- Click an unbanked item or set (worn or in menu) to bank it.