Warning: Upgrading from Kong v0.8a or earlier while World of Warcraft is running could cause your current Kong settings to be erased!

New: Kong now supports Profiles!

What is Kong?

Kong UI Hider is a small addon that can automatically fade out elements of the user interface (Minimap, PlayerFrame, Recount, etc.) and then show them again when moused-over, entering combat, or any of several other user-specified conditions are met.

Using Kong to Hide the User Interface

In order to hide any part of the User interface (UI), you must tell Kong to hide it. To do this, first position the mouse over the component you want hidden, then type:

/kong hide

That's all there is to it! You will notice that component will now slowly fade out when the cursor is moved elsewhere. However, if you return the cursor to the component, it will quickly fade back into view.

Note: It is important that cursor is always over the frame that you want to configure when issuing /kong commands. Each hidden frame has its own individual settings, and Kong uses the cursor to know which frame to configure.

Basic Customization

By default, any frame that is hidden by Kong using /kong hide will be shown under the following three conditions:

1. The cursor is moved over the component
   
2. The player enters combat
   
3. The player enters a vehicle
   

This behavior can be customized using additional /kong commands. For example, to prevent a frame from appearing in combat, one can again place the cursor over the target component and type:

/kong combat hide

Once this command is issued, the frame will remain hidden until one of the other conditions listed above occurs. Similarly,

/kong vehicle hide

will prevent the frame from appearing while the player is riding on a vehicle.

In the event that one wishes to restore default combat and vehicle functionality, this can be done using the following :

/kong combat show
/kong vehicle show

Displaying the UI While Out of Combat

You may want certain frames to only appear when out of combat. This functionality is disabled by default, but can be enabled using:

/kong combat hide
/kong nocombat show

Macro conditions

Advanced users may want to take advantage of Kong's support for macro conditions to customize the visibility of their UI. The command /kong macro set, when given a macro condition inside [square brackets], will cause a UI component to be shown or hidden based on the given condition. For example:

/kong macro set [exists]

will show a frame when you have a target selected. The command:

/kong macro set [group:raid]

will show the frame when you are in a raid.

If at any time you wish to remove the macro condition from a frame, /kong macro clear can be used.

For a complete list of all the possible conditions, see http://www.wowwiki.com/Making_a_macro#Conditionals.

Mouseover Groups

Sometimes it may make sense to show several different frames when any of them are moused-over. For this purpose, Kong provides the /kong group command. This command takes an action (either add or remove) and a user-specified group name. For example:

/kong group add group1

will add the frame under the cursor to a group named 'group1'. The command must then be repeated for any other frames that you want to add to the group.

To remove a frame from a group, /kong group remove, followed by the group name will remove the frame from the mouseover group:

/kong group remove group1

Transparency

For those who want to further customize the way Kong displays the UI when fading components in and out, Kong offers a few additional commands. One of which, /kong alpha, can be used to configure the transparency of a component when it is being shown or hidden. This command must be passed the fade-direction (in or out) and the alpha (a value between 0 and 1 where 0 is completely transparent and 1 is opaque). For example, the command:

/kong alpha out .5
/kong alpha in 1

instructs Kong to display the frame at half alpha when faded out and full alpha when faded in. Likewise,

/kong alpha out 0
/kong alpha in .5

tells Kong to only display the frame at half alpha when faded in and hide it completely otherwise.

Fade Speed

Kong also allows you to customize the speed at which frames fade in and out. The command /kong speed takes a fade direction (in or out) and a duration (in seconds) over which the fade duration should take place. For example:

/kong speed in 0

will cause the frame under the cursor to fade in instantly, rather than over the default duration of .2 seconds. Fade duration can also be increased:

/kong speed out 3

This will cause the UI component to fade out over the course of 3 seconds each time it is hidden.

Condition-Specific Settings

Kong also allows condition-specific customizations. For example, say that we want a frame to appear instantly when moused-over, but fade in slowly when displayed for other reasons:

/kong mouseover speed in 0
/kong speed in 1

Here, the command /kong speed essentially sets the default fade-in speed, while /kong mouseover speed overrides that default with a condition-specific fade speed. The same overrides could be done for other conditions. For example:

/kong vehicle alpha in .3
/kong alpha in 1

will show the UI component beneath the cursor at only 30% alpha when in a vehicle, but fade it in to 100% when any other condition applies.

Disabling Kong

Sometimes you may want to be able to see the entire UI all at once without entering combat, etc. In these cases you can disable Kong, which will cause all hidden frames to be immediately shown. This can either be done by configuring a key to disable Kong in the Keybinds menu, or by issuing the following command:

/kong disable

Once Kong is disabled, you can re-enable it using either /kong enable or /kong toggle.

Experiment

You may have to play around with Kong to really get a feel for it. If you need help remembering commands in game, simply typing /kong will bring up a list of commands with brief descriptions, and typing /kong followed by a command will often give more specific details on the command.