StatusBars adds bars to monitor health, mana, rage, energy, combo points, debuffs and target/pet stats during combat (and whenever they are not fully charged / depleted).
If you want to replace the default player and target frames with StatusBars, I suggest you get the HideFrames addon.
Keep the shift key pressed and drag a bar to move the group it belongs to. If the bars are locked you will have to type /statusbars unlock first.
The behaviour can be controlled via the /statusbars slash command.
Syntax: /statusbars (lock|unlock)
Syntax: /statusbars (load|save) (<name>|defaults)
Syntax: /statusbars <target> <option> (<value>|print|reset)
Targets:
all, player, target, pet, power, tpower, ppower,
health, mana, rage, energy, focus, combo, druid, buff, debuff,
thealth, tmana, trage, tenergy, tfocus, tdebuff, tbuff
phealth, pmana, prage, penergy, pfocus, phappy, pbuff, pdebuff
Options:
alpha (decimal, default=1)
enable (always/never/combat/combatonly/auto)
color, tcolor, pcolor (string, see Readme.html)
flash (on/off)
group (player/target/pet/group1/group2/...)
percentage (none/left/right)
ptext (string, default = &frac%, see Readme.html)
scale (decimal, default=1)
text (string, see Readme.html or print the current value)
warn (decimal, default=0.6)
Friendly buffs are hidden for the player and pet by default. To enable them, type
/statusbars buff enable combatonly /statusbars pbuff enable combatonly
The target determines in which bars the option is to be set. Using all will set the value in all applicable bars, using power or tpower will set the value in the mana, rage, energy and focus bars. player and target will set set value for all bars in the group.
| alpha | Opacity of the bar. Decimal value between 0.0 and 1.0. Default = 1.0. |
| enable | When the bar should be visible. always, never: As expected auto: When the current value differs from the default i.e. when damaged, when mana is not full, etc. combat: As auto, but also displays when in combat. combatonly: Only displays in combat, no matter what the value is. |
| color, tcolor, pcolor | The color of the bar, text and percentage text. Can either be a simple named color (red, yellow, etc), a hexadecimal color in rgb or rrggbb format, or a color expression. |
| flash | If the bar should flash when high/low. |
| group | Which group the bar should belong to. player, target, pet or one of the generic group1, group2... |
| percentage | Placement of the percentage display. none, left or right. |
| ptext | Text to be displayed in the percentage field, subject to variable substitution. |
| scale | Scale the bar. Will only work well if all the bars in a group are set to the same scale. |
| text | The text to be displayed in the bar, subject to variable substitution. |
| warn | Distance from the default value where the bar will start flashing if enabled. Default = 0.6, which represents 60%. |
Options can be loaded, saved and reset using the commands /statusbars load <name>, /statusbars save <name> and /statusbars load defaults.
You can use the name of another character to load or save the settings of that character, or use an arbitrary name to save settings for later reference.
The text to be displayed in the bar is subject to variable substitution; any occurences of &cur, &max, &frac, &-cur, &name, &rank, &class, &type and &lvl will be replaced with the current value, maximum value, current percentage, lost value, name, rank, class, type and level.
This can be used to customize the information displayed in the bar. For example; if you do not like the percentage display but would like to see the target level and percentage next to the name in the target health bar, issue these commands:
/statusbars thealth percentage none /statusbars thealth text &name, &lvl (&frac%)This will remove the percentage display and instead show text similar to "Defias Looter, 13 (43%)".
If you would like to see the amount of health lost as well as amount left, use:
/statusbars thealth text &cur / &max (-&-cur)This will show "580 / 700 (-120)".
Color expressions are used to make the bar color dependant on the current value. The facility is perhaps best described by an example, the default health bar color is:
<25%:red <50%:orange <75%:yellow green
This reads as "If health is lower than 25%, the bar is red. If health is below 50%, the bar is orange. If health is below 75%, the bar is yellow. Otherwise, the bar is green."
The available conditions are =, !=, <, >, <= and >=.
The value to test against can be either absolute or a percentage.
Conditions are tested in order and the first one that matches will be selected, so make sure you list conditions in the reverse order they are expected to apply. The exception is the default color, which does not have a condition and is applied when no condition matches. Every color expression must have one and only one default color, and its placement is irrelevant.
As a trivial example, the default mana bar color is:
blue
The following examples implement a request for functionality I got earlier:
"Is there any way to color the combo bar.
Like for 1/2 points it's red. 3/4 points it's yellow. 5 points it is green?"
/statusbars combo color =5:green >=3:yellow red"Energy bar: Could it be yellow if Energy >= 40 (Sinister Strike), orange >= 35 (Eviscerate), and red for Energy < 35?"
/statusbars energy color <35:f00 <40:ff8000 ff0In the last example, colors were specified in hexadecimal rgb for illustration. You can use your favourite html color picker to find out the hex code for a color.
If you start using complex color expressions I would suggest storing them in a macro so that you will not have to retype everything when making changes.