Overview Overview Search Search Up Up
Download details
ItemRack ItemRack HOT
(3 votes)

This is a mod to make swapping equipment easier.  You add equipment slots to a bar and mouseover on the bar will create a menu of all items in your bags that can go in that slot.

__ Setup __

Initially the ItemRack is empty.  You choose which armor slots to add to the bar with Alt+Click:

1. Open your character window ('C' is the default key)
2. Alt+Click equipment slots to the bar.  For instance: Alt+Click your helm to add the head slot to ItemRack.  Alt+Click it again to remove it.  You can add as many equipment slot as you want.
3. That's it really.  Mouseover that item and if any other item can go in that slot it will display it in a menu.

__ Customizing Display __

You move the window by dragging the black border of the bar.
You resize/scale the window by dragging the "grip" in the lower right corner of the bar.
You rotate the window by clicking the "rotate" button on the edge of the bar.

Once you have the bar positioned where you like, you can hit the "lock" button on the edge of the bar.  The buttons on the edge will disappear and the window cannot be moved.  However you can still add/remove items when the bar is locked.

To unlock the bar, hold Alt while you mouseover the bar.  The lock and option buttons will return.

__ Useage __

Mouseover an item in the bar and a menu will pop up of all items in your bags that can go in that slot.  Click the item in the menu and it will swap.

If an equipped item can be used, clicking the item on the bar (or its key binding) will use the item.

Default behavior is to only show Soulbound items in the menu.  You can turn this off in options, accessed by a button on the edge of the bar. (Hold Alt down if the bar is locked to get to the options button)

__ Sets __

To start making sets, left-click the ItemRack minimap button:
- Any slots on the rack are automatically marked active and will be highlighted.
- Darkened slots will not save with the set.
- You can toggle whether a slot will be active by clicking the slot.
- You can swap gear to active slots the same as you do from the rack. (mouseover menu)
- ALT+click works in the set builder same as character panel.
- You can save an unlimited number of sets, but only 30 max will show on the menu.
- Sets will not queue during death or combat (yet)
- Sets are saved per-character

To equip a set, there are three ways:
1. Add the Set "slot" to the rack by alt+clicking yourself in the character window. (or alt+click the set icon in the set builder).  Now you can swap sets the same as you swap individual items.  Mouseover the "Set" slot and it will display your saved sets to swap to.
2. Bind a key from the set builder.  Up to 10 sets (per character) can be directly bound to a key.  After you've saved a set, click 'Bind Key' and then choose a key to bind to the set.  You do not need to create any macros or action buttons.  Just hit the key to equip that set.
3. Make a macro.  In some cases you may want to situationally equip a set.  To do so in a macro, use /script EquipSet("setname").  For instance: /script if UnitClass("target")=="Priest" then EquipSet("1h+shield") end.

__ Events __

In the options window when you right-click the minimap button are three tabs.  All event setup is done in the Events tab.

Events are disabled initially.  To begin using events you need to enable it with the "Enable Events" checkbox at the top of the Events tab.  This is the "master switch".  You can set up a key binding to toggle all events on or off as well.

In that tab you'll see a list of events with a red question mark beside it.  Click the question mark to choose what set to equip for the event.  When you've chosen a set it will be enabled.  You won't be able to enable an event until you've associated a set for it. (even if the event script doesn't rely on a defined script)

To disable/enable a set with an associated event, uncheck the event.  Alternately, you can click Delete to remove the set association and have it drop down to the bottom of the list.

Deleting an event not associated with a set will completely remove it if no other characters use that event.

See events manual.txt for more information on creating/editing events.

There are two events this mod uses you won't find in the wiki:
ITEMRACK_NOTIFY : arg1 is the name of the item who's cooldown has finished
ITEMRACK_ITEMUSED : arg1 is the name of the item, arg2 is the slot that was used

__ Queued Items __

We can't swap non-weapon items when we're dead or in combat.  If you attempt to swap in either of these conditions, ItemRack will "queue" the items for immediate swap once you leave combat or return to life.

- The queued item will appear as a small inset into the slot it's going to.
- If you want to unqueue an item, reselect it again.
- If you want to queue the item to another slot (ie, ring from one finger to the other), select it for the other slot.
- The 'queue' is only one-item deep.  Meaning, once a queued item is equipped that queue is emptied.
- Selecting a series of items for a slot will only change the queued item.  It won't set up an order to them.
- You can queue as many armor slots as you want.  For instance if a druid is corpse camping you and you're paranoid enough to have a suit of Nature Resist gear in your bags, you can queue up the whole suit and it will swap in on revive.

In 1.7 you can now queue sets with these important notes:
- Empty slots in a set will not queue.
- If you are wearing an item that wants to go elsewhere in the queued set, that item will not be queued.
- Weapons never need to queue in combat, but will not queue in death either.
- To unqueue a set you've queued, select the set again.
- Queued sets will not show an inset in the set icon.  That set icon gets a lot of business and its sole purpose is to say what the previous equipped set was.  Don't attribute any other meaning to it.

__ Misc __

- You can directly Alt+Click the slot on the ItemRack to remove it.
- You can Alt+Click items or sets on the menu to hide/reveal them. (hold Alt down while you open the menu to see hidden items/sets)
- There are three buttons on the end of the ItemRack.  These are: Rotate, Lock and Options.
- Hold Alt while you moveover a locked bar to get at the lock/options buttons.
- In Options you can toggle things such as numbered cooldowns and whether to display only soulbound items.
- Key bindings are tied to the armor slot, not its placement on the bar.  For instance if you bind CTRL+H to 'Use Helm Item', CTRL+H will use the helm no matter where it exists on the bar.
- An item doesn't need to be on the bar to use its key binding.
- If the control buttons seem to disappear on you when moving the bar, check the other end of the bar.  ItemRack tries at all times to keep everything on the screen, and will rearrange parts of itself to accomplish this.
- In options you can prevent the menu from popping up unless Shift is down.
- If you lose the window or shrink it too much, "/itemrack reset" will restore the bar to default placement/size.
- The settings in the options window are global.  They will affect all characters.  Bar placement/size and contents are per-character.
- 'Notify When Ready' opetion will only notify for items you use or attempt to use in a session.
- Notifications will not be sent if the bar is off the screen.
- If TrinketMenu Mode is enabled and you have the top trinket and bottom trinket together on the bar, it will add spacers around them as needed.  A more flexible spacing method will be added in the future.
- To add a spacer after an item on the bar, while it's unlocked Alt+right click the item (temporary solution)

__ Future Plans __

- Swap gear from/to bank
- Items of same name with different enchants recognized
- Ability to break bar into pieces and independently rotate/scale/dock
- Separate mod into three modules: bar, sets, events

__ Plugin support __

1.8 of ItemRack adds a function TitanPanel, Infobar or any mod can use to work with ItemRack.  I had intended to make a Titan plugin for 1.8, but due to the disenchant issue this version has been rushed to post. (and not to mention there are tons of people who can make Titan plugins better than I can)  The function is: ItemRack_UpdatePlugins

When the bar is updated, ItemRack checks if this function exists, and if so it calls the function with these parameters:


At any time you can query sets by calling:

table_of_sets, current_set_name, current_set_texture = ItemRack_GetUserSets()

The table is structured as:

table_of_all_sets = {
["First set name"] = {
[slotid] = "Item name", -- slotid is 0-19, the inventory slot id
[slotid] = "Item name",
[slotid] = "Item name",
["icon"] = "InterfaceIconsIcon_Path", -- the texture used for the set
["hide"] = 1 or nil -- whether the set is hidden on mouseover of the bar
["Second set name"] = {
[slotid] = "Item name", -- slotid is 0-19, the inventory slot id
[slotid] = "Item name",
[slotid] = "Item name",
["icon"] = "InterfaceIconsIcon_Path", -- the texture used for the set
["hide"] = 1 or nil -- whether the set is hidden on mouseover of the bar

Only slot ids that are in a set are in a set's table.  Empty slots are "(empty)".

__ FAQ __

Q: I have problems with the mount event.
A: If you have a recent Titan Panel installed, it includes a Titan Rider plugin that automatically swaps gear.  It will make a mess if both are running at once.  Disable one or the other.

Q: How do I move the minimap button?
A: Drag it like you would an ordinary window.

Q: Can I use this to swap weapons?
A: Yes you can do it several ways.  You can manually swap them directly on the bar or you can create a set for each weapon configuration.

Q: What about just swapping main-hand to right-hand?
A: For a specific swap like that just use: /script PickupInventoryItem(16) PickupInventoryItem(17), but as an example of using this mod in a macro: Create two sets, one named "Before" and another named "After".  Then create this macro:
/script if MainOffSwap then EquipSet("Before") MainOffSwap=false else EquipSet("After") MainOffSwap=true end

Q: Localization?
A: This should work on all clients except range and ammo slots need localized.  See the localization.lua for details.

Q: Can I add my own icon to use for sets?
A: Sure.  Make a 64x64 32-bit TGA and drop it in your InterfaceIcons folder.  The icon will appear in the list of available icons.  For in-game icons, see the end of localization.lua.

Q: I locked the window but want to unlock it now to move/resize/rotate it.  How do I unlock with the lock button gone?
A: You can unlock via the lock in the upper right of the options window.  Or hold ALT while you mouseover the bar and the control buttons will return.

Q: I made a set containing just the carrot.  But my other characters don't see this set.
A: With rare exceptions (ie, carrot) various characters on an account rarely have the same gear.  So sets are stored separately per-character.

Q: What is the minimap icon supposed to be?
A: It's a weapon rack next to a crate. :P  But yeah it's awful and needs a new picture.

Q: Are there any slash commands?
A: A few, none of which are necessary to use the mod:
/itemrack : toggle the bar on/off
/itemrack reset : restore the window placement to a default state
/itemrack reset events : restore the events to their default
/itemrack reset everything : display a popup confirmation to reset sets, events, settings to default
/itemrack lock or unlock : toggles the lock to prevent moving/resizing the bar
/itemrack scale (number) : manually set scale to an exact number (0 to 1)
/itemrack opt : toggle the options window
/itemrack equip (set name) : equips a set
/itemrack debug : display a list of currently registered events


Size110.09 KB
Created bySuper User
Changed bySuper User