Get an Epic Experience with Premium


Combat Login to Add Favorites
  • World of Warcraft
  • 2,456 Monthly Downloads
  • Supports: 6.2.0
  • 164,239 Total Downloads
  • Updated 09/16/2015
  • Created 11/18/2013
  • 106 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File:
Support development! **

About Hekili

Version 6.2.0

Hekili v6.2.0 is now released! Forgive the change in version numbering; I've decided to align it with the version of WoW at time of release. The version number will have a fourth number (i.e., reflecting the addon's release number since 6.2.0 hit.

The addon presently supports Shamans (Enhancement, Elemental), Monks (Windwalker, Brewmaster, and limited Mistweaver), and Paladins (Retribution, Protection). Hunter support (all specializations) is a work-in-progress.


This update changes how some of your toggles/keybindings are managed. If your class had additional custom toggles (i.e., Shamans and Liquid Magma, Paladins and Tier 90 Talents), you may need to rebind your keys after this update. Type /hekili and see the Class Settings section to update the keybindings for your class. supports Tier 18 set bonuses and class trinkets. If you find any issues, please report them.

Getting Started

Upon installing the addon and logging in, you will be presented with two priority displays. The bottom display is your primary display, which is set to automatically switch between single target, cleave (if supported by your specialization), and AOE. The upper display is set to AOE at all times. If there is a number in the lower right corner of your AOE display in red, that indicates the minimum number of targets that the AOE display is built for. When you actually have enough targets to follow the upper display, the number in red will turn white.

By default, both displays are unlocked and can be moved by clicking and dragging the first icon to where you would like it positioned. When both displays have been placed where you want them, you can right click the first icon to lock all icons in place.

Basic Customization

There are a few basic functions you should use to get the optimal benefit of this addon. To set these up, type /hekili in your chatbox and press Enter. This will open the configuration UI to the Welcome tab, which may have useful news and updates about the current version of the addon. Below, you will find a brief explanation for each section.

Basic Settings

Under Basic Settings, there are a few options you can change to alter the function of the addon. When first getting started, the most important settings are Locked and Debug. If you want to move your displays again, uncheck Locked and move them as previously instructed. The Debug function will allow advanced users to get more information about why the displays are recommending current actions by mousing over the icon when paused.

Filters and Keybinds

Skipping over Displays and Action Lists for a moment, the Filters and Keybinds section demands some attention. In this section, you'll find a few functions that help you direct the addon how to respond to certain circumstances. As noted above, the Pause feature allows you to lock the display with what it is presently showing. If you checked Debug under General Settings, placing the mouse over an icon while paused will give you additional information about why that icon is appearing right now.

The Mode Switch is a feature that helps you to control your primary display. By default, your primary display will work by detecting how many targets you've recently hit, and recommending single target, cleave, or AOE actions based upon that information. While this is helpful most of the time, there are some fights where you would want to focus on a single-target despite having additional enemies present. Setting a Mode Switch keybind lets you change your preference in combat. Pressing your Mode Switch will tell the addon to ignore adds and focus on single-target until you press the Mode Switch again.

You can also change the Switch Type to make the Mode Switch swap between single-target and AOE regardless of the number of targets detected. This is Manual mode.

Next, the Cooldowns feature is very important. Most specializations have a few abilities that you might want to save for special circumstances in a particular fight. You can check Show Cooldowns and these abilities will be recommended as frequently as possible, when appropriate. You can also set a keybinding so you can show and hide cooldowns throughout a fight at your convenience. This is highly recommended.

You can also set keybindings to tell the addon to recommend hardcasted spells (any spell with a cast time) and interrupts (or not). You may or may not want a keybinding for these, but you should probably set a preference. Note that some action lists may not work properly when hardcasted spells are disabled (i.e., it would basically render the Elemental Shaman display inactive).


Clicking the + next to Displays will show you the default displays set up for your class' specializations. Default displays and action lists are shown in Blue. Advanced users can craft their own displays and action lists; as many as you'd like. Clicking the + sign next to a specific display will allow some additional customization. With the display itself selected, you can change the PvE and PvP Visibility. Want the addon to hide in BGs? Set PvP Visibility to "Show Never."

For visual options, click UI and Style under the display. Here, you can manually set the display's X/Y position on the screen, the number of icons to display (up to 10), the icon spacing, direction, size, and so forth.

Action Lists

Clicking the + next to Action Lists will show you all the lists that are processed to make your displays work. They are closely based on SimulationCraft action lists, with minor tweaks and adjustments when necessary. If you are familiar with SimulationCraft profiles, you shouldn't have too much trouble reading each action and its criteria and seeing how they work.

Advanced Users

For users interested in making their own displays and action lists, please refer to the Advanced Usage guide, which is a work in progress.


Q. Can you add Masque support?

A. It's been in for a long time! I've recently made the addon more frequently and more aggressively check for Masque if you've installed that addon separately. If it still doesn't work, keep frequently asking me until I figure out why.

Q. I only want one display that will automatically switch between single-target and AOE. What's the best way to do that?

A. The primary display will behave this way by default. You can just turn off the AOE display by going to /hekili > Displays > (spec): AOE and unchecking Enabled. Double-check the Filters and Keybinds section to be sure that the Switch Type is set to Auto and the Current Mode is Auto as well. Again, it is highly recommended that you bind a key for your Mode Switch, so you can tell the addon to restrict itself to single-target situations when you need it to.

Q. I want the primary display to only show me single-target. What's the best way to do that?

A. Under Filters and Keybinds, make sure the Current Mode is set to "Single Target."

Q. This addon is bad. It tells me to do something other than what I want to do.

A. It's a priority helper. If it told you to do what you were already doing, it wouldn't be helping you. Also, this isn't a question. But seriously, there could be a couple of good reasons the addon shows you something different than you were expecting. In the vast majority of cases, the addon is identifying circumstances that might not be as easy to track as a living, fleshy creature. Use the Debug and Pause features to see why the recommendation is made. Otherwise, maybe it's a bug! I update the addon as often as possible and actively work to translate SimulationCraft profiles soon after any critical updates. Sometimes, that means I have to add a feature to the addon. Sometimes, there's a translation error. Post a ticket and let me know if something seems broken!


The major features added to the addon since the last release are:

  • Improved and updated action lists for all supported specializations. Default action lists and displays will be automatically updated.
  • Limited SpellFlash support (on a per-display basis).
  • Set keybinds to toggle your cooldowns, interrupts, hardcasts, or mode -- single target, cleave, or AOE. These toggles will dynamically show or hide action lists or abilities that don't meet your current criteria.
  • Use a keybind to pause the addon. A debugging mode is also available to show detailed tooltips when paused, to see exactly why a particular icon is shown at a particular time.
  • Ongoing optimization of the main engine. Instead of constantly updating every potentially useful bit of information, the addon now calculates each bit of information on demand.


Bear in mind, your settings from the 5.x version of this addon will not work with 6.0. The new version will reset any profile that wasn't created since Warlords of Draenor launched..


Feel free to contact me directly if you have any issues. Private messages work well. Submitting a ticket is good as well. I do NOT get notifications if you comment on this page, unfortunately.

You can reach me on the MMO-Champion forums as Hekili, or on Twitter as @Hekili808.

r220 | kapulani | 2015-07-03 19:41:36 +0000 (Fri, 03 Jul 2015) | 3 lines
Changed paths:
   M /trunk/Classes/Paladin.lua
   M /trunk/Options.lua

Correct avenging_wrath charges based on T18 2pc, not class trinket.  (Hopefully fixes reported issue.)

'/hekili force' will open the UI even if in-combat.  Also a good name for a fan club.
r219 | kapulani | 2015-06-30 07:36:53 +0000 (Tue, 30 Jun 2015) | 1 line
Changed paths:
   M /trunk/Classes/Hunter.lua
   M /trunk/Classes/Monk.lua
   M /trunk/Classes/Paladin.lua
   M /trunk/Classes/Shaman.lua

Bump all displays/action lists to make sure that the Mode Overrides are properly set.  You need this if your AOE and Primary displays appear to make the same recommendations no matter what Mode you've set.
r218 | kapulani | 2015-06-30 00:15:46 +0000 (Tue, 30 Jun 2015) | 5 lines
Changed paths:
   M /trunk/Classes/Paladin.lua
   M /trunk/Classes/Shaman.lua
   M /trunk/Classes.lua

Mode Overrides will be reset on default displays when updated.  This restores default behavior for auto/single/AOE modes.

Added healing_stream_totem for Shamans.  May be some glyph/talent behavior that requires being accounted for.  Please report bugs.

Fixed hammer_of_wrath to account for the perk.empowered_hammer_of_wrath spell ID change.  (Was broken by fix for Hunter's kill_shot.)
r217 | kapulani | 2015-06-28 00:51:07 +0000 (Sun, 28 Jun 2015) | 6 lines
Changed paths:
   M /trunk/Classes/Hunter.lua
   M /trunk/Classes/Paladin.lua
   M /trunk/Core.lua

Clunky Hunter test fix for MM's enhanced_kill_shot perk.  It changes the spell ID to 157708 for MM, but IsSpellKnown() still requires the original spell ID.

Paladin module will use hammer_of_wrath's spell ID instead of name (for consistency) when checking IsUsableSpell().

Display engine will also use spell IDs for IsUsableSpell().

r216 | kapulani | 2015-06-25 17:39:38 +0000 (Thu, 25 Jun 2015) | 5 lines
Changed paths:
   M /trunk/Classes/Monk.lua
   M /trunk/Classes.lua

Add 'Queue Alignment' to list of settings not overwritten when default displays are updated.

Add spear_hand_strike to BM, WW default APLs.

Add aura for tigers_lust to Monk module.
r215 | kapulani | 2015-06-25 02:58:45 +0000 (Thu, 25 Jun 2015) | 1 line
Changed paths:
   M /trunk/Classes/Paladin.lua

Flag avenging_wrath as unusable when buff.avenging_wrath.up is true.
r214 | kapulani | 2015-06-24 01:39:30 +0000 (Wed, 24 Jun 2015) | 5 lines
Changed paths:
   M /trunk/Classes/Paladin.lua
   M /trunk/Classes/Shaman.lua
   M /trunk/Classes.lua

arcane_torrent is now treated as a cooldown.  It probably should be enhanced further, in case people want to save it as an interrupt.

Add toggle.cooldowns to Enh: Default action list for arcane_torrent.

Emulated liquid_magma buff will no longer be faked if you haven't actually talented for liquid_magma.
r213 | kapulani | 2015-06-23 06:58:09 +0000 (Tue, 23 Jun 2015) | 2 lines
Changed paths:
   M /trunk/Hekili.toc

Update TOC for 6.2.0.
Start new version numbering at
r212 | kapulani | 2015-06-22 08:08:08 +0000 (Mon, 22 Jun 2015) | 1 line
Changed paths:
   M /trunk/Hekili.toc

Wake up, CurseForge packager.
r211 | kapulani | 2015-06-22 07:51:47 +0000 (Mon, 22 Jun 2015) | 9 lines
Changed paths:
   M /trunk/Classes/Hunter.lua
   M /trunk/Classes/Monk.lua
   M /trunk/Classes/Paladin.lua
   M /trunk/Classes.lua
   M /trunk/State.lua

Added support for prev.X syntax.  prev.crusader_strike returns true if the last successful cast was crusader_strike (treats predicted actions as successful casts).

Added T18 bonuses to Hunters.
Corrected "t17_2pc" to "tier17_2pc".
Added support for five_stacks modifier to focus_fire.

Added T18 bonuses to Monks.  Unable to test the charges for guard right now.

Added T18 bonuses to Paladins.  Unable to test the charges for avenging_wrath right now.
r210 | kapulani | 2015-06-22 04:46:22 +0000 (Mon, 22 Jun 2015) | 15 lines
Changed paths:
   M /trunk/Classes/Hunter.lua
   M /trunk/Classes/Monk.lua
   M /trunk/Classes/Paladin.lua
   M /trunk/Classes/Shaman.lua
   M /trunk/Events.lua
   M /trunk/Options.lua
   M /trunk/State.lua

*** This is the 6.2 preliminary alpha with Shaman adjustments built in.  Hunters, Monks, and Paladins should not download this version, as I haven't tested their changes yet. ***

Added class trinkets to Hunter.lua Monk.lua Paladin.lua Shaman.lua you're wearing yours, t18_class_trinket will evaluate to 1.

When scanning your talents, talent.X.enabled will return T/F.  talent.X.i_enabled will return 1/0.  This is used for some mathematical tricks in the Elemental Shaman profile, etc.

The importer has been tuned to check if you're trying to do math with talent.X.enabled and will convert it to talent.X.i_enabled

The importer will no longer convert set_bonus.X=0 or set_bonus.X=1 to set_bonus.X.  set_bonus.tier17_4pc will now return 1/0; custom action lists may need to be updated.

The importer will convert 'spell_targets.X' to 'active_enemies' or 'my_enemies' based on your Target Counting setting.

Corrected an improper message in the importer (removing an energy cap check for Fists of Fury).

buff.X.duration debuff.X.duration and dot.X.duration will return the expected base duration for that aura, if it is available.
r209 | kapulani | 2015-05-28 02:36:47 +0000 (Thu, 28 May 2015) | 1 line
Changed paths:
   M /trunk/Core.lua

Try using HasVehicleActionBar() instead of UnitInVehicle( 'player' ) for hiding the display.


First Previous Page 1 of 16 Next Last
  • #283

    Great addon, I hope it will extrend to warlocks and other classes.

    One question though, on my MM hunter, Steady Shot doesn't show in the rotation?

  • #285

    It's a bug.  Hunters are not well supported at this time.  I'll take a look at it, but I really want to rebuild the engine (again!) to better handle abilities with travel times and so forth.  Casters and hunters are most impacted by those issues.

  • #282

    I absolutely love this addon. I use it on my Ret, Hunter and Ele and would love to use it on my other toons esp my Fury Warrior. Have you any plans to extend the addon to include other specs? 

    Anyways just wanted to say thanks for the work you do and I hope you keep doing it!

  • #284

    Sorry, comment system is acting up.

    Warriors are very hard to model reliably because timing rage gains from auto-attacks is problematic.  There seems to be a lot of "wobble" with the swing timer.  When I come up with a reliable way to smooth that out, so the recommendations are consistently accurate and don't flicker, then a Warrior module would be viable.

    Last edited by kapulani on 11/6/2015 10:06:32 PM
  • #280

    Such an amazing addon thank you very much. Please add support for more classes. I don't want to play without it anymore.

  • #279


    so is hekili better than ovale? Does they have same stuff or what

  • #281

    Ovale is script based (using simC rotations). It does what you want it to do (can be modified). And works for nearly every specs.

    Hekili is a built in rotation helper. It will tell you what to do and you can't change it (but it should be accurate). And works for a selected few specs.

    Why not try both if your spec is supported ? It's free and the best way to see which one you prefere.

  • #287

    lol What?

    Hekili is also based on simulation craft...and you can even import your own script. Please don't spread misinformation.

    Last edited by Adrenal1ne on 11/12/2015 12:44:26 AM
  • #286

    Uhh, what?

    Both use scripts, both are closely based on SimulationCraft.  The main difference for Hekili over most other priority helpers is that this addon will also look several steps into the future, factoring in all predictable variables like resource gains, cooldown resets, buff gains/expiration, and so forth.

    Whether that's a feature that's relevant to your preferences is up to the individual user

  • #278

    Man, if you made a rogue module I would be really happy. I had to settle for making myself a much crappier rotation helper with weakauras... it's so incredibly inferior after using Hekili on my ret.

  • #274

    Hi Kapulani,

    Great addon thank you for all your work, I don't belive that Ret is currently funtioning correctly as far as T18 2 set bonus is concerned regarding the cooldown of AV as the addon is trying to string them together instead of using AV every 1 min in conjuction with ES for max benifit or at least this is I'm lead to believe. 

  • #277

    I am posting a beta with newly imported action lists.  I'll see if that fixes it, or if I need to adjust the set bonus further.

  • #271

    How do I change the look of the Helkili Icons, not just their spacing and size?  Such as zoom to make them more square and less rounded.  I enjoy the look in the screenshots, but I can't achieve it. 

    Last edited by Eolass on 8/26/2015 9:11:54 AM
  • #276

    I use the Masque addon.

  • #268

    how does the addon work with the class trinket? as shaman i get to recast the flame shock after 30 seconds, even if the debuff has 45  seconds on the boss. why does the addon not check the class trinket? help pls 

  • To post a comment, please login or register a new account.
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

Wildstar Skinned PC Giveaway