Get an Epic Experience with Premium


Combat Login to Add Favorites
  • World of Warcraft
  • 6,055 Monthly Downloads
  • Supports: 6.2.0
  • 174,362 Total Downloads
  • Updated 02/03/2016
  • Created 11/18/2013
  • 115 Favorites
  • Project Site
  • Comments
  • Release Type: Release
  • License: GNU General Public License version 3 (GPLv3)
  • Newest File:
Support development! **

About Hekili

Version 6.2.3

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
  • #299

    What is the Icon skin in the 1/8 screenshot? 

  • #300

    CleanUI Thin.

  • #294

    I would like to suggest making display characteristics, such as size, location, orientation, opacity, etc. separate from any other settings. My main is a paladin and I configured your addon perfectly, but I boosted a hunter and when I select that paladin profile, I get paladin entries and nothing changes to the hunter entries.

    Do I have to manually copy every display detail to my hunter's profile or is there some kind of hidden option I'm missing?

  • #297

    You can import the displays individually and then attach the Hunter action lists yourself.  It's not elegant, but it's an option.

  • #290

    I can't seem to find a Hekili command to run as part of a macro that would toggle my mode between single target and AoE.  Does such a command exist?  I've been poking around for about an hour to find it and have wound up empty handed. =(

    Thanks for making such a great addon and providing such fantastic support!

  • #295

    /run Hekili:ToggleMode() works for me

  • #291

    Sorry for the long delay in response.  I should probably put in such a command.

  • #293

    That would be awesome.  Thank you very much!

  • #289

    Is there an option that makes the addon display red or grey when you are out of range of the target? Currently defaulted it will show you are able to use the ability on the target even if the target is out of range.

  • #288

    Do you plan on continuing to support this addon in 7.0?

  • #292

    Yes, but the engine will get rebuilt.

  • #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
  • 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 »

Darkest Dungeon Wiki Editing Contest