|
flickerstreak@7
|
1 <html>
|
|
flickerstreak@7
|
2 <head>
|
|
flickerstreak@7
|
3 <title>ReAction: README</title>
|
|
flickerstreak@7
|
4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
flickerstreak@7
|
5 </head>
|
|
flickerstreak@7
|
6
|
|
flickerstreak@7
|
7 <body bgcolor="#FFFFFF" text="#000000">
|
|
flickerstreak@7
|
8 <h1 align="center">ReAction</h1>
|
|
flickerstreak@7
|
9 <h3 align="center">AddOn for World of Warcraft</h3>
|
|
flickerstreak@9
|
10 <p><font size="2">Current Version: 0.32 (alpha)<br>
|
|
flickerstreak@9
|
11 Released: 03 Feb 2007</font><font size="2"><br>
|
|
flickerstreak@7
|
12 WoW Version Compatibility/TOC: 2.0.6 / TOC 20003</font></p>
|
|
flickerstreak@7
|
13 <h2>The Basics</h2>
|
|
flickerstreak@7
|
14 <p>ReAction is a replacement for the default Blizzard action bars. It allows you
|
|
flickerstreak@7
|
15 redefine your action button layout any way you like.</p>
|
|
flickerstreak@7
|
16 <h2>Features</h2>
|
|
flickerstreak@7
|
17 <ul>
|
|
flickerstreak@7
|
18 <li>Move, resize, create, and arrange as many action bars as you want. Each
|
|
flickerstreak@7
|
19 bar can contain any number of buttons arranged in a grid layout of any size
|
|
flickerstreak@7
|
20 and spacing. The full complement of 120 action slots is supported.</li>
|
|
flickerstreak@7
|
21 <li>Works with all types of actions, including abilities, items, and macros</li>
|
|
flickerstreak@7
|
22 <li>Layout is done with the mouse, by dragging bars and bar edges on screen.
|
|
flickerstreak@7
|
23 Automatically anchor bars to each other or the screen edges by holding shift
|
|
flickerstreak@7
|
24 down as you drag.</li>
|
|
flickerstreak@7
|
25 <li>Context menus provide independent configuration options for each bar.</li>
|
|
flickerstreak@7
|
26 <li>Point and click keybinding interface.</li>
|
|
flickerstreak@7
|
27 <li>Supports multiple 'pages' per bar, configured independently. Automatic stance,
|
|
flickerstreak@7
|
28 form, and stealth switching among pages is supported, including Shadowform.</li>
|
|
flickerstreak@7
|
29 <li>Pet action bar is fully supported and configurable.</li>
|
|
flickerstreak@7
|
30 <li>Settings can be saved per account, realm, character, class, or independent
|
|
flickerstreak@7
|
31 profile. </li>
|
|
flickerstreak@7
|
32 <li>Compatible with OmniCC</li>
|
|
flickerstreak@8
|
33 <li>Various configurable display options</li>
|
|
flickerstreak@7
|
34 </ul>
|
|
flickerstreak@7
|
35 <p>ReAction is built using the <a href="http://www.wowace.com/Wiki/Ace2">Ace2</a>
|
|
flickerstreak@7
|
36 development framework.</p>
|
|
flickerstreak@7
|
37 <h2>Using ReAction</h2>
|
|
flickerstreak@7
|
38 <h3>Installation</h3>
|
|
flickerstreak@7
|
39 <p>To install ReAction, drag the ReAction folder to World of Warcraft/Interface/AddOns.
|
|
flickerstreak@7
|
40 Exit World of Warcraft if it's running, then restart.</p>
|
|
flickerstreak@7
|
41 <h3>Welcome to ReAction</h3>
|
|
flickerstreak@7
|
42 <p>When you first enter World of Warcraft with ReAction installed, it will look
|
|
flickerstreak@7
|
43 very similar to the default Blizzard UI, depending on what other AddOns are
|
|
flickerstreak@7
|
44 installed. Any keybindings you have made to the action bars, however, are not
|
|
flickerstreak@8
|
45 in effect. Also, only the main menu bar is shown by default. Other bars can
|
|
flickerstreak@8
|
46 be created as desired.</p>
|
|
flickerstreak@7
|
47 <p>If you have FuBar installed, on the left side you should see the ReAction plugin
|
|
flickerstreak@7
|
48 icon and label. If not, there should be a button on your minimap. In either
|
|
flickerstreak@7
|
49 case, that button (the ReAction Control Button) is the gateway to configuring
|
|
flickerstreak@7
|
50 ReAction.</p>
|
|
flickerstreak@7
|
51 <p>ReAction has three modes of operation:</p>
|
|
flickerstreak@7
|
52 <ul>
|
|
flickerstreak@7
|
53 <li>Normal ("locked")</li>
|
|
flickerstreak@7
|
54 <li>Configuration ("unlocked")</li>
|
|
flickerstreak@7
|
55 <li>Keybinding</li>
|
|
flickerstreak@7
|
56 </ul>
|
|
flickerstreak@7
|
57 <p>You can toggle Configuration mode by shift-clicking the ReAction Control Button
|
|
flickerstreak@7
|
58 and toggle Keybinding mode by alt-clicking the button. Global configuration
|
|
flickerstreak@7
|
59 options are also available by right-clicking the ReAction button. There are
|
|
flickerstreak@7
|
60 also a limited set of console commands that can be accessed with the "/reaction"
|
|
flickerstreak@7
|
61 or "/rxn" slash-commands. Type /rxn in the chat box to print a list
|
|
flickerstreak@7
|
62 of commands.</p>
|
|
flickerstreak@7
|
63 <p>You can also set key bindings to toggle Configuration and Keybinding modes,
|
|
flickerstreak@7
|
64 in the standard UI keybindings panel.</p>
|
|
flickerstreak@7
|
65 <h3>Configuring ReAction</h3>
|
|
flickerstreak@7
|
66 <p>Start by shift-clicking the ReAction button to enter Configuration mode. All
|
|
flickerstreak@7
|
67 bars, including hidden bars, are shown in this mode and <b>normal button click
|
|
flickerstreak@7
|
68 operation is disabled </b>(though keybindings still work). Mouse over the bars,
|
|
flickerstreak@7
|
69 edges, and corners to see tooltip instructions for moving, resizing, and rearranging
|
|
flickerstreak@7
|
70 them. Right click each bar for a menu of options pertaining to that bar. For
|
|
flickerstreak@7
|
71 example, to change a hidden bar to a visible bar, right-click on a bar and choose
|
|
flickerstreak@7
|
72 Visibility -> Always Visible. Tooltips for each menu option provide details.</p>
|
|
flickerstreak@7
|
73 <p>When you're done configuring ReAction, shift-click the ReAction button again
|
|
flickerstreak@7
|
74 to go back to Normal mode.</p>
|
|
flickerstreak@7
|
75 <p>Configuration mode is not available if you are in combat, and is automatically
|
|
flickerstreak@7
|
76 cancelled if you enter combat.</p>
|
|
flickerstreak@7
|
77 <h3>Setting Keybindings</h3>
|
|
flickerstreak@7
|
78 <p><b>ReAction buttons don't use the regular keybindings of the default UI.</b>
|
|
flickerstreak@7
|
79 In order to get your buttons to use hotkeys, enter ReAction Keybinding Setup
|
|
flickerstreak@7
|
80 mode by alt-clicking the ReAction Control Button (or choosing 'keybinding mode'
|
|
flickerstreak@7
|
81 from the right-click menu). <b>ReAction button keybindings are not available
|
|
flickerstreak@7
|
82 from the standard keybindings menu!</b> You <i>must</i> use the ReAction keybinding
|
|
flickerstreak@7
|
83 interface.</p>
|
|
flickerstreak@7
|
84 <p>Like configuration mode, normal button operation is disabled while in keybinding
|
|
flickerstreak@7
|
85 mode (though again, any hotkeys you have assigned will work).</p>
|
|
flickerstreak@7
|
86 <p>With the keybinding interface out, you can mouseover any ReAction button to
|
|
flickerstreak@7
|
87 see what its current keybinding is. You can set the keybinding on a button by
|
|
flickerstreak@7
|
88 pressing the key, then clicking the button. To clear a keybinding from a ReAction
|
|
flickerstreak@7
|
89 button, right-click the button. If you've set up bars with multiple pages, you
|
|
flickerstreak@7
|
90 can also bind a key to the page up/down buttons on a per-bar basis. Just make
|
|
flickerstreak@7
|
91 sure the buttons are showing (they can be hidden later) and assign the keybinding
|
|
flickerstreak@7
|
92 like any other ReAction button.</p>
|
|
flickerstreak@7
|
93 <p>Keybindings are saved on a per-character basis. Keybinding mode is not available
|
|
flickerstreak@7
|
94 if you are in combat, and is automatically cancelled if you enter combat.</p>
|
|
flickerstreak@7
|
95 <h3>Playing with ReAction</h3>
|
|
flickerstreak@7
|
96 <p>Once you get your keybindings and configuration set up, you're ready to go.
|
|
flickerstreak@7
|
97 The buttons behave just like regular Blizzard buttons. However, at any time
|
|
flickerstreak@7
|
98 when you're not in combat, you can quickly switch to configuration mode and
|
|
flickerstreak@7
|
99 create a new bar, rearrange bars, hide/show a special-use bar, etc. Perfect
|
|
flickerstreak@7
|
100 for when you get some goofy quest item that has to be used temporarily, or get
|
|
flickerstreak@7
|
101 a new skill that doesn't fit on your current layout.</p>
|
|
flickerstreak@7
|
102 <h2>Limitations</h2>
|
|
flickerstreak@7
|
103 <ul>
|
|
flickerstreak@7
|
104 <li>Due to a lack of certain functionality being made available by Blizzard,
|
|
flickerstreak@7
|
105 dragging and dropping actions onto action bars while in combat is a little
|
|
flickerstreak@7
|
106 funky. You have to click the destination button rather than just release drag
|
|
flickerstreak@7
|
107 on it.</li>
|
|
flickerstreak@7
|
108 <li>You can't configure the pet bar unless you actually have a pet out at the
|
|
flickerstreak@7
|
109 moment. </li>
|
|
flickerstreak@7
|
110 <li>No support for shapeshift/stance bar (yet)</li>
|
|
flickerstreak@7
|
111 <li>If you have a bar with empty buttons, even though they're invisible they
|
|
flickerstreak@7
|
112 still block mouse input from reaching whatever might be under the button.
|
|
flickerstreak@7
|
113 This is a workaround so that you can drag and drop actions onto hidden slots
|
|
flickerstreak@8
|
114 during combat. This workaround can be disabled via a configuration option,
|
|
flickerstreak@8
|
115 but then you can't drag and drop actions onto slots during combat. Pick your
|
|
flickerstreak@8
|
116 poison, it's a limitation of Blizzard's protection scheme.</li>
|
|
flickerstreak@7
|
117 <li>If you hide the default main menu bar, there is no substitute for the XP
|
|
flickerstreak@7
|
118 bar, bag bar, or micro menu bar (although the hotkeys for them still work)</li>
|
|
flickerstreak@7
|
119 </ul>
|
|
flickerstreak@7
|
120 <h2>Known Issues</h2>
|
|
flickerstreak@7
|
121 <ul>
|
|
flickerstreak@7
|
122 <li>There may or may not be a particular case in which turning off a pet's attack
|
|
flickerstreak@7
|
123 while using Eyes of the Beast doesn't work. Further investigation (and leveling
|
|
flickerstreak@7
|
124 a hunter to get Eyes of the Beast :-P) is required.</li>
|
|
flickerstreak@7
|
125 <li>The initial mapping of action IDs for shapeshift forms doesn't exactly match
|
|
flickerstreak@7
|
126 Blizzard's mapping. When first starting up as a warrior, druid, or rogue,
|
|
flickerstreak@7
|
127 you will probably need to move your actions around.</li>
|
|
flickerstreak@7
|
128 <li>Action IDs may not always be laid out in sequence, meaning that similar
|
|
flickerstreak@7
|
129 layouts on different machines may put the actions in a different order.</li>
|
|
flickerstreak@7
|
130 <li>Keybindings are only saved per character, which causes problems when switching
|
|
flickerstreak@7
|
131 profiles.</li>
|
|
flickerstreak@7
|
132 <li>There seems to be a big performance hit when first dragging a bar after
|
|
flickerstreak@7
|
133 entering configuration mode, and when first enabling keybinding mode.</li>
|
|
flickerstreak@7
|
134 </ul>
|
|
flickerstreak@7
|
135 <h2>Future Plans</h2>
|
|
flickerstreak@7
|
136 <ul>
|
|
flickerstreak@7
|
137 <li>Use override bindings for the keybindings, and automatically switch with
|
|
flickerstreak@7
|
138 profiles. Also "steal" bindings from the default UI on first run
|
|
flickerstreak@7
|
139 so that they're populated with something reasonable.</li>
|
|
flickerstreak@7
|
140 <li>Add support for bag bar, shapeshift bar, and micro menu bar. May also add
|
|
flickerstreak@7
|
141 XP bar to default unit frames for those who don't want to use a unit frame
|
|
flickerstreak@7
|
142 addon to get the XP bar back.</li>
|
|
flickerstreak@7
|
143 <li>More dynamic bar support: auto show/hide/fade on stance switch, in combat,
|
|
flickerstreak@7
|
144 key pressed, etc.</li>
|
|
flickerstreak@7
|
145 <li>"pop-up" bar support, in which a single button shows/hides a bar
|
|
flickerstreak@7
|
146 when moused over</li>
|
|
flickerstreak@7
|
147 <li>Better and more flexible interface for defining page transitions on stance/form
|
|
flickerstreak@7
|
148 shift </li>
|
|
flickerstreak@7
|
149 <li>Provide a method for normalizing the action ID layout, permitting better
|
|
flickerstreak@7
|
150 compatibility when used on different computers.</li>
|
|
flickerstreak@7
|
151 <li>Provide some additional console commands so that enterprising users can
|
|
flickerstreak@7
|
152 macro certain configuration functionality (notably hiding and showing individual
|
|
flickerstreak@7
|
153 bars) </li>
|
|
flickerstreak@7
|
154 <li>Yet more configurable button display options (disable cooldown flash, different
|
|
flickerstreak@7
|
155 borders, etc)</li>
|
|
flickerstreak@7
|
156 <li>Localization</li>
|
|
flickerstreak@7
|
157 </ul>
|
|
flickerstreak@7
|
158 <h2>Version History</h2>
|
|
flickerstreak@9
|
159 <p>Version 0.32:</p>
|
|
flickerstreak@9
|
160 <ul>
|
|
flickerstreak@9
|
161 <li>Fixed a bug with displaying cooldowns generating slews of errors</li>
|
|
flickerstreak@9
|
162 </ul>
|
|
flickerstreak@8
|
163 <p>Version 0.31:</p>
|
|
flickerstreak@8
|
164 <ul>
|
|
flickerstreak@8
|
165 <li>Fixed a bug where action IDs > 120 were being configured and allocated
|
|
flickerstreak@8
|
166 in certain cases</li>
|
|
flickerstreak@8
|
167 <li>Fixed a bug where hidden paging controls were reappearing when switching
|
|
flickerstreak@8
|
168 pages</li>
|
|
flickerstreak@8
|
169 <li>Fixed a script error that was popping up in certain conditions when starting
|
|
flickerstreak@8
|
170 keybinding mode, and causing some buttons not to be bindable</li>
|
|
flickerstreak@8
|
171 <li>Applied a fix that will (hopefully?) eliminate errors saying ACTIONBAR_UPDATE_STATE
|
|
flickerstreak@8
|
172 was not registered (be on the lookout for recurrences of that one). Hopefully
|
|
flickerstreak@8
|
173 this fix will eliminate several other intermittent errors that I think are
|
|
flickerstreak@8
|
174 part of the same cause.</li>
|
|
flickerstreak@8
|
175 <li>Added new options for controlling the opacity of buttons (which should now
|
|
flickerstreak@8
|
176 actually work). Previous opacity settings (if any) will be lost and will need
|
|
flickerstreak@8
|
177 to be re-applied after updating. There is also now a toggle to hide (rather
|
|
flickerstreak@8
|
178 than alpha-zero) empty buttons, at the expense of not being able to drag actions
|
|
flickerstreak@8
|
179 onto them during combat.</li>
|
|
flickerstreak@8
|
180 <li>Action IDs now appear/disappear automatically when bars are unlocked. There
|
|
flickerstreak@8
|
181 is no longer a menu item to show/hide them.</li>
|
|
flickerstreak@8
|
182 <li>Changed the default startup bar configuration to only be the paged main
|
|
flickerstreak@8
|
183 bar. This allows a default startup to create new bars without having to delete
|
|
flickerstreak@8
|
184 some first. Will probably simplify even further in a future patch. Note this
|
|
flickerstreak@8
|
185 doesn't fix the action-rearrangement setup headaches with warriors, druids,
|
|
flickerstreak@8
|
186 and rogues.</li>
|
|
flickerstreak@9
|
187 <li>Cooldowns can now be hidden - either all cooldowns or just global cooldowns.</li>
|
|
flickerstreak@8
|
188 </ul>
|
|
flickerstreak@7
|
189 <p>Version 0.3</p>
|
|
flickerstreak@7
|
190 <ul>
|
|
flickerstreak@7
|
191 <li>Complete rewrite of the innards for better modularity</li>
|
|
flickerstreak@7
|
192 <li>Lots of bug fixes</li>
|
|
flickerstreak@7
|
193 <li>Multi-paged bar support</li>
|
|
flickerstreak@7
|
194 <li>Pet bar support</li>
|
|
flickerstreak@7
|
195 <li>Auto stance/form/stealth switching</li>
|
|
flickerstreak@7
|
196 <li>Lots and lots of new configuration options</li>
|
|
flickerstreak@7
|
197 </ul>
|
|
flickerstreak@7
|
198 <p>Version 0.2</p>
|
|
flickerstreak@7
|
199 <ul>
|
|
flickerstreak@7
|
200 <li>Bug fixes from 0.1</li>
|
|
flickerstreak@7
|
201 <li>new keybinding interface</li>
|
|
flickerstreak@7
|
202 </ul>
|
|
flickerstreak@7
|
203 <p>Version 0.1</p>
|
|
flickerstreak@7
|
204 <ul>
|
|
flickerstreak@7
|
205 <li>Initial concept, button arrangement</li>
|
|
flickerstreak@7
|
206 </ul>
|
|
flickerstreak@7
|
207 <h2>Credits</h2>
|
|
flickerstreak@7
|
208 <p>Huge credit to the <a href="http://www.wowace.com">Ace 2</a> development team,
|
|
flickerstreak@7
|
209 whose framework provides a level of functionality that I consider critical to
|
|
flickerstreak@7
|
210 the success of this addon.</p>
|
|
flickerstreak@7
|
211 <p>Similarly, enormous credit goes to <a href="http://ckknight.wowinterface.com">ckknight</a>,
|
|
flickerstreak@7
|
212 whose Dewdrop menuing system and FuBar plugin system are ridiculously easy to
|
|
flickerstreak@7
|
213 use.</p>
|
|
flickerstreak@7
|
214 <p>Finally, thanks to my alpha testers and stalwart adventuring companions: Deor,
|
|
flickerstreak@7
|
215 Nogrim, Sorabel, and Yngvi.</p>
|
|
flickerstreak@7
|
216 <h2>Copyright</h2>
|
|
flickerstreak@7
|
217 <p>ReAction © 2007 by Ryan Findley.</p>
|
|
flickerstreak@7
|
218 <p>You are free to distribute this AddOn package without notice to the author,
|
|
flickerstreak@7
|
219 as long as the package is unmodified, this readme.html file accompanies the
|
|
flickerstreak@7
|
220 distribution, and no claim of authorship of the contents of the package is made.
|
|
flickerstreak@7
|
221 Derived works are expressly permitted but must be clearly labeled as not the
|
|
flickerstreak@7
|
222 work of the original author and packaged separately, with credit given to the
|
|
flickerstreak@7
|
223 original author. Inclusion of this package within a compilation is expressly
|
|
flickerstreak@7
|
224 permitted.</p>
|
|
flickerstreak@7
|
225 <p>The author expressly disclaims any warranty of any kind for the material contained
|
|
flickerstreak@7
|
226 in this package. USE AT YOUR OWN RISK.</p>
|
|
flickerstreak@7
|
227 <p>All files in this package under the 'libs/' directory are libraries made available
|
|
flickerstreak@7
|
228 by <a href="http://www.wowace.com">WoWAce</a>, and are not the work of this
|
|
flickerstreak@7
|
229 author.</p>
|
|
flickerstreak@7
|
230 <p>World of Warcraft is a registered trademark of Blizzard Entertainment, Inc.</p>
|
|
flickerstreak@7
|
231 </body>
|
|
flickerstreak@7
|
232 </html>
|
