ReAction

AddOn for World of Warcraft

Current Version: 0.32 (alpha)
Released: 03 Feb 2007
WoW Version Compatibility/TOC: 2.0.6 / TOC 20003

The Basics

ReAction is a replacement for the default Blizzard action bars. It allows you redefine your action button layout any way you like.

Features

• Move, resize, create, and arrange as many action bars as you want. Each bar can contain any number of buttons arranged in a grid layout of any size and spacing. The full complement of 120 action slots is supported.
• Works with all types of actions, including abilities, items, and macros
• Layout is done with the mouse, by dragging bars and bar edges on screen. Automatically anchor bars to each other or the screen edges by holding shift down as you drag.
• Context menus provide independent configuration options for each bar.
• Point and click keybinding interface.
• Supports multiple 'pages' per bar, configured independently. Automatic stance, form, and stealth switching among pages is supported, including Shadowform.
• Pet action bar is fully supported and configurable.
• Settings can be saved per account, realm, character, class, or independent profile.
• Compatible with OmniCC
• Various configurable display options

ReAction is built using the Ace2 development framework.

Using ReAction

Installation

To install ReAction, drag the ReAction folder to World of Warcraft/Interface/AddOns. Exit World of Warcraft if it's running, then restart.

Welcome to ReAction

When you first enter World of Warcraft with ReAction installed, it will look very similar to the default Blizzard UI, depending on what other AddOns are installed. Any keybindings you have made to the action bars, however, are not in effect. Also, only the main menu bar is shown by default. Other bars can be created as desired.

If you have FuBar installed, on the left side you should see the ReAction plugin icon and label. If not, there should be a button on your minimap. In either case, that button (the ReAction Control Button) is the gateway to configuring ReAction.

ReAction has three modes of operation:

• Normal ("locked")
• Configuration ("unlocked")
• Keybinding

You can toggle Configuration mode by shift-clicking the ReAction Control Button and toggle Keybinding mode by alt-clicking the button. Global configuration options are also available by right-clicking the ReAction button. There are also a limited set of console commands that can be accessed with the "/reaction" or "/rxn" slash-commands. Type /rxn in the chat box to print a list of commands.

You can also set key bindings to toggle Configuration and Keybinding modes, in the standard UI keybindings panel.

Configuring ReAction

Start by shift-clicking the ReAction button to enter Configuration mode. All bars, including hidden bars, are shown in this mode and normal button click operation is disabled (though keybindings still work). Mouse over the bars, edges, and corners to see tooltip instructions for moving, resizing, and rearranging them. Right click each bar for a menu of options pertaining to that bar. For example, to change a hidden bar to a visible bar, right-click on a bar and choose Visibility -> Always Visible. Tooltips for each menu option provide details.

When you're done configuring ReAction, shift-click the ReAction button again to go back to Normal mode.

Configuration mode is not available if you are in combat, and is automatically cancelled if you enter combat.

Setting Keybindings

ReAction buttons don't use the regular keybindings of the default UI. In order to get your buttons to use hotkeys, enter ReAction Keybinding Setup mode by alt-clicking the ReAction Control Button (or choosing 'keybinding mode' from the right-click menu). ReAction button keybindings are not available from the standard keybindings menu! You must use the ReAction keybinding interface.

Like configuration mode, normal button operation is disabled while in keybinding mode (though again, any hotkeys you have assigned will work).

With the keybinding interface out, you can mouseover any ReAction button to see what its current keybinding is. You can set the keybinding on a button by pressing the key, then clicking the button. To clear a keybinding from a ReAction button, right-click the button. If you've set up bars with multiple pages, you can also bind a key to the page up/down buttons on a per-bar basis. Just make sure the buttons are showing (they can be hidden later) and assign the keybinding like any other ReAction button.

Keybindings are saved on a per-character basis. Keybinding mode is not available if you are in combat, and is automatically cancelled if you enter combat.

Playing with ReAction

Once you get your keybindings and configuration set up, you're ready to go. The buttons behave just like regular Blizzard buttons. However, at any time when you're not in combat, you can quickly switch to configuration mode and create a new bar, rearrange bars, hide/show a special-use bar, etc. Perfect for when you get some goofy quest item that has to be used temporarily, or get a new skill that doesn't fit on your current layout.

Limitations

• Due to a lack of certain functionality being made available by Blizzard, dragging and dropping actions onto action bars while in combat is a little funky. You have to click the destination button rather than just release drag on it.
• You can't configure the pet bar unless you actually have a pet out at the moment.
• No support for shapeshift/stance bar (yet)
• If you have a bar with empty buttons, even though they're invisible they still block mouse input from reaching whatever might be under the button. This is a workaround so that you can drag and drop actions onto hidden slots during combat. This workaround can be disabled via a configuration option, but then you can't drag and drop actions onto slots during combat. Pick your poison, it's a limitation of Blizzard's protection scheme.
• If you hide the default main menu bar, there is no substitute for the XP bar, bag bar, or micro menu bar (although the hotkeys for them still work)

Known Issues

• There may or may not be a particular case in which turning off a pet's attack while using Eyes of the Beast doesn't work. Further investigation (and leveling a hunter to get Eyes of the Beast :-P) is required.
• The initial mapping of action IDs for shapeshift forms doesn't exactly match Blizzard's mapping. When first starting up as a warrior, druid, or rogue, you will probably need to move your actions around.
• Action IDs may not always be laid out in sequence, meaning that similar layouts on different machines may put the actions in a different order.
• Keybindings are only saved per character, which causes problems when switching profiles.
• There seems to be a big performance hit when first dragging a bar after entering configuration mode, and when first enabling keybinding mode.

Future Plans

• Use override bindings for the keybindings, and automatically switch with profiles. Also "steal" bindings from the default UI on first run so that they're populated with something reasonable.
• Add support for bag bar, shapeshift bar, and micro menu bar. May also add XP bar to default unit frames for those who don't want to use a unit frame addon to get the XP bar back.
• More dynamic bar support: auto show/hide/fade on stance switch, in combat, key pressed, etc.
• "pop-up" bar support, in which a single button shows/hides a bar when moused over
• Better and more flexible interface for defining page transitions on stance/form shift
• Provide a method for normalizing the action ID layout, permitting better compatibility when used on different computers.
• Provide some additional console commands so that enterprising users can macro certain configuration functionality (notably hiding and showing individual bars)
• Yet more configurable button display options (disable cooldown flash, different borders, etc)
• Localization

Version History

Version 0.32:

• Fixed a bug with displaying cooldowns generating slews of errors

Version 0.31:

• Fixed a bug where action IDs > 120 were being configured and allocated in certain cases
• Fixed a bug where hidden paging controls were reappearing when switching pages
• Fixed a script error that was popping up in certain conditions when starting keybinding mode, and causing some buttons not to be bindable
• Applied a fix that will (hopefully?) eliminate errors saying ACTIONBAR_UPDATE_STATE was not registered (be on the lookout for recurrences of that one). Hopefully this fix will eliminate several other intermittent errors that I think are part of the same cause.
• Added new options for controlling the opacity of buttons (which should now actually work). Previous opacity settings (if any) will be lost and will need to be re-applied after updating. There is also now a toggle to hide (rather than alpha-zero) empty buttons, at the expense of not being able to drag actions onto them during combat.
• Action IDs now appear/disappear automatically when bars are unlocked. There is no longer a menu item to show/hide them.
• Changed the default startup bar configuration to only be the paged main bar. This allows a default startup to create new bars without having to delete some first. Will probably simplify even further in a future patch. Note this doesn't fix the action-rearrangement setup headaches with warriors, druids, and rogues.
• Cooldowns can now be hidden - either all cooldowns or just global cooldowns.

Version 0.3

• Complete rewrite of the innards for better modularity
• Lots of bug fixes
• Multi-paged bar support
• Pet bar support
• Auto stance/form/stealth switching
• Lots and lots of new configuration options

Version 0.2

• Bug fixes from 0.1
• new keybinding interface

Version 0.1

• Initial concept, button arrangement

Credits

Huge credit to the Ace 2 development team, whose framework provides a level of functionality that I consider critical to the success of this addon.

Similarly, enormous credit goes to ckknight, whose Dewdrop menuing system and FuBar plugin system are ridiculously easy to use.

Finally, thanks to my alpha testers and stalwart adventuring companions: Deor, Nogrim, Sorabel, and Yngvi.

Copyright

ReAction © 2007 by Ryan Findley.

You are free to distribute this AddOn package without notice to the author, as long as the package is unmodified, this readme.html file accompanies the distribution, and no claim of authorship of the contents of the package is made. Derived works are expressly permitted but must be clearly labeled as not the work of the original author and packaged separately, with credit given to the original author. Inclusion of this package within a compilation is expressly permitted.

The author expressly disclaims any warranty of any kind for the material contained in this package. USE AT YOUR OWN RISK.

All files in this package under the 'libs/' directory are libraries made available by WoWAce, and are not the work of this author.

World of Warcraft is a registered trademark of Blizzard Entertainment, Inc.