• After installing Hekili, open World of Warcraft.
• If already opened, you may use the command /reload ui.
• Upon entering the game, you will be able to see a panel of four icons -- this is the addon's default layout.
• You can open the settings by typing /hekili or using the mini-map icon

[!CAUTION] You absolutely should not import a simc priority into the addon that you received from simming yourself unless you are an experienced/advanced user of the addon. This is misinformed advice and will almost certainly worsen your experience using this addon. This is designed for experimenting/tinkering, not general use.

[!TIP] The following section will give an overview of the settings. If you would like to see recommendations on what settings to use, you can check out the Configuration Guide by one of our community members.

Overview of the addon settings

Toggles: Display Control

The addon's default mode is to show you the Primary display, which will automatically adjust itself based on the number of enemies detected and other factors. This is called "Automatic" mode and it generally works for most people.

However, sometimes you may want single-target recommendations despite there being multiple enemies, or you might want multi-target recommendations even before multiple enemies have been detected. You can tell the addon what you want it to show you using the Mode toggle, which is ALT-SHIFT-N by default. This setting is found in /hekili > Toggles. It has two components: You have the toggle keybind to cycle through the modes you like to use, and a series of checkboxes to identify your preferred modes.

Display Mode	Description
Automatic	The default, as described above.
Single-Target	The Primary display to act as though there is only 1 target, even if multiple are detected. This mode is useful if a boss has a bunch of adds that you can ignore while you focus on burning down your target.
AOE (Multi-Target)	The Primary display to act as though there are multiple targets, even if only one was detected. This can be useful when playing a ranged specialization and there are distant targets that you have not yet injured.
Dual	The addon to show both the Primary display and the AOE display at all times. The Primary display provides single-target recommendations, while the AOE display provides multi-target recommendations.
Reactive Dual Display	The addon to show single-target recommendations in the Primary display. When additional targets are detected, the AOE display will also appear to provide multi-target recommendations.

Toggles: Damage Cooldowns, Interrupts & Defensives

By default, the addon does not show your damage cooldowns, interrupts, potions, or defensive abilities. You can use a keybinding to toggle these on/off. The defaults are:

• Cooldowns: ALT-SHIFT-R
  • Minor Cooldowns: ALT-SHIFT-G
• Interrupts: ALT-SHIFT-I
• Defensives: ALT-SHIFT-T
• Potions: NOT BOUND

When a toggle is turned off, any abilities in that category will be disabled. For example, the Cooldowns toggle lets you turn off recommendations for your big damage cooldowns until you toggle them back on. This is useful because sometimes you are saving cooldowns for a specific phase of a boss fight, or you may simply wish to manage cooldown usage on your own.

For Interrupts and Defensives, you can check Show Separately on the /hekili > Toggles section in order to have those recommendations appear in their own displays rather than mixed into the Primary or AOE displays.

Visual Display

With the addon settings opened, you can move the configuration interface out of the way and click and drag the displays where you want them on your screen.

In the Displays Section you can also adjust

• Size, Positioning and Number of icons displayed
• Spacing, borders, visibility/alpha,
• Keybinding text
• Glow effects, Spellflash, indicators (target-swap, cancelaura, target count), range-check

Each display (Primary, AOE, Defensives, Interrupts) can be configured independently, and the primary icon (current recommendation) can be configured separately from the queue (future recommendations). The Notification panel has its own settings, and is where notification text appears when you toggle a feature on or off.

Spec Specific Settings

Core

Here you can choose your spec and explore the built-in options. Feel free to experiment with them and find what works best for you.

[!TIP] Mousing over the options will give a more detailed explanation in the tooltip

[!NOTE]
The blue-text spec sections contain the APL. This is for advanced/experimental users, and you shouldn't touch it without the understanding that you may break things and be forced to reset your pack back to the default. It can, however, be useful to browse and try to get an understanding of what the APL is doing.

Targeting & Performance

These sections allow you to choose your targeting and performance options. See the configuration guide for more information and recommended starting points.

Abilities, Gear and Items

Here you can

• Enable/disable specific abilities / items
• Override the keybind text
• Swap in your own icons
• Set a minimum or maximum target count
• Assign them to a toggle
• Make the addon pretend an ability is off CD slightly early to increase its cast priority

See the configuration guide for ability/item recommendations.

Snapshots and Reporting

This section contains what you need to report an issue or receive help from the developer or a community member, either via a Github issue or in the Discord. For more information, see Report an issue.

[!TIP] If you are having an issue with the rotation itself, the first question anyone will ask you is "do you have a snapshot". This means to take a snapshot when you see the issue in the rotation. You can save some time by having this ready ahead of time. And always remember to read the [FAQ] First!