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
The new feature to not interrupt spell casting works fine if you are swapping sets from the menu, but doesn't work when a set swaps automatically when it's triggered by an event. It doesn't interrupt the spell anymore, but it also doesn't complete the swap when the spell is finished.
Since the last patch did something to equipment switching, if I'm on my mount, i have a riding crop and want to mine a node, when I right click the node I start to mine but when the trinket gets switched out, I get interrupted. I have a different addon doing the switching. Is there any way to use itemrack for the switching and delay the trinket switch if I'm mining, or such?
My mini-map button seems to be stuck on whatever set I have equipped when I log in. Changing sets results in the gear changing but not the mini-map button.
Anyone else? I am running a lot of mods so I'm sure there's the possibility of something interfering but I wanted to check and see if anyone knew of any "likely culprits".
aah, that makes sense i suppose, but i'm one of those guys who knows exactly what is in his bags and exactly where each item is so for me it's faster to just hit B then right-click the item i want equipped.
ps - i love this new version (i upgraded from 1.9)! it just seems cleaner and faster all around. /salute
Quote:
Originally posted by Gello They're for swapping individual slots on the fly. So if you're in a heroic and want to equip a pvp trinket without digging through your bags or equipping a full blown set, mouseover a trinket slot and click the pvp trinket in the menu and it will equip it.
im still not even sure what those menus or boxes or whatever they are actually do... all the item sets are done via the Sets menu in /itemrack ui right?
They're for swapping individual slots on the fly. So if you're in a heroic and want to equip a pvp trinket without digging through your bags or equipping a full blown set, mouseover a trinket slot and click the pvp trinket in the menu and it will equip it.
You can create dockable buttons to do the same thing by alt+clicking the slots on the character sheet. I usually have buttons for my weapons, set and trinkets. Then I mouseover those to change them individually. If I need to change a tabard or something not related to a set I open the character sheet and swap something in from a menu there.
Originally posted by Gello
re changing stats on character sheet: This is doable now through the scripting:
Excellent, that's exactly what I wanted. And I think that the scripting method is easier all around. Thanks for the fast reply, and keep up the good work!
re menu on paperdoll: next update will have an option "Character sheet menus" which you can turn off.
excellent! thank you im still not even sure what those menus or boxes or whatever they are actually do... all the item sets are done via the Sets menu in /itemrack ui right?
re menu on paperdoll: next update will have an option "Character sheet menus" which you can turn off.
re changing stats on character sheet: This is doable now through the scripting:
Create a new event, type Script, with a trigger of UNIT_INVENTORY_CHANGED
in the script, enter:
Code:
if arg1=="player" then
local stats = {
["tanking"] = {"BASE_STATS","DEFENSES"},
["healing"] = {"MELEE_COMBAT","SPELL_COMBAT"},
["dps"] = {"BASE_STATS","MELEE_COMBAT"},
}
for k,v in pairs(stats) do
if IsSetEquipped(k) then
PLAYERSTAT_LEFTDROPDOWN_SELECTION = "PLAYERSTAT_"..v[1]
PLAYERSTAT_RIGHTDROPDOWN_SELECTION = "PLAYERSTAT_"..v[2]
end
end
end
Change "tanking" "healing" "dps" to whatever you named your sets, with the values in {}'s being which PLAYERSTAT_ you want to see. (first is left, second is right) You can add more sets too, just make sure to separate them by a comma and format it like the others.
It is an interesting idea, but I'm not sure it's something I'd want to explicitly squeeze into the crowded set-building UI.
the boxes that pop up when mousing over items on my paperdoll are interfering with me. i have tooltips at my cursor and these boxes that pop up when i mouse over things are in my way.
how can i disable itemrack from touching the paperdoll? i only want ot configure sets in teh itemrack config and never from the paperdoll.
Thanks for the fast reply, and keep up the good work!
Paperdoll boxes >.>
