Custom State Header

The Custom State Header in Bartender4 allows you to control the paging and the visibility of bars by using any macro conditions supported by WoW.


The syntax of the custom conditions is very similar to the syntax of Macros. You can use all conditions supported by the macro system to build a very complex state driver, or a very simple one, whatever suits your needs.

The General Syntax for both state drivers is:
[condition:value]parameters;[more conditions]parameters; fallback-parameters

For a complete list of the supported conditions, see Cogwheels Macro Guide

Be aware that those conditions are parsed Left-to-Right, and the first matching condition is used, so keep the order of your conditions in mind.

The Stance/Paging Header

The state header used for the paging/stances simply uses the number of your target page as the parameter. That is, 1-10 for the target bars/pages, and 0 for "do not page", so use the default page for the specific bar.

Note: Page 11 is a very special case and only used for the possess bar. ([possessbar]11 is the full code for possess bar support)


Simple State Driver for Druids. Switches to Bar 8 for Prowl, 7 for Cat, 9 for Bear and also supports the Possess Bar, with fallback to its default bar


State Driver that switches to Bar2 if you target a friendly target, and stays on its default bar for enemys


Driver that switches to Bar6 if you hold the ALT key, 7 if you hold CTRL, no paging otherwise


If you think you wrote a useful state string and want to share it with others, please contact me and i can put it up here.

The Visibility Header

The visibility state driver supports 3 differen parameters. A simple set of show and hide, but additionaly also fade to set the bar to fade-out in the selected state.

Fade Out

By specifying fade as the target you can get the bar to fade out until you place your mouse over it.

By default, it will use the Fade Out Alpha configured in the options, however you can pass another alpha value to the fade target delimited by a colon.
0 would be completely transparent, 100 completely opaque.


Fade bar out-of-combat, and show it fully in combat:


Hide Bar in every stance except 3, but only show it faded during combat


Fade Out with different alpha values


If you think you wrote a useful state string and want to share it with others, please contact me and i can put it up here.

[1]: Cogwheels Macro Guide - Conditions

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Malice Malice Nov 28, 2009 at 00:54 UTC - 0 likes

    Here's something really simple that does exactly what I wanted...

    • Show bars in Combat, otherwise hide them
    • Show bars when you have a target, otherwise hide them
    [target=target, exists]show;hide

    You can replace hide with fade:35 to do the same as above, except it will fade the bars to 35% instead of totally hide them.

    Like I said, really simple, but I use these conditions on all my bars.

  • Avatar of TzuArath TzuArath Oct 27, 2009 at 19:44 UTC - 0 likes

    Hey I thought I would share this with you. Its made for 1bar with 12 buttons for less space taking. I made a condition that will show page 1 on friendly target, page 4 on enemy (if in stances, it will show page 7 for battle, page 8 for defense and page 9 for berserk) and it will also show page 2 if ctrl is held down, and page 3 if alt is held down.

    Here is the setup: [mod:ctrl]2; [mod:alt]3; [help]1; [stance:1]7; [stance:2]8; [stance:3]9; [harm]4;1

    If you want for druid, edit stances to bonusbar as in the example in the article. Hope you like it

    Last edited Nov 05, 2009 by TzuArath: Harm didnt work where it was placed
  • Avatar of jojobinks jojobinks Jul 01, 2009 at 16:46 UTC - 0 likes


    i'am a hunt, and I would like to know how to automatically change the bar depending on the distance of the target; with the custom state ?


  • Avatar of tlundse tlundse Jun 19, 2009 at 23:36 UTC - 0 likes

    I would love an option to switch bars based on if you are PVP enabled or not (its not supported by the wow macro api)

  • Avatar of Carusun Carusun May 04, 2009 at 12:07 UTC - 0 likes

    is there any way to set the order which bars will scroll through when paging? I've got four bars that I want to keep on screen at all times, while changing which one is my main. I'd want the main bar to page through bars 1 2 3 4, and the second to page through 2 3 4 1, and so on down the line. Is this possible?

  • Avatar of WoWTheoryCraft WoWTheoryCraft Jan 15, 2009 at 05:00 UTC - 0 likes

    I use conditionals to switch between my PvE and PvP setup.

    For bar 3:


    For bar 4:


    So I can press shift+1 for PvE (bars 3+4) or shift+2 for PvP (bars 5+6).

  • Avatar of Nevcairiel Nevcairiel Jan 06, 2009 at 17:40 UTC - 0 likes

    Didn't i even mention the possess bar bit in the article above? :D

  • Avatar of mixerman3d mixerman3d Dec 19, 2008 at 23:56 UTC - 0 likes

    i was having issues with my priest. i like to have my main bar change based on what i'm targeting. if it's a friend i want heals to show, if not i wan attacks to show. this brought one problem up, when i used custom condition it would not show me the possesses bar. here was my solution for all that have run into this same issue.(solved with trial and error)


    1 signifies my main bar
    9 is the one it changes to when i'm targeting friendly
    and [bonusbar:5]11 changes to the possession bar when the condition is met

  • Avatar of Xinhuan Xinhuan Nov 02, 2008 at 00:51 UTC - 0 likes

    kghastie, your macro conditional can include


    to check that your current target is a friendly. That is what you want should be


  • Avatar of kghastie kghastie Oct 16, 2008 at 06:07 UTC - 0 likes

    Awesome plugin. Better than Bongos imo, except for one thing - and that is that I can't switch states based on friendly target status. Sounds like I can do it using macros though. Could someone show me an example of how to switch bar 1 to show bar 2 in caster form as a druid (nostance) AND targeting a friendly? So I only want it to go to this bar if I am friendly-targeting in caster form. If you could add a part so that bar switches to bar 3 in kitty form that would be really helpful, too, so I can get the syntax down.

    Thanks in advance!

    - Sixclaw


Date created
Oct 14, 2008
Last updated
Aug 29, 2012