World of Warcraft - Item Rack v2.0 beta 1

World of Warcraft - Item Rack v2.0 beta 1

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.

__ New in 1.975 __

- Fix for drinking event

- Notifications will use default floating combat text if enabled

__ New in 1.974 __

- Changed toc (no need to download if you Load Out of Date and use 1.973. It was tested on PTR)

__ New in 1.973 __

- Fix for Evocation and Spirit Tap events causing errors on buff changes

- Evocation event will "unequip" when evocation ends

__ New in 1.972 __

- Fix for arg1 conflict errors

- Fix for potential bank swap error

__ New in 1.971 __

- Bank support for non-default banks

- Fix for druid/warrior forms in 1.12

__ New in 1.97 __

- Bank support

- New event: ITEMRACK_BUFFS_CHANGED (see readme.txt)

- Default events use ITEMRACK_BUFFS_CHANGED now

__ Banking __

1.97 introduces bank support to ItemRack. When the bank is open:

- Items and sets containing items in the bank have a blue border in the menu.

- Select a banked item or set from the menu to pull it into your bags, space permitting.

- Select an unbanked item or set from the menu to push it to the bank, space permitting.

Note: If you have two items of the same name in bank, it will bank/unbank them fine from the individual slot menus but it won't correctly reflect both their banked status until both are out/in bank. And grabbing sets with same names and different enchants will not be reliable yet. The cure for this is coming. It partly requires abandoning old sets which didn't store item id's which I'm not going to work around in 1.x since it will be moot soon.

__ 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.

-- more in the readme.txt and events manual.txt

Changelogs

1.974, 8/22/06, toc changed

1.973, 8/2/06, bugs fixed: changed evocation to ITEMRACK_BUFFS_CHANGED, changed Spirit Tab Begin arg1 to ItemRack.Buffs

1.972, 7/29/06, bug fixes: arg1 preserved through BuffsChanged, GetMouseFocus() could be nil in BAG_UPDATE

1.971, 7/28/06, bug fixes: changed BankFrame:IsVisible to a flag when bank open/closed, SPELLS_CHANGED events now PLAYER_AURAS_CHANGED for 1.12

1.97, 7/27/06, added: bank support, ITEMRACK_BUFFS_CHANGED

1.96, 4/20/06, bug fixed: 4606 error, checked if queue empty, changed: unequip will unequip whole set even if partial unequipped, reset events will nil .old itemid's in sets

1.95, 4/6/06, changes: IsSetEquipped "optimizations" removed, temporary events reverted to earlier versions, tooltip fix scaled back to one SetOwner, queuing a worn set clears queue for those slots, added: queued item insets to character sheet

1.94, 3/29/06, bug fix: menu not appearing on bar

1.93, 3/29/06, bug fixes: nil errors from tooltip changes, added: relic slot support

1.92, 3/20/06, bug fixes: attempted fix for arithmetic on string value error (can't reproduce)

1.91, 3/19/06, bug fixes: invalid key for 'next', couple nil errors, changed: mount event to old style, added: option ('Show set icon labels') to show/hide set labels, option ('Auto toggle sets') to auto toggle sets, shift on chosing set toggles set

1.9, 2/24/06, new EquipSet, enchants recognized, empty slots can be queued, events overhauled, more options

1.0, 8/31/05, initial release