Last Updated: Jul 17, 2018 Game Version: 8.0.1


Nov 18, 2013

Owner: kapulani

Hello everyone!


Version has been released for Legion. Please report any issues you experience via the CurseForge Ticket system. I do not receive notifications about comments posted below.

What is Hekili?

Hekili is a priority helper addon that can make recommendations several steps into the future. It works by collecting information about the game's current state, using a SimulationCraft-like action priority list (APL) to recommend the next ability to use, then modifying the game state and making the next prediction.

In Legion, the addon supports the following specializations:
Death Knight - Frost, Unholy
Demon Hunter - Havoc, Vengeance
Druid - Feral, Guardian
Hunter - Beast Mastery, Marksmanship, Survival
Monk - Brewmaster, Windwalker
Paladin - Protection, Retribution
Rogue - Subtlety
Shaman - Elemental, Enhancement
Warlock - Affliction
Warrior - Arms, Fury
For Battle for Azeroth, efforts are being taken to make expanding the addon's support to all DPS and tanking specs more realistic and maintainable.  So that's the goal.

Action Lists / Recommendations

The action lists are visible in-game, accessible via /hekili > Action Lists. The default action lists tend to be imported directly from SimulationCraft, with a few custom tweaks to allow for special Class Settings to be integrated. (You can see the Class Settings through the /hekili interface as well.)

Action lists are presented when attached to a display. You can have an unlimited number of displays, though the addon comes pre-loaded with two displays. Through the /hekili interface, you can customize these defaults.

  • Specialization Primary - With the default settings loaded, the primary display will automatically present the next four recommended abilities with consideration for the number of enemies. This display reacts to the Current Mode option found in /hekili > Toggles. The default behavior reflects a Current Mode set to "Auto." If the Current Mode is set to "Single Target" then the primary display will show recommendations based on the assumption that there is only 1 target in range of your abilities.
  • Specialization AOE - With the default settings loaded, the AOE display will be hidden. This is because the Specialization Primary display automatically adjusts to Single Target vs. AOE when /hekili > Toggles > Current Mode is set to "Auto." The AOE display would be redundant under those circumstances. However, when the Current Mode is set to "Single Target", the Specialization Primary display will only show Single Target. This display then appears to provide you recommendations assuming there are 3 or more targets.

Getting Started



Alternate Customization


Enhancement Shaman, Primary Display, Current Mode: Auto

Above is the default Enhancement Primary display. The Current Mode is set to Auto, so this display will automatically adjust to the number of enemies that are detected by the addon.

Enhancement Shaman, AOE (top) and Primary (bottom) dsplays, Current Mode: Single

This shows both displays, because Current Mode is set to Single Target, forcing the Primary display to pretend there is only 1 target no matter how many are detected. Under those circumstances, the AOE display appears to give you these alternate recommendations.

Note on 'Current Mode' Setting

In the vast majority of cases, the Current Mode: Auto setting will be optimal. However, sometimes there are special mechanics in a fight that involve wanting to focus on one enemy at a time rather than maximizing DPS across multiple targets. In this case, it can be helpful to force both displays to be shown. You can set a keybinding to toggle this setting while in-combat. Bind a key for Mode Switch under /hekili > Toggles.

The Mode Switch is sensitive to two factors: the Switch Type and the Current Mode.

1. If Switch Type is "Auto", then pressing your Mode Switch key will toggle between Auto (using actual detected target counts) and Single Target.

2. If Switch Type is "Manual", then pressing your Mode Switch key will toggle between Single Target (forcing 1 target regardless of count) and AOE (forcing the addon to believe there is a minimum of 3 targets). This impacts your Specialization Primary displays only.

Other Customization

You are able to customize displays further. You can change the direction of your recommendation queues, modify its alignment, turn on Blizzard's overlay glow for the first recommendation icon in your display. You can specify that up to 10 icons are shown (more recommendations equals more processing power, though!), change the spacing, the zoom, the primary and queued icon sizes. You can specify the font and font sizes. You can specify that some additional information should appear on the base of the primary icon. You can use SpellFlash if you have that addon loaded as well.

You can use the Masque icon to apply a custom style to your displays.

You can specify visibility in PvE and PvP settings with custom alpha/transparency settings for each. You can specify special Conditions using the SimulationCraft-like syntax used in the Action Lists (this is how the Specialization AOE displays are scripted to see if your Current Mode is "Single Target").

Enhancement Primary, with customized settings to show 2 icons, with the second recommendation smaller than the first.

A display like the above can be created by going to /hekili > Displays > Specialization Primary > UI and Style and adjusting the following:

1. Set Icons Shown to 2.

2. Set Queued Icon Size to 30.

Enhancement Primary, 5 queued icons, with first recommendation at the bottom.

A display like the above can be created by going to /hekili > Displays > Specialization Primary > UI and Style and adjusting the following:

1. Set Icons Shown to 5.

2. Set Queue Direction to Up.

3. Set Queued Icon Size to 30.

Enhancement Primary, 1 recommendation.

A display like the above can be created by going to /hekili > Displays > Specialization Primary > UI and Style and adjusting the following:

1. Set Icons Shown to 1.

(Hey, that looks a lot like a single-icon priority helper WeakAura!)


1. There's nothing showing!

A. Did you use this addon before Legion? You may have old, incompatible data in your profile. Go to /hekili > Profiles and click Reset Profile to start from scratch. You may want to reload your UI at that point as well.

2. There's still nothing showing!

A. /hekili > General: Make sure Enabled is checked. If it's not checked, the addon may have detected an error and shut itself off. If that is the case, use an addon like BugSack/BugGrabber to collect any error messages and submit it via the ticket tracker (linked above). If the addon is enabled and nothing is showing, check your displays. /hekili > Displays > Specialization Primary and Specialization AOE: Make sure Enabled is checked. If your issue is with one of the default displays, you can reload the display with the Reload Display button at the bottom and see if it is restored.