XCustomBar
==========

By Dr. Doom (Shalune on Kargath)

This mod works with the XBar framework to create custom XBar components.  For those of you who are curious about it's function, it basically emulates the addition of other bars, and comes with a handy interface to make the new bars.

FEATURES:

* Supports customizable actions (Spells, Items, or Macros)
* Supports flexible click conditions (Help/Harm/Buttons 1-5/Ctrl/Shift/Alt)
* Allows multiple actions for one bar using conditionals
* Easy GUI interface to create new bars.

COMMANDS:

/xcustombar config

USAGE:

Open the config window, and create new action bars to plug into XBar by typing a name for it into the text box, and click New.  For each bar you create, you will get a Spell Button with one Action.

Add buttons to the bars by selecting the type of button (Spell/Macro/Item) by clicking the + below the New button, then clicking New in the button list.  You can re-order the buttons by selecting one, and clicking the + and - buttons above the list.

Add actions to the buttons by clicking New below the action list.  Type the appropriate spell name, macro name, or item name in the text box and click Save.  You can change the cast conditionals by clicking the + above the name box to the right.  Repeat this for each additional action to add to this button.

Click Save + Close, and the changes will be saved, and the UI will be reloaded to show the new bars.  Each bar's display options will be configurable using the standard XBar configuration window.  THIS BUTTON WILL NOT SAVE CHANGES TO THE SPELL/MACRO/ITEM name in the text box above.

Individual display options for XCustomBar addons will appear in the XBar configuration window like normal bars.

CASTING SPECIFIC RANK SPELLS:

Make a spell button like normal, and type in the name immediately followed by the rank in parentheses (no space, ex: "Conjure Food(Rank 2)").  Be aware that some ranks may have an extra trailing space at the end, so if it doesn't show up, try putting a space at the end of the rank.  The rank is what is listed below the spell in the spell book: Rank 2, Racial, Expert, etc...  Note that casting Passive or Racial Passive spells will have no effect.

LIMITATIONS ON BUTTONS USING ALLY/ENEMY:

Due to incomplete Blizzard UI scripting, you need to be aware of the following issues when creating buttons that use this feature:

* Actions that do not specify ally/enemy may override these.  If any action uses ally/enemy detection, all actions in the same button should specify as well.
* Auto-selfcast does not function on these buttons if you have no target selected.  All actions on this button will target the player's target.
* TEST YOUR BUTTONS THOUROGHLY!  This is a complex feature and you need to test every action on the button.  I won't guarantee that it will work perfectly for everything you throw at it.

KNOWN ISSUES:

* Pressing ESC on the config window will close the window without reloading the UI.  Changes to the buttons or actions will NOT be cancelled.  Changes made may not appear correctly until the UI is reloaded.  This is an intentional feature so you can cancel the window without reloading the UI if you made no changes.