Hekili v2.20 is now released! The new version will wipe out old action lists and displays and replace them with new ones, so you may want to back up your SavedVariables before upgrading.
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.
Note: For Enhancement Shamans looking for more information about the recommendations, see the updated guide at Unleashed Elements. It does a good job of explaining the priority list that is used by this addon.
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.
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.
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.
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.
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 with Hekili v2.
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.
- Date created
- Nov 19, 2013
- Last update
- Feb 01, 2015
- Development stage
- GNU General Public License version 3 (GPLv3)
- Curse link
- Recent files