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.
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.
KNOWN ISSUES:
This is a list of known issues with no easy workaround at this time, or were intentional in design (these are not Bugs). These issues may or may not be changed in the future.
- 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.
- Currently it is not possible to move items up and down the list without deleting buttons/actions and recreating them.
- As of this version, the only localization supported is enUS. This may be expanded on in the future as community users help to develop the localizations. Spell names are typed so they support any localization (assuming you can type a spell name).
- Making buttons that detect Allied or Enemy targets do not function at this time.
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...