Basics

Aura provides visual cues to the user depending upon criteria the users specifies. Being able to quickly see when you or your targets receive a certain buff or debuff, the time left on the buff, or knowing quickly when your have an ability come off cooldown can make or break the tide of a fight. This addon is based upon the addon Power Aura for World of Warcraft.

Some things Aura can alert you on:

• When you get a certain buff/debuff( "Enfeebling Strike", "Gork Sez Stop", etc )
• When you build enough career points( ie. "High Magic", "Grudge", etc )
• When an ability becomes available( ie. Reactionary styles )
• When an ability comes off of cooldown( ie: Any of them, including morale abilities )
• When you have a certain tactic on/off.
• When you or your target get above/below a certain percent of hit points
• When your action points go above or below a certain point

What type of notifications can Aura give:

• Display a texture of your choice on the screen
  • You specify the location, size, scale, rotation, color tint, including animation
• Play a sound of your choice
• Display alert text of your choice
• Display a timer on effects, or on ability cooldown
  • You specify the location, size and color tint of the timer.

Getting Started

Once you have Aura and LibSlash installed and Warhammer loaded up you are ready to configure Aura.

Use /aura to bring up the Aura configuration window and click the "Add Aura" button. This will add a new aura to Aura. If you mouse over the "New Aura" that was created you will get a tooltip that will give you several helpful actions you can perform on the aura.

The first is left click. This will allow you to preview the aura as it if has been triggered. This is helpful if you are looking to setup several auras within the same area of the screen to setup the proper spacing, etc. Note: Activation and Deactivation alert text is not displayed.

The second is right click. This will bring up the configuration for the individual aura. We will talk more about this later.

The third is shift left click. This allows the user to enable or disable an individual aura. When you first create an aura its disabled so prior to testing it out in combat you will want to make sure its enabled.

The fourth is shift right click. This allows you to delete an aura if you no longer need it. When you do this you will be given a confirmation so you cant accidentally delete one!

So lets get to editing your new aura! Put your mouse over the new aura and right click, you will see the Modify Aura window. So what type of Aura do you want to make? For this example we will make an aura that lets you know when you have Enfeebling Strike so you can stop running and make your healers life much easier!

Start by setting the aura's name to "Enfeebling Strike - Self". I tend to name my auras after what they do and who they do it to. This way I can quickly and easily identify what each one does. For this particular aura, I dont want to have an image displayed on the screen so I will check "Hide Image".

On the Trigger tab set the Aura Triggered By to "Effect". This brings up the configuration options for an Effect Trigger. In this particular case we want to enter the Effect Name of "Enfeebling Strike" and set the Type to "Ailment". Seeing I know the exact name of the effect I am looking for I can check "Exact Match" which speeds up auras ability to determien if this aura needs to be displayed. Seeing Im looking to know if I have Enfeebling Strike on myself Ill want to check "On Yourself". Thats it for this tab, so click the Activation tab.

On the Activation tab, Ill set the Sound to "RvR Flag Off" this way Ill get an audible notification when this aura is triggered. Sound wont be the only way I know to stop running, so set the Alert Text Type to whichever you fancy. I tend to use "Achievements Renown" and set the Alert Text to "You are enfeebled!". You can use the Test button to see what it would look like.

At this point the aura is configured as I need it so I can click the X in the upper right hand corner of the Modify Aura window or right click aura in the Aura configuration window. Also make sure that you have enabled the individual aura by shift left clicking it. The name will be in red if its disabled and green if its enabled.

Clicking the "Close" button on the Aura configuration window starts the Aura Engine and you are ready rumble!

VERY IMPORTANT: If you spend several hours setting up your Auras, PLEASE PLEASE PLEASE make sure you /reloadui or logout and login to make sure the Aura settings get saved, otherwise you are SOL!

Aura Shares

Aura Shares serves 2 very important purposes. The first Aura Shares lets you copy Auras between characters this way you only have to create them once and then copy them as needed. The second is the ability to export and import Auras, so you can share them with friends!

To copy the Auras from one character to another, login to the character who doesnt have the auras. Bring up the Aura Shares window by clicking the "Shares Auras" button on the Aura configuration window. You will be given a list of auras configured on your machine, with 2 filter options on the bottom. You can use them as needed to get the aura you want. Once you find the aura you would like on this character you can shift left click the aura and it will appear in your Aura list. It will be an exact copy of the original except it disables when you copy it so make sure you enable it before going to hack up some orcs.

To export an Aura, you bring up the "Aura Shares" window, find the aura you wish to export and shift right click. This will bring up a window where you can copy (Control-C) the text of the Aura to your clipboard. From there you can paste it (Control-V) to a message board, email, etc so your friends or enemies can import it.

So you were the recipient of a new uber aura and you need to know how to import it? Bring up the Aura Shares window and click the "Import Aura" button. You will be presented with a text box where you can paste the text of the Aura. Once you click "Ok" the Aura is validated. If there is any erroneous information you will get an error message letting you know. If this repeatedly happens you will want to make sure the text you are pasting looks like the text below:

{{'general-triggertype':5,'general-version':20300,'general-name':"Divine Favor",'texture-offsety':-400,'texture-scale':1.5,'texture-offsetx':600,'ability-abilityid':694,'texture-id':4646,'texture-circledimage':t,'texture-alpha':0.69999998807907}}P1

If the validation is successful, the Import window disappears and the aura appears in your Aura list!

Aura Settings

Command Line

To bring up the Aura configuration window you can use "/aura" on the command line.

You can use /aura <option> <value> with the following options to change the throttling settings for Aura

• general-effect-timers
  • Default is .4
  • This is the amount of delay between updating a timer for an Effect aura
• general-ability-timers
  • Default is .4
  • This is the amount of delay between updating a timer for an Ability aura.

General

• Aura Name: The name given to the aura by the user. This is to help the user know what the aura does.
• X: The x-coordinate relative to the center of the screen where an aura is displayed.
• Y: The y-coordinate relative to the center of the screen where an aura is displayed.
• Rotation: This allows the user to rotate an aura on the screen.
• Scale: This allows the user to increase the size of the aura on the screen
• Circle Image: This crops the aura from a square to a circle.
• Mirror Image: This mirrors the image. Note: This will not work if "Circle Image" is checked.
• Hide Image: This setting allows a user to not display an aura when it becomes activated. This is useful if you would only like sound/alert text/etc when the aura activates.

General Trigger

The following settings are used for all trigger types. Whenever an aura is checked to see if it going to be displayed, these are checked first:

• Only In Combat: The aura will only be displayed when the user is in combat.
• Only Out of Combat: The aura will only be displayed when the user is out of combat.
• Only In Group: The aura will only be displayed when the user is in a group.
• Only In War Party: The aura will only be displayed when the user is in a warparty.
• RvR Flagged: The aura will only be displayed when the user is flagged for RvR combat.
• Not RvR Flagged: The aura will only be displayed when the user is not flagged for RvR combat.

Ability Triggers

This trigger is used to let the user know when an ability is available or on cooldown. Drag and drop the ability from your Abilities Window to the square within the configuration window. This will set the ability for the trigger.

• Show When Not Active: The aura will only be displayed when the ability is on cooldown.
• Require Explicit Active Check: This forces Aura to perform an explicit check with the client to see if the ability is active. You will want to check this if the ability is reactionary, or want to make sure you have enough AP to use a style.
• Require LoS/Range/Valid Target Check: This forces Aura to perform a LoS/Range/Valid Target check on the ability.

Action Point Triggers

This trigger is used to have an aura display based upon your current action points.

• Operator: This is the mathematical operator used when comparing your current action points to the configured amount.
• Action Points: This is the number of action points used for the primary comparison.
• Enable Secondary: By checking this, you are enabling the secondary operator. This allows the user to perform a range check.
  • Secondary AND/OR: This allows the user to specify the logic used when comparing ranges.
  • Secondary Operator: This is the operator used when performing the secondary check.
  • Secondary Action Points: This is the number of action points used for the secondary comparison.
• Maximum: This displays the characters current maximum number of action points.

Career Resource Triggers

This trigger is used to have an aura displayed based upon your current career resources. It should be noted that not all classes have career resources.

• Operator: This is the mathematical operator used when comparing your current resources to the configured amount.
• Resource Amount: This is the number of resources used for the primary comparison.
• Enable Secondary: By checking this, you are enabling the secondary operator. This allows the user to perform a range check.
  • Secondary AND/OR: This allows the user to specify the logic used when comparing ranges.
  • Secondary Operator: This is the operator used when performing the secondary check.
  • Secondary Action Points: This is the number of resources used for the secondary comparison.

Effect Triggers

This trigger is used to display an aura based on effects on yourself, friendly target, or enemy target.

• Effect Name: This is the name of the effect the aura will be triggered off of. You can put multiple names here separated by a forward slash, and Aura will attempt to find all the names in an effect. You can leave the name blank, and Aura will not attempt to match names, only validate the rest of the settings.
• Type: This is the type of effect for the aura to trigger off of. If its left to *"-Any-" this check is not performed.
• Stacks: This enabled stack checking on an effect.
  • Operator: This is the operator used when performing the stack check.
  • Value: This is the value used when performing the stack check.
• Show When Not Active: The aura will only be displayed when the effect is not present.
• Exact Match: This forces the effect name comparison to an exact comparison, rather than searching an effect for the name.
• Self Cast: This forces Aura to perform a check to see if you were the one who cast an effect.
• On Yourself: This tells Aura to check effects on yourself.
• Target Friendly: This tells Aura to check effects on your friendly target.
• Target Enemy: This tells Aura to check effects on your enemy target.

Hit Point Triggers

This trigger is used to have an aura displayed based upon the percent hit points of yourself, friendly target or enemy target.

• Unit Type: This lets you select which unit Aura will use the percent hit points from for comparisons.
• Operator: This is the mathematical operator used when comparing hit points to the configured amount.
• % Hit Points: This is the number of resources used for the primary comparison.
• Enable Secondary: By checking this, you are enabling the secondary operator. This allows the user to perform a range check.
  • Secondary AND/OR: This allows the user to specify the logic used when comparing ranges.
  • Secondary Operator: This is the operator used when performing the secondary check.
  • Secondary Hit Points: This is the number of resources used for the secondary comparison.

Example Auras

This section contains information used to setup some example auras. Some will require a few minor changes based upon your class and needs, so feel free to experiment.

• I would like to know when I do not have the "Prismatic Shield" enchantment on me
  • Aura Triggered By: Effect
  • Effect Name: Prismatic Shield
  • Type: Enchantment
  • Show When Not Active checked.
  • On Yourself checked.

• I would like to know when I have "Gork Sez Stop" on me
  • Aura Triggered By: Effect
  • Effect Name: Gork Sez Stop
  • Type: Damaging
  • Exact Match checked.
  • On Yourself checked.

• I would like to know when my friendly target has a hex, so I can dispel them.
  • Aura Triggered By: Effect
  • Effect Name: ~leave this blank~
  • Type: Hex
  • Target Friendly checked.

• I would like to know when my morale level X ability is active
  • Aura Triggered By: Ability
  • Drag your morale ability to the Ability Trigger window.

• I would like to know when my morale level X ability is not active(with a cooldown timer)
  • Aura Triggered By: Ability
  • Drag your morale ability to the Ability Trigger window.
  • Show When Not Active checked.
  • Display Timer checked. (optional)