Mercurial > wow > reaction

comparison README.html @ 7:f920db5fc6b1

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