vanilla-wow-addons – Blame information for rev 1

Subversion Repositories:
Rev:
Rev Author Line No. Line
1 office 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.
2  
3 __ New in 1.975 __
4 - Fix for drinking event
5 - Notifications will use default floating combat text if enabled
6 __ New in 1.974 __
7 - Changed toc (no need to download if you Load Out of Date and use 1.973. It was tested on PTR)
8 __ New in 1.973 __
9 - Fix for Evocation and Spirit Tap events causing errors on buff changes
10 - Evocation event will "unequip" when evocation ends
11 __ New in 1.972 __
12 - Fix for arg1 conflict errors
13 - Fix for potential bank swap error
14 __ New in 1.971 __
15 - Bank support for non-default banks
16 - Fix for druid/warrior forms in 1.12
17 __ New in 1.97 __
18 - Bank support
19 - New event: ITEMRACK_BUFFS_CHANGED (see readme.txt)
20 - Default events use ITEMRACK_BUFFS_CHANGED now
21  
22 __ Banking __
23  
24 1.97 introduces bank support to ItemRack. When the bank is open:
25 - Items and sets containing items in the bank have a blue border in the menu.
26 - Select a banked item or set from the menu to pull it into your bags, space permitting.
27 - Select an unbanked item or set from the menu to push it to the bank, space permitting.
28  
29 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.
30  
31 __ ITEMRACK_BUFFS_CHANGED __
32  
33 There are apparently a lot of people running multiple "buff" events, like innervate, drinking, evocation, spirit tap, etc. To optimize these events, instead of each event doing a loop of all buffs, all buffs are gathered into a table and an ITEMRACK_BUFFS_CHANGED event is fired with arg1 pointing to a table indexed by buff names and buff textures. To determine if a buff exists or not, replace loops like this:
34  
35 trigger: PLAYER_AURAS_CHANGED
36 local f
37 for i=1,24 do
38 f=f or UnitBuff("player",i)=="Interface\\Icons\\INV_Misc_QuestionMark"
39 end
40 if f then
41 EquipSet()
42 end
43  
44 With this:
45  
46 trigger: ITEMRACK_BUFFS_CHANGED
47 if arg1["Interface\\Icons\\INV_Misc_QuestionMark"] then
48 EquipSet()
49 end
50  
51 You can also use buff names too:
52  
53 if arg1["Innervate"] then
54 EquipSet()
55 end
56  
57 __ Setup __
58  
59 Initially the ItemRack is empty. You choose which armor slots to add to the bar with Alt+Click:
60  
61 1. Open your character window ('C' is the default key)
62 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.
63 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.
64  
65 __ Customizing Display __
66  
67 You move the window by dragging the black border of the bar.
68 You resize/scale the window by dragging the "grip" in the lower right corner of the bar.
69 You rotate the window by clicking the "rotate" button on the edge of the bar.
70  
71 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.
72  
73 To unlock the bar, hold Alt while you mouseover the bar. The lock and option buttons will return.
74  
75 __ Useage __
76  
77 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.
78  
79 If an equipped item can be used, clicking the item on the bar (or its key binding) will use the item.
80  
81 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)
82  
83 __ Sets __
84  
85 To start making sets, left-click the ItemRack minimap button:
86 - Any slots on the rack are automatically marked active and will be highlighted.
87 - Darkened slots will not save with the set.
88 - You can toggle whether a slot will be active by clicking the slot.
89 - You can swap gear to active slots the same as you do from the rack. (mouseover menu)
90 - ALT+click works in the set builder same as character panel.
91 - You can save an unlimited number of sets, but only 30 max will show on the menu.
92 - Sets will not queue during death or combat (yet)
93 - Sets are saved per-character
94  
95 To equip a set, there are three ways:
96 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.
97 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.
98 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.
99  
100 __ Events __
101  
102 In the options window when you right-click the minimap button are three tabs. All event setup is done in the Events tab.
103  
104 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.
105  
106 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)
107  
108 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.
109  
110 Deleting an event not associated with a set will completely remove it if no other characters use that event.
111  
112 See events manual.txt for more information on creating/editing events.
113  
114 There are two events this mod uses you won't find in the wiki:
115 ITEMRACK_NOTIFY : arg1 is the name of the item who's cooldown has finished
116 ITEMRACK_ITEMUSED : arg1 is the name of the item, arg2 is the slot that was used
117  
118 __ Queued Items __
119  
120 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.
121  
122 - The queued item will appear as a small inset into the slot it's going to.
123 - If you want to unqueue an item, reselect it again.
124 - If you want to queue the item to another slot (ie, ring from one finger to the other), select it for the other slot.
125 - The 'queue' is only one-item deep. Meaning, once a queued item is equipped that queue is emptied.
126 - Selecting a series of items for a slot will only change the queued item. It won't set up an order to them.
127 - 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.
128  
129 In 1.7 you can now queue sets with these important notes:
130 - Empty slots in a set will not queue.
131 - If you are wearing an item that wants to go elsewhere in the queued set, that item will not be queued.
132 - Weapons never need to queue in combat, but will not queue in death either.
133 - To unqueue a set you've queued, select the set again.
134 - 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.
135  
136 __ Misc __
137  
138 - You can directly Alt+Click the slot on the ItemRack to remove it.
139 - 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)
140 - There are three buttons on the end of the ItemRack. These are: Rotate, Lock and Options.
141 - Hold Alt while you moveover a locked bar to get at the lock/options buttons.
142 - In Options you can toggle things such as numbered cooldowns and whether to display only soulbound items.
143 - 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.
144 - An item doesn't need to be on the bar to use its key binding.
145 - 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.
146 - In options you can prevent the menu from popping up unless Shift is down.
147 - If you lose the window or shrink it too much, "/itemrack reset" will restore the bar to default placement/size.
148 - The settings in the options window are global. They will affect all characters. Bar placement/size and contents are per-character.
149 - 'Notify When Ready' opetion will only notify for items you use or attempt to use in a session.
150 - Notifications will not be sent if the bar is off the screen.
151 - 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.
152 - To add a spacer after an item on the bar, while it's unlocked Alt+right click the item (temporary solution)
153  
154 __ Future Plans __
155  
156 - Swap gear from/to bank
157 - Items of same name with different enchants recognized
158 - Ability to break bar into pieces and independently rotate/scale/dock
159 - Separate mod into three modules: bar, sets, events
160  
161 __ Plugin support __
162  
163 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
164  
165 When the bar is updated, ItemRack checks if this function exists, and if so it calls the function with these parameters:
166  
167 ItemRack_UpdatePlugins(current_set_name,current_set_texture)
168  
169 At any time you can query sets by calling:
170  
171 table_of_sets, current_set_name, current_set_texture = ItemRack_GetUserSets()
172  
173 The table is structured as:
174  
175 table_of_all_sets = {
176 ["First set name"] = {
177 [slotid] = "Item name", -- slotid is 0-19, the inventory slot id
178 [slotid] = "Item name",
179 [slotid] = "Item name",
180 ["icon"] = "Interface\Icons\Icon_Path", -- the texture used for the set
181 ["hide"] = 1 or nil -- whether the set is hidden on mouseover of the bar
182 }
183 ["Second set name"] = {
184 [slotid] = "Item name", -- slotid is 0-19, the inventory slot id
185 [slotid] = "Item name",
186 [slotid] = "Item name",
187 ["icon"] = "Interface\Icons\Icon_Path", -- the texture used for the set
188 ["hide"] = 1 or nil -- whether the set is hidden on mouseover of the bar
189 }
190 }
191  
192 Only slot ids that are in a set are in a set's table. Empty slots are "(empty)".
193  
194 __ FAQ __
195  
196 Q: I have problems with the mount event.
197 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.
198  
199 Q: How do I move the minimap button?
200 A: Drag it like you would an ordinary window.
201  
202 Q: Can I use this to swap weapons?
203 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.
204  
205 Q: What about just swapping main-hand to right-hand?
206 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:
207 /script if MainOffSwap then EquipSet("Before") MainOffSwap=false else EquipSet("After") MainOffSwap=true end
208  
209 Q: Localization?
210 A: This should work on all clients except range and ammo slots need localized. See the localization.lua for details.
211  
212 Q: Can I add my own icon to use for sets?
213 A: Sure. Make a 64x64 32-bit TGA and drop it in your Interface\Icons folder. The icon will appear in the list of available icons. For in-game icons, see the end of localization.lua.
214  
215 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?
216 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.
217  
218 Q: I made a set containing just the carrot. But my other characters don't see this set.
219 A: With rare exceptions (ie, carrot) various characters on an account rarely have the same gear. So sets are stored separately per-character.
220  
221 Q: What is the minimap icon supposed to be?
222 A: It's a weapon rack next to a crate. :P But yeah it's awful and needs a new picture.
223  
224 Q: Are there any slash commands?
225 A: A few, none of which are necessary to use the mod:
226 /itemrack : toggle the bar on/off
227 /itemrack reset : restore the window placement to a default state
228 /itemrack reset events : restore the events to their default
229 /itemrack reset everything : display a popup confirmation to reset sets, events, settings to default
230 /itemrack lock or unlock : toggles the lock to prevent moving/resizing the bar
231 /itemrack scale (number) : manually set scale to an exact number (0 to 1)
232 /itemrack opt : toggle the options window
233 /itemrack equip (set name) : equips a set
234 /itemrack debug : display a list of currently registered events
235  
236 Special thanks to Leelaa and Isakur for the German and Tinou for the French localization.
237  
238 1.974, 8/22/06, toc changed
239 1.973, 8/2/06, bugs fixed: changed evocation to ITEMRACK_BUFFS_CHANGED, changed Spirit Tab Begin arg1 to ItemRack.Buffs
240 1.972, 7/29/06, bug fixes: arg1 preserved through BuffsChanged, GetMouseFocus() could be nil in BAG_UPDATE
241 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
242 1.97, 7/27/06, added: bank support, ITEMRACK_BUFFS_CHANGED
243 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
244 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
245 1.94, 3/29/06, bug fix: menu not appearing on bar
246 1.93, 3/29/06, bug fixes: nil errors from tooltip changes, added: relic slot support
247 1.92, 3/20/06, bug fixes: attempt to fix arithmetic on string value 4706
248 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
249 1.9, 1/24/06, release of 1.891-1.897
250 1.897 (1.9 beta7) 2/24/06, bug fixed: queue jams (hopefully) gone for good, added: option to show/hide cloak/helm, AQ mount checks, changed: consolidated timers
251 1.896 (1.9 beta6) 2/21/06, bug fixed: new user and post-combat/death error
252 1.895 (1.9 beta5) 2/20/06, bug fixed: hide tradables fixed
253 1.894 (1.9 beta4) 2/19/06, changed: options to scrollable list, form events use IR_FORM global, combat/death queue redone to a single "set" instead of a full queue, alt+click on locked bar won't add/remove slots, one-hand won't show up in offhand for non-DW'ers, items clicked on cooldown won't appear to be used, added: square minimap, large cooldown, reset events
254 1.893 (1.9 beta3) 2/5/06, bug fixed: TrinketMenu Mode menu fixed if only trinkets on bar, added: Large font option for event script, changed: Event scripts overhauled for new EquipSet
255 1.892 (1.9 beta2) 1/29/06, bug fixed: non-standard bags recognized, old freespace code removed, 2h swaps on bar immediate move
256 1.891 (1.9 beta1) 1/28/06, changed: new EquipSet (enchants recognized), ^Requires dropped from "red" check, player-made events won't unregister on zoning, minimap button scaling fixed, /itemrack reset fixed
257 1.84, 1/20/06, bug fixed: menu update only checks MouseIsOver for plugin if it's installed
258 1.83, 1/19/06, added: titan support/docking, bug fixed: scroll wheel on lists, changed: checks for TitanRider enabled, events unregister/register on zoning
259 1.82, 1/16/06, changed: ALT+click/hide behavior made an option for all but sets (default off), bugs fixed: notify with no bar on screen should reliably fire, 2h->1h+offhand swaps will moved orphaned offhand to leftmost bag again
260 1.81, 1/14/06, bug fixed: Mount event
261 1.8, 1/12/06, added: IsSetEquipped(setname) returns true if all slots in a set are currently worn, error message when attempting to equip a set that doesn't exist, TitanPanel_ItemRackUpdate, note that events are suspended when set/event window up, bugs fixed: Disenchants/enchants/etc during gear swaps will abort the swap, Bloodvine will show up in menu on enUS clients, ammo count shows again, changed: initialization done in phases, removed cooldown boundry checks, tooltip scans changed to GetItemInfo, new events: Eating-Drinking, Low Mana, Skinning, Mage:Evocation, Priest:Spirit Tap Begin, Priest:Spirit Tap End
262 1.74, 1/8/06: bugs fixed: bags should work properly on deDE clients, set icon will remember last set when leaving an event, "Mount" event no longer disabled if TitanRider installed
263 1.73, 1/7/06: bugs fixed: Scrollbars enabled properly (the thumb will appear in 1.9.1 patch), Bindings saved using new SaveBindings, Soul Bags treated like quivers, ammo slot name lifted from tooltip for SaveSet, notify will happen if bar is off screen, changed: In TrinketMenu Mode, hold Shift to keep menu open on the bar, if any event uses ITEMRACK_NOTIFY trigger notify is automatically enabled, removed: check for TitanRider
264 1.72, 1/3/06: added: reset button added to options, bugs fixed: items used from action bars noticed by mod, users without SCT won't have notify messages "stick", scaling fixes for 1.9, removed scalebugfix (huzzah!)
265 1.71, 12/21/05: changed: inventory items used elsewhere in the UI reflects in the mod, arg1 and arg2 save on delayed events, added: ITEMRACK_ITEMUSED event (arg1=item name, arg2=item slot), Insignia Ready/Insignia Used events, examples for making scripts that swap on use, bugs fixed: added pink tiger to problem mounts
266 1.7, 12/8/05, added: events (see events manual.txt), sets queue, sets menu on minimap button, 30 second notify, French localization by Tinou, more slash commands (/itemrack help)
267 1.61, 11/02/05, bugs fixed: tooltip back to standard GameTooltip (should fix issues with Tipster, TipBuddy and other tooltip mods), set builder now updates properly when nothing on the bar
268 1.6, 10/31/05, bug fixed: error when items on notify queue are banked, "Container" in DE localized, added: menu pops up on character sheet, audible alert on notify, changed: ItemRack_CurrentSet made global
269 1.5, 10/5/05, bug fixed: pairs of items of same name with one worn swap, "Container" in German, added: Flip bar growth option, alt+click items in menu to hide them, changed: selecting set equips it
270 1.42, 10/2/05, bug fixed: two items of same name will swap in sets, key bindings in normal key binding window force to sets
271 1.41, 9/30/05, bug fixed: nil error on mouseover set icon
272 1.4, 9/30/05, added: sets, minimap button, /itemrack opt, help text, changed: using sharpening stones/poisons/enchants/etc will work on the bar, only wearable items will show in menu, options moved to a tab on sets window, bugs fixed: ghost countdowns for real
273 1.32, 9/18/05, bugs fixed: overhead errors fade normally, tabard on bar with cooldown/notify won't error, switching from 2h to 1h+shield queue works properly, swapping to empty won't attempt to put items in quivers, "ghost" cooldowns no longer show on empty slots, removed check for 1.7 in supposed client bug fix for 1.7 that never happened, changed: queues process as sets in stages
274 1.31, 9/8/05, bug fixed: rotate menu works when bar is horizontal
275 1.3, 9/7/05, added: German translation by Leelaa, Alt+right click an item will add a space after it, changed: right-click will activate an item same as left click, holding Alt while mouseover items will show full tooltip if Tiny Tooltips enabled, option TrinketMenu Clicks renamed TrinketMenu Mode, while TrinketMenu Mode enabled trinkets show as one menu, bugs fixed: overlapping tooltips, queue won't process upon FD, ammo count shows when adding to rack
276 1.21, 9/3/05, added: ammo shows quantity, changed: custom tooltip used instead of standard, bug fixed: thrown weapons recognized, multiple ammo stacks show as one in menu, error clicking empty slot with notify on, weapons will queue while dead
277 1.2, 9/3/05, added: options to hide tooltips or make them smaller, notify when items ready, /itemrack scale as alternative to set scale, changed: spacers to trinkets when TrinketMenu Clicks checked, OnUpdates given ItemRack_InvFrame parent, bugs fixed: mod hides when UI hidden, hunter FD won't block item swaps
278 1.1, 9/2/05, added: option to swap to empty slots, option to reverse menu growth, left/right-click trinkets options added, changed: "Soulbound Only" renamed to "Hide Tradables", some slots ignore soulbound flag now: trinket, ammo, shirt, tabard. quest and conjured items now show with 'Soulbound Only' on. bug fixed: items queued while dead will swap on res before release
279 1.0, 8/31/05, initial release