BattleCry is a great passive assist for roleplay as well as communication tool for grouping. When you perform an action, it randomly picks one of the cries that you've set for that action and executes it.

Features:
* Add unlimited cries for each active spell or skill in your spellbook (including pet actions)
* Cries can be set to /say, /emote, /yell, /group (/raid) or /rw
* Cries can be said in any language that your character knows
* Cries can be multiple lines, though they are limited to 255 characters
* Cries can use any slash commands that you would normally type into the chat box (essentially making them macros)
* Set the frequency that a cry should be executed on a per-action basis
* Set whether a specific cry should be executed at the beginning of a spellcast or at the end
* Use variables in cries that refer to a target's name, class, race, animal family, gender, faction, etc.
* Add up to 6 conditions for each cry that must be true for that cry to be executed (target name is "Mangy Wolf", faction is "Horde", etc.)
* Create up to 32 custom actions (each with unlimited cries) that can be executed with a chat command or macro
* Specify specific cries to only be executed after other specific cries, creating chains of cries
* Easily disable BattleCry with the click of a button

Commands:
/bc - Open the BattleCry options
/bc help - display the BattleCry help
/bc vars - display the BattleCry variable list (below)
/bc cry <action> - executes a random cry for <action>


List of Variables: (unless otherwise indicated all variables report on your current target)
Please note that these variables are different than previous versions. BattleCry will update your old variables automatically and you should begin using these variables from this point forward.
$nm - String - Name
$hm - Number - Maximum Health (Note that your target may report health only as percent)
$hc - Number - Current Health
$hp - Number - Current Health as a percent
$mm - Number - Maximum Mana (Note that your target may report mana only as percent)
$mc - Number - Current Mana
$mp - Number - Current Mana as a percent
$cl - String - Class
$cc - String - Elite Status (none, elite, rare, boss, etc.)
$cf - String - Creature Family (Wolf, Boar, Crab, etc. Only works with Beasts)
$ct - String - Creature Type (Beast, Undead, Humanoid, Demon, etc.)
$fa - String - Faction (Horde, Alliance)
$rc - String - Race (Gnome, Human, Tauren, Troll, etc.)
$lv - Number - Level
$gu - String - Guild Name
$pn - String - Pet's Name
$po - String - Pronoun Object (him, her, it)
$pp - String - Pronoun Possessive (his, hers, its)
$ps - String - Pronoun Subject (he, she, it)
$ga - String - Gender A (male, female, it)
$gb - String - Gender B (man, woman, it)

Things to know:
If the output mode is left blank, saving a cry will default to /say.
If the output mode is set to /group, it will default to /raid if you are in a raid or /say if you are not in a group at all.
If the language is left blank, saving a cry will default to common or orcish.
You must resave a cry after changing whether it is executed at the beginning or end of a cast.
If a cry contains a variable that does not apply, the cry will not be executed. ex: $pn when you have no pet, $ra when targetting a non-humanoid, etc.
Cries are saved separately for each pet, so you must set up cries for each pet individually. Additionally, specific pet cries are only available when that specific pet is summoned.
Custom actions are not fully erased until you log out. If you accidentally delete a custom action, simply add it again (with the same name) before logging out and your custom action will be restored.
When adding a custom action, it will default to the name of the last action used.

*** For advanced users only ***
CHAINS:
Setting up chains is very simple to do. Once you have cries saved that you would like to chain together, click the "Chains" tab at the bottom of the BattleCry window.
Here you can select a cry that is the "Leading" cry, and a cry that is the "Following" cry. If the leading cry gets executed, BattleCry will wait for the next action you do. If that action is the one specified in the Following Cry section, BattleCry will automatically execute the Following Cry.
If you set up chains with the same Leading Cry, BattleCry will randomly select one of the Following Cries to execute.
Following Cries still follow the same conditional rules as outlined in the conditions section below.
Because some chained cries may seem out of place if executed without the Following Cry first, there is a new checkbox on the main BattleCry window labelled, "Exclude". Check this box if you would like BattleCry to ignore that particular cry unless it is part of a chain.
Currently, while you can create as many chains as you like, you can only view/change/delete the first 32 that you save.

CONDITIONS:
Conditions can be tricky to use and so I recommend their use only to advanced users.
Each conditional statement consists of four required parts: target, variable, test, and value.

target: Acceptable values are
"player" - Test for something about you
"pet" - Test for something about your pet
"target" - test for something about your target

variable: Acceptable values are
var - return - explanation
--- - ------ - -----------
$nm - String - Name
$hm - Number - Maximum Health (Note that your target may report health only as percentage)
$hc - Number - Current Health
$hp - Number - Current Health as a percent
$mm - Number - Maximum Mana (Note that your target may report mana only as percentage)
$mc - Number - Current Mana
$mp - Number - Current Mana as a percent
$cl - String - Class
$cc - String - Elite Status (none, elite, rare, boss, etc.)
$cf - String - Creature Family (Wolf, Boar, Crab, etc. Only works with Beasts)
$ct - String - Creature Type (Beast, Undead, Humanoid, Demon, etc.)
$fa - String - Faction (Horde, Alliance)
$rc - String - Race (Gnome, Human, Tauren, Troll, etc.)
$lv - Number - Level
$sx - Number - Sex/Gender (1 = male, 2 = female)
$gu - String - Guild Name
$pv - Number - PvP flag up/down ( 1 = up, 0 = down)
$ic - Number - In combat ( 1 = in combat, 0 = not in combat)
$re - Number - Reaction (0 - 7 = Hated - Exalted)
$cv - Number - Civilian ( 1 = civilian, 0 = not civilian)


test: Acceptable values are
"==" - equal to
"~=" - not equal to
"
"
">" - greater than
">=" - greater than or equal to

value: The value that you want to test for

When an action is performed, if there are conditions on a specific cry, BattleCry will go through each condition and test if it is true.
The general formula is: if VARIABLE of TARGET is TEST of VALUE.
For example, the following condition on a cry:
target = "target"
variable = "$ct"
test = "=="
value = "Demon"
will make this cry only execute when your target is a demon.

There is a new checkbox in the main BattleCry options labelled "Ignore Frequency". Checking this will make that cry ignore the frequency value for that cry.
This is particularly useful if you have a cry that you want to only be executed at a specific event, but you want it always to be executed at that event. Examples would be:
target $nm == "Baron Rivendare"
player $hp
When an action is performed, BC decides (based on the frequency set for that action) if a cry should be executed. If it should, then it picks one of the valid cries (based on conditions and variables used) and executes it.
If the frequency check fails, it then checks to see if there are any cries that have Ignore Frequency checked and if its conditions come out true, it executes that cry.
Note that if you have two conditions that have Ignore Frequency checked and both evaluate to true, BC will pick one of them, not do both of them.

There is a checkbox in the Condition options labelled "Exclusive". This can be checked or unchecked for each cry. If it is checked and the conditions on that cry are met, BC will not include cries that are not exclusive when deciding which cry to use.

An example of all of these put together:

Action: Heroic Strike
Frequency: 50%
Cries:
1 Rip - "Allow me a moment to rip you a new one, $nm!"
No conditions, Not exclusive, Adhering to Frequency

2 Takethat - "You can't withstand me forever!"
Condition: "target" $hp
Not exclusive, adhering to Frequency

3 Stabby - /emote stabs $nm with all of his might.
Condition: "target" $nm == Baron Rivendare
Not exclusive, ignoring Frequency

4 Power - "By the power of Gnomeregan, I vanquish thee!"
Conditon: "target" $nm == Darkmaster Gandling
"target" $hc
Exclusive, adhering to Frequency

5 Frenzy - /emote gets a frenzied look in his eyes.
Conditon: "target" $nm == General Drakkisath
exclusive, ignoring Frequency

With these five cries defined, the following would happen:

When fighting a random creature, you will execute a cry 50% of the time.
It will always include cry 1.
When the creatue is under 25% health, it will also include cry 2.

When fighting Rivendare, every time you use Heroic Strike you will execute a cry.
It will always include cry 3.
If he is over 25% health, it will include cry 1 50% of the time.
if he is under 25% health, it will include cry 1 and 2 50% of the time.

When fighting Gandling, you will execute a cry 50% of the time.
If he is over 25% health, it will always be cry 1.
When he is under 25% health, it will include cry 2 as well.
When he is under 10% health, it will always be cry 4.

When fighting Drak, you will execute a cry every time.
It will always be cry 5.