HotkeyNet Scripting

Edited 12/15/2015 – fixed broken links. Sorry people!

This page is a meant to be a helpful overview for HotkeyNet scripting for the purpose of multi-boxing. This is a reference page for my basic guide to WoW multi-boxing. The basic format for HKN scripts is:

  1. Creating a Keylist. This is a list of keys you wish to send to your second, third, etc. copies of your MMO.  These examples use WoW.
  2. Creating a Label. This labels a window by name and defines the method by which the software will transmit the information. In our case, we’ll use SendWin for the tank/main character and for the following characters we’ll use SendWinM, which will send commands to windows in the background without popping them forward. See this example image of how to rename windows to match the label in HKN, so keys will be sent correctly.  Different MMOs may require different types of send commands.  Refer to HKN documentation.
  3. Creating the actual Hotkey code, instructing HotkeyNet to send the keylist to the label when CapsLock is on. ScrollLock can also be used.

We’ll look at a couple sample scripts, then some additional snippets that you can add to your scripts for additional functionality.

Script #1: Here is example script for three WoWs on one computer, cloning the keys for simultaneous actions in each window. This script will also work for two WoWs. Adding more lines for four or five should be self-explanatory. The keylist excludes all of the common keys for character-specific functions like opening the quest log, bags, and character sheet.

//==================================================
// Script For Three WoW’S On One PC With Cloned Commands
//
// Toggle the CapsLock key to turn hotkeys off and on.
// To use Scroll Lock, replace CapsLock with ScrollLock
//==================================================

<KeyList MainKeyList A-Z, Numpad0-Numpad9, 0-9, Enter, Tab, Oem4, Comma, Oem6, plus, minus, decimal, NumpadMinus, except C, B, M, L, N, O, W, A, S, D, Q, E, X, Z, P, Space>

<Label w1 Local SendWin “WoW1”>
<Label w2 Local SendWinM “WoW2”>
<Label w3 Local SendWinM “WoW3”>

<Hotkey CapsLockon MainKeyList>
<SendLabel w1, w2, w3>
<Key %Trigger%>

Script #2: Here is a sample script for three WoW’s on one computer. The windows must be renamed WoW1, WoW2, WoW3 (tank, healer, DPS). See this image for a visual reference as to what keys are going where in this author’s three-boxing.  The DPSKeyList is sent to WoW3 to trigger skills for your DPS character. When Cntrl  is pressed, skills are sent to WoW2 for healing. When Numpad minus and decimal are pressed, these keys are cloned to all windows, instructing all characters to mount up or follow their focus target.  The multiple window labels are separated by commas in the code.  If you wanted to add a fourth and fifth character to your group as DPS, you could simply clone the instructions going to the DPS window in the same way.

//==================================================
// Script For Three WoW’S On One PC
//
// Toggle the CapsLock key to turn hotkeys off and on. (You
// can change this if you want, just like you can change
// everything else with HotkeyNet.)
//
//==================================================

<KeyList DPSKeyList F1-F12>

<KeyList MainKeyList A-Z, Numpad1-Numpad9, 0-9, Enter, Tab, Oem4, Comma, Oem6, plus, minus except C, B, M, L, N, O, W, A, S, D, Q, E, X, Z, P, Space>

<KeyList AllCharsList decimal, NumpadMinus, Oem3>

<Label w1 Local SendWin “WoW1”>
<Label w2 Local SendWinM “WoW2”>
<Label w3 Local SendWinM “WoW3”>

<Hotkey CapsLockon MainKeyList>
<SendLabel w1>
<Key %Trigger%>

<Hotkey CapsLockon Ctrl AllMainKeys;>
<SendLabel w2>
<Key %Trigger%>

<Hotkey CapsLockon DPSKeyList;>
<SendLabel w3>
<Key %Trigger%>

<HotKey CapsLockOn AllCharsList;>
<Sendlabel w1, w2, w3>
<Key %Trigger%>

The below code adds the ability to press tilde (~) to use mouse clicks in the background in the w2 “WoW2” window.

Oem3 in the script refers to the the tilde key. HotkeyNet is considered not as strong for clicking as other software, such as ISBoxer.  To click in the background WoW2 (w2) window, you’ll need to click around until you find the right spot. The reason for this is that the camera and characters in the WoW1 window where you’re clicking will not be lined up perfectly with the background window. Mostly you’ll want to put loot on free-for-all and loot with your lead character, but this code can be useful. This author uses it for skinning–the bodies of animals are a good-sized target. Note that this script snippet will conflict with script #2 above, which uses the Oem3 key (`) for something else.

<UseKeyAsModifier Oem3>

<Hotkey CapsLockOn Oem3 LButton, MButton, RButton, Button4, Button5>
<SendLabel w2>
<ClickMouse %TriggerMainKey%>

Figuring out what the codes are for various keys for the purpose of coding.

Key names vary depending on your language setting and keyboard layout. To see the name of a key on your keyboard, press it and look in the upper right corner of HotkeyNet’s main screen. (If “Show” is off, click it first.)


Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: