Difference between revisions of "ISBoxer:World of Warcraft"

From Lavish Software Wiki
Jump to navigation Jump to search
Line 1: Line 1:
== Overview ==
+
This page is about [[IS:ISBoxer|ISBoxer]], specifically regarding World of Warcraft.
== Considerations ==
 
  
== Playing non-main characters ==
+
== Is this allowed by Blizzard? ==
There is basically 4 ways of handling the ability to play any character as the main character (for targeting and following).
+
; Multi-boxing
 +
: Multi-boxing is allowed by Blizzard. There are many resources that can be found with details, but here is one of them from WoW Insider: [http://www.wowinsider.com/2008/08/26/chilton-content-to-endorse-multi-boxing/ Chilton content to endorse multi-boxing]
  
; Manual vs Automatic assist
+
; Using Inner Space and ISBoxer for multi-boxing
The first determination you should make is whether you want to manually press an assist key, or have WoW macros that automatically assist for you. The difference is in the number of WoW macros needed -- one assist macro total, or one assist macro per ability (that also casts the ability).
+
: This is where it gets hairy, no matter what software the question is about. The answer most commonly received when asking a Blizzard Customer Service Rep (e.g. GM) is that as long as you are at the keys, pressing the buttons, and no automation is being performed, and no delayed actions are used (i.e. something only happens as an instant response to your manual toggling of inputs), and the game data (e.g. your character's health, mob locations, ability cooldowns) is not being read or modified by other software, then it is not a violation of the [http://www.worldofwarcraft.com/legal/termsofuse.html World of Warcraft Terms of Use]. '''ISBoxer is specifically crafted to help configure multi-boxing with Inner Space while abiding by the rules.'''
; Focus Target or "FTL" Modifiers
+
: Anecdote: I have been multi-boxing in World of Warcraft for several months. My actual characters are shown in the ISBoxer and configured-by-ISBoxer gameplay videos. My accounts (which are in my real name, with my real information, paid for by my real credit cards, and note that Blizzard is well aware of my real name and related information) are in good standing, even though a handful of people told me they were reporting me. I explain to these people that multi-boxing is allowed (I get one every few weeks or so that apparently doesn't know that), and I am not secretive that I use Inner Space and ISBoxer -- I tell anyone that asks. A lot of people are now multi-boxing with ISBoxer as well, and there have been zero reported bans or suspensions.  
Next, determine whether you want to use the Focus Target to determine who to follow and assist or not. If you do not use the Focus Target feature in World of Warcraft while multi-boxing, using the Focus Target is much less complicated. The difference otherwise is the complexity of the WoW macros needed -- using Focus Target simplifies the macros, while using modifier combinations (e.g. shift+alt, ctrl+alt, etc) vastly complicates the macros. Another worthwhile point is that with Focus Target, your each character's name appears in exactly one macro per character, while with modifier combinations, each character's name appears in one macro per ability per character -- in other words, if you want to swap another character in place of another (say, changing out one class for another such as a tank), modifier combinations make this increasingly difficult while it would take only a moment to change a Focus macro. And finally, using modifier combinations may actually require un-binding many WoW keys, as a key bound to, for example, CTRL+1 being a key bind in WoW will prevent CTRL from being used in modifier conditional macros for the 1 key.
 
  
So here are the 4 possible combinations:
+
== Terminology ==
# Manual Assist, Focus Target assist: Easy setup, few simple WoW macros
+
; Focus Target
# Manual Assist, modifier-based assist: Easy setup, few complex WoW macros
+
: World of Warcraft allows you to keep a secondary target, called the Focus Target. Many players do not even know what this is, or cannot fathom a use for it (or have an Addon that helps with what they would be using it for anyway), and so it becomes a good way to keep a permanent target of the Hot Character.
# Auto Assist, Focus Target assist: Complex setup, many simple WoW macros
+
; FTL
# Auto Assist, modifier-based assist: Complex setup, many complex WoW macros
+
: FTL is short for Focusless, Targetless, Leaderless. This is the phrase used to describe configurations, particularly in World of Warcraft, where specifying the Hot Character is done by different combinations of shift, alt, and control keys. In-game macros (built with the game's macro system) check which keys are pressed and depending on the combination, the 'slave' windows will, for example, cast a spell on that character's target.
 +
; Hot Character
 +
: As defined in the ISBoxer Glossary: Hot Character means the Character currently being played (the active, focused, foreground, etc window).
  
Configuration for all 4 combinations will be detailed in the following sections (currently under construction).
+
== World of Warcraft Macro features in ISBoxer ==
 +
[[Image:ISBoxerWoWMacro.png|right|451px|thumb|. Click to enlarge.]]
 +
The ISBoxer Toolkit can now export an actual World of Warcraft Addon (called ISBoxer) capable of creating Macros and assigning them to Key Bindings in the game.  
  
=== Manual Assist ===
+
Macros are created on a Character-per-Character Set basis, meaning that a Macro that is only used on a given Character when playing a given Character Set will not interfere with a different Macro on the same keystroke when playing a different Character Set. It is important to note that there is absolutely no communication between the Addon and Inner Space or ISBoxer -- this feature is implemented via automatic Virtual Files. Slightly technical explanation follows (you can skip it if you are not interested in the details): When Exporting to Inner Space, the Addon is generated with a dummy Lua file for a Character Set (ISBoxer_Character_Set.Lua), and a dummy Lua file for a Character (ISBoxer_Character.Lua). Those 2 files are then Virtualized, sort of like a symbolic link active for a single instance of the game, such that when the game loads the 2 Lua files, the files that are loaded in place are e.g. ISBoxer_Character_Set-My Character Set.Lua and ISBoxer_Character-My Character.Lua.
==== Using Focus Target ====
 
==== Without using Focus Target ====
 
  
=== Automatic Assist ===
+
ISBoxer World of Warcraft Macros are bound to keys using Override Key Bindings. This means that you can replace (i.e. Override) your existing Key Bindings when multi-boxing with ISBoxer, and still have them as they were before when not multi-boxing with ISBoxer. Override bindings are not stored and do not un-bind existing Key Bindings.
==== Using Focus Target ====
 
==== Without using Focus Target ====
 
  
== Old info while the rest is under construction ==
+
ISBoxer World of Warcraft Macros are much like many Macro addons (Macaroon, Super Duper Macro, etc): created on invisible buttons using the "macro" type and "macrotext" attribute and the Override Key Bindings are set to click the button. This means no existing World of Warcraft Macros will be modified and any number of Macros can be created, each up to 1023 characters in length (so I've read).
=== World of Warcraft: Using Hot Character switch notifier ===
 
  
The Hot Character switch notifier feature of ISBoxer can be used to notify all Characters of the current Hot Character. In World of Warcraft, this is typically used to set the Focus Target (there may be equivalents in other games that can be used in a similar fashion). If you are not familiar with Focus Target in World of Warcraft, it is basically an additional unit portrait frame that can be used to help cast spells on, follow, or assist a specific player. If you do not intend to use Focus Target for another reason while multi-boxing, and do not mind manually pressing an Assist key to make your followers assist, this is the simplest and easiest method to be able to switch to using any of your Characters as the main while playing.
+
There are two ways to create a World of Warcraft Macro through ISBoxer Toolkit:
 +
# Automatic generation of a Focus Target Macro (see Hot Character switch notifier section below)
 +
# When creating a Mapped Key, select "New World of Warcraft Macro Action" to create a Keystroke coupled with a World of Warcraft Macro, which is fully configurable (see Mapped Keys: World of Warcraft Macro Action section below)
  
An alternative method is configuring a bunch of World of Warcraft macros to determine which modifier keys are held down, and automatically assist a different player accordingly (see Using FTL Modifiers, below) -- this would remove the need to press an Assist key, but requires a lot of extra work, a lot of extra keys, and is quite confusing to the typical player. Using the Focus Target method requires very little additional World of Warcraft configuration, and does not require replacing your Action Bar buttons with macros, creating a separate macro for each action, or un-binding any World of Warcraft key bindings.
+
=== Mapped Keys: World of Warcraft Macro Action ===
 +
As of ISBoxer Build 23, ISBoxer has a new type of Action for Mapped Keys that doubles as a Keystroke Action, but can also create and bind a World of Warcraft Macro. This section will explain the additional features of the World of Warcraft Macro Action. The image on the right will help you follow along. There are only a few options, so this won't take but a moment.
  
==== Step 1: Create World of Warcraft macros ====
+
Before I continue, let me explain that the Key combination '''must''' be configured, and the World of Warcraft Macro will automatically be bound to this key combination to match the keystroke being sent. It is acceptable (and perhaps recommended in many cases) to use obscure key combinations that World of Warcraft will recognize. If not using FTL Modifiers on a given key, separate Macros can be assigned to different modifier combinations on that key -- for example, the ] key can have ], Alt-], Ctrl-], Shift-], Alt-Shift-], Alt-Ctrl-], Ctrl-Shift-], and Alt-Ctrl-Shift-] for a total of 8 Macros on the same key.
This method requires the following macros on every Character:
 
# /follow focus
 
# /assist focus
 
# /focus <name> -- for each Character
 
So, for example, if you have 3 Characters named Alice, Bob and Charles, the following macros would be required on each Character, identically for all Characters:
 
# /follow focus
 
# /assist focus
 
# /focus Alice
 
# /focus Bob
 
# /focus Charles
 
Note: For advanced users, all of the /focus macros could be combined into one macro. This tutorial is not intended for advanced users, who probably already know how to set up their Focus Target-based macros.
 
  
The easiest way to create all of the macros is to log all of the Characters into the game, then use Mouse and Key Repeat (with no white or black list) to create identical macros on each character. The process goes something like this:
+
The first option is the "Display as (in Step)" line. By checking the check box and entering something in the text box next to it, you can make the Action show up as whatever you like in the Action list. In the example image, I have set it to Lightning Bolt, and since the Target is "All w/ Current", the Action shows up as "Lightning Bolt -> all" instead of "2 -> all" for example. That's all this option does, it is purely cosmetic (display purposes only) and does not affect the in-game Macro.
# Log all Characters into the game
 
# Turn on Mouse and Key Repeat
 
# Click the menu button at the bottom of the screen to get the menu that has buttons for video options, key bindings, interface options, macros, and so on. The menu should open on all Characters (assuming each Character is at the same video resolution in-game)
 
# Click on Macros in the menu to open up the Macro editor
 
# Click on the Character Specific macros tab at the top, in order to create macros for these specific Characters, instead of making them apply to all Characters on your account
 
# Click the New button at the bottom to create a new Macro
 
# Click in the "Enter Macro Name" box in the window that opens, and type a name for the macro. For example, you could name the "/assist focus" button "Assist", the "/follow focus" button "Follow" and "/focus Alice" might be named "Alice"
 
# Select an icon from the list. It doesn't really matter which icon you select. I never show the action bar that has these macros on them anyway, and ideally you shouldn't either (unless you want to, it's up to you)
 
# After entering a name and selecting an icon, click the Okay button
 
# Now you must type in the "Enter Macro Commands" box. If creating the Follow macro, type "/follow focus", and so on. The exact commands for each are listed above in various places.
 
# After entering the command, you are done with this macro and may continue creating the next macro. Repeat until each macro is created.
 
  
Once your macros are created, you will need to assign them to an Action Bar in order to create key bindings for them in the game. Here is an example process for doing so, but you can place them on any action bar and assign any key combinations (note that you do not actually have to press the keys you are setting here, so they can be as obscure or complicated as you like):
+
Next is the "Commands" box. You can manually enter any commands that are available to standard World of Warcraft Macros. The "Final macro text" at the bottom will update as you type, as long as a Character Set has been selected at some point by clicking the '''*''' button next to the Target drop-down box.
# In the Interface options menu under Action Bars, show Right Action Bar 2
+
Here are a few simple examples:
# In the Key Bindings options, assign Key Combinations F6 through F12 to the first 7 Right Action Bar 2 actions (if you have fewer than 5 Characters, you may not need all of them, but this will show how to do up to a full group of 5 Characters with the 2 macros for Assist and Follow)
+
; /follow focus
# In the Macros window, drag the Follow macro to the top slot in Right Action Bar 2, the one that should be labelled F6
+
: Follows the Focus Target
# Drag the Assist macro to the next slot in Right Action Bar 2, the one that should be labelled F7
+
; /assist focus
# Drag each Character Focus macro to the next open slots in Right Action Bar 2, which should be labelled F8, F9, and so on, in the order that is configured or will be configured in your ISBoxer Character Set Slots -- so that the F8 button corresponds to the Character in Slot 1 (window 1), the F9 button corresponds to the Character in Slot 2 (window 2), and so on
+
: Assists (targets the same thing as) the Focus Target
# In the Interface options menu under Action Bars, you can now hide Right Action Bar 2 again so that these macros are out of sight and out of mind!
+
; /cast Lightning Bolt
 +
: Casts Lightning Bolt
 +
The list goes on and on with more complex possibilities. You can read [http://forums.worldofwarcraft.com/thread.html?topicId=3881820910 Cogwheel's Complete Macro Guide] for a very in-depth and helpful guide to making Macros.
  
==== Step 2: Configure ISBoxer to use our macros ====
+
You do not need to worry about complex Macros unless you really want to. Some of the complexity of World of Warcraft Macros can automatically be handled for you by the Targeting options below the Commands box. For example, FTL Macros typically involve a conditional '''/assist''' before casting a spell to assist the Hot Character, followed by a '''/targetlasttarget''' after beginning to cast. Additionally, if the same macro is to be used for the Hot Character himself, the Macro gets slightly more complex in order to be self-aware (so as to not mess with your target).  
First, set up the Hot character switch notifier in your Character Set, for each Slot:
 
# Check the Broadcast keystroke button
 
# Click the < button in the box next to it to pick a keystroke -- make this correspond to the Character Focus macro you made in World of Warcraft for the Character. In the example given above, this means F8 for Slot 1, F9 for Slot 2, F10 for Slot 3, and so on.
 
# Select between "When above hotkey is pressed" and "Any time I switch to this character". It's up to you. With the hotkey option, the key will only be broadcast (and therefore the Focus Target only changed) when using that hotkey to switch windows, as opposed to also when you alt+tab, click, or any other method to switch windows. I use the "Any time" option, which broadcasts the keystroke any time I switch windows, regardless of the method used.
 
  
Next, set up Mapped Keys for Assist and Follow:
+
ISBoxer's Targeting options '''automatically generate self-aware Targeting commands''', and will '''automatically generate FTL conditionals if FTL is enabled''' for the Mapped Key (FTL is enabled if (a) Use FTL Modifiers for the Mapped Key is set to On, or (b) Use FTL Modifiers for the Mapped Key is set to Default and Use FTL Modifiers for its Key Map is set to On -- also note that FTL Modifiers must be selected per Slot in your Character Set), '''or Focus Targeting if FTL is not enabled''' for the Mapped Key. It is perfectly acceptable to use different options for different Macros as desired.
# If you do not have a Key Map that applies to your whole Character Set, make one now by creating a new Key Map, and dragging your Character Set into it
 
# Create a New Mapped Key for Follow
 
## In the Hotkey box, pick the key combination you actually want to press to make your other characters follow you. As I have a G15 Keyboard, mine is the G16 key, an easily accessible key. It is recommended that you do not make Mapped Keys that you would normally use for typing in a chat window, so it would be a bad idea, for example, to make it F. However, Alt+F or Shift+Alt+F would be appropriate.
 
## Create 1 Step for the Mapped Key
 
## In Step 1, add one Keystroke action. In the Target box, select "Window:All w/o Current". For Key combination, put the key combination assigned to the "/follow focus" macro in the game
 
# Repeat the above for Assist, using a different Hotkey to assist, and using the key combination for the "/assist focus" macro in game
 
  
You're done! Save it!
+
Now that I've explained that, here's how to use the options. If '''ANY''' of the Targeting options are to be used, you must check the "But first" box (otherwise, you are free to enter any commands you like in the Commands box, and they will comprise the entire macro). You can either Assist (target the same thing as) the Hot Character, or Target the Hot Character. Assisting would be used for things like casting spells on the same mob, while Targeting might be used for quickly casting a beneficial spell such as a heal or buff on the Hot Character. If you wish the original target to be restored -- so for example the Character casting a beneficial spell on you can go back to attacking a mob instead of keeping you targeted -- simply check the "... and restore Target afterward" box.
  
=== World of Warcraft: Using FTL Modifiers ===
+
So the image on the right is a working example of creating a FTL Macro to cast Lightning Bolt with 5 Characters. The Targeting options are used to Assist the Hot Character and Restore target afterward. Since the Mapped Key in this example is set to use FTL Modifiers, and FTL Modifiers are selected per Slot in the Character Set, FTL Modifiers are automatically applied as can be seen in the Final macro text box.
Note: FTL Modifiers are NOT configured by ISBoxer to broadcast with Repeater. You will want to use Key Maps.
 
  
FTL Modifiers can be used to designate the currently active Character (also known as the Hot Character, aka the window you are clicking or pressing keys in). This allows macros to be created inside World of Warcraft that determine which modifier keys (CTRL,ALT,SHIFT) are pressed, and assist or follow that Character accordingly.
+
== Pros and Cons ==
 +
=== Hot Character identification: Focus Target vs FTL ===
 +
Using ISBoxer to manage World of Warcraft Macros reduces the complexity of configuration, regardless of whether Focus Target or FTL is used. Most of the traditional Pros and Cons do not apply (such as having to know how to create the Macros, needing enough Macro slots to handle them all, needing to manually configure them for each Character, and so on).
  
A good, and less complex, alternative to using FTL Modifiers is the use of Focus Target (a feature of World of Warcraft). If you do not need Focus Target for another purpose, and do not mind hitting an Assist key, using Focus Target is the easiest solution. Detailed instructions on setting up this alternative will soon be available here.
+
# The main difference between the two methods of Hot Character identification is obviously that one uses up your Focus Target, and the other does not. If you need Focus Target for another purpose, this is a Pro for FTL, and a Con for the Focus Target method. If not, then there is no Pro or Con as far as this specific difference goes.
 +
# Using FTL Modifiers reduces the number of Macros you can possibly have, because you could not, for example, bind one action to ], another to Alt+], another to Shift-], and so on. If you need a lot of Macros for some reason, then this is a Pro for Focus Target and a Con for FTL Modifiers. If not, then again there is really no Pro or Con.
 +
# ISBoxer does not include FTL Modifiers when using Repeater broadcasting (which is one-to-one) -- you must use Key Maps. If you do not intend to use Key Maps, then this is a Pro for Focus Target and a Con for FTL Modifiers. If not, then again there is really no Pro or Con.
 +
That's really about it. For most people, there will be no real difference between the two, and it will be a matter of personal preference.
  
==== Step 1: Select modifiers to designate a Character ====
+
'''The easiest way to use the Focus Target method''' is with the Hot Character switch notifier in each Character Set Slot: Set a keystroke to be broadcast when switching, and check the Generate Focus Target macros box. You can then set up a Mapped Key for Follow with a World of Warcraft Macro Action -- just put /follow focus for the command, and you do not need to use the Targeting options below the Commands box.
First, select a combination of modifier keys to be used for each Character.  
 
  
"Standard" FTL modifiers for up to 5 Characters are as follows:
+
'''The way to use the FTL method''' is to select a different set of FTL Modifiers per Character Set Slot (the Hot Character will be identified by determining exactly which of them are held down). Note that if you are using a keyboard that has AltGr in place of the Right Alt key, you may not be able to use Right Alt in your FTL Modifiers. You can then set up a Mapped Key for Follow with a World of Warcraft Macro Action -- put /follow for the command, check the "But first" box, select "Target Hot Character" and check the "... and restore Target afterward" box.
# CTRL+SHIFT
 
# CTRL+ALT
 
# ALT+SHIFT
 
# CTRL+ALT+SHIFT
 
# CTRL
 
... but any combination that suits your fancy is fine to use.
 
  
In your Character Set configuration for each Slot, check the boxes for your desired FTL Modifiers for that Slot. In the above example sequence, that means that Slot 1 would have Left Ctrl and Left Shift, Slot 2 would have Left Ctrl and Left Alt, and so on. World of Warcraft and Inner Space do support the use of the right-hand modifier keys should you want (or need, e.g. having more slots than key combinations the 3 left-hand modifiers will allow).
+
=== Manual vs Automatic Assist ===
 +
The real difference in configuration is Manual vs Automatic Assist, not whether the Hot Character is identified by modifier keys or Focus target.
  
==== Step 2: Create World of Warcraft macros ====
+
# Manual Assist requires exactly one Macro for Assisting. Automatic Assist requires one Macro per ability. In terms of configuration complexity and amount of time involved, Manual Assist is quick and dirty, and Automatic Assist is mostly just dirty. This is a Pro for Manual Assist and a Con for Automatic Assist. However, this particular Pro and Con is mitigated if you ''want'' to use World of Warcraft Macro Actions instead of Keystroke Actions anyway -- in this case, both methods "require" one Macro per Ability and therefore this is neither a Pro nor a Con. In fact, it may be very beneficial to use World of Warcraft Macro Actions instead of Keystroke Actions, as this way your actual World of Warcraft Key Bindings are basically irrelevant, you can move abilities around in your Action Bars all you want without affecting your multi-boxing, and you don't have to recognize which key is what ability when making changes to your Mapped Keys because you can make it show the name of the ability (example: I have a Mapped Key that drops a different totem on each of my Shamans. With using Macros, I can easily tell which Shaman is dropping which Totem, instead of seeing that one is pressing -, one is pressing alt+=, one is pressing 6, and so on).
This is the hard part. Instructions to follow soon.
+
# Manual Assist requires pressing a key combination to force your Characters to assist exactly when you want them to. Automatic Assist will of course Automatically Assist on demand, on a case by case basis, with no additional step required. This is both a Pro and a Con for each. Firstly, there may be times when it is helpful to have a different target selected on the Hot Character, which is a Pro for Manual Assist and thusly a Con for Automatic Assist. However, it does require an additional step, which takes time, which is a Con for Manual Assist and thusly a Pro for Automatic Assist.  
  
==== Step 3: Create Mapped Keys ====
+
'''The easiest way to use Manual Assist''' is to create a Mapped Key for Assist, using a World of Warcraft Macro Action. Do not enter a command, but check the "But first" box, select Assist Hot Character, and do not check the "... and restore Target afterward" box. As with all World of Warcraft Macro Actions, if FTL is enabled for the Mapped Key, FTL conditionals will be applied. If not, Focus Target will be used.
# FTL Modifiers must be enabled for any Mapped Key you want to use with FTL. This can be done either by checking "Use FTL Modifiers" for an entire Key Map (which will apply to all Mapped Keys that don't specify otherwise), or for individual Mapped Keys (which by default will follow the rules of the Key Map they are in).
 
# Each Keystroke Action added to any Step in a Mapped Key will then automatically apply the FTL Modifiers assigned to the Slot they are sent from. If you are playing the 1st Character, the modifiers from Slot 1 will be applied. If playing the 2nd Character, the modifiers from Slot 2 will be applied, and so on.  
 
# If the Character you are playing is to receive a Keystroke, you will need to specify its Keystroke separately (it can be the same key) with Current Window, in order for it to NOT receive the FTL Modifiers. Otherwise, for example if "2" is sent to "All w/ current", the current window will also receive the FTL Modifiers for its own Slot. If "2" is sent to "Current Window" it will NOT receive FTL modifiers, even though "2" may be sent to "All w/o current" to have all of the other windows receive 2 with the FTL Modifiers.
 
  
;Example:
+
'''To use Automatic Assist''', create a World of Warcraft Macro Action for each ability to be used in a Mapped Key. Enter the desired commands, such as /cast Lightning Bolt, then check the "But first" box, select "Assist Hot Character" or "Target Hot Character" as desired, and check the "... and restore Target afterward". If using FTL, each Macro can be used for the Hot Character without changing your Target.
* Slot 1 FTL modifiers: CTRL+SHIFT
 
* Slot 2 FTL modifiers: ALT+SHIFT
 
* Mapped Key: Hotkey is "2". Step 1 sends "2" to Current Window, and "2" to All w/o current.
 
* What happens when playing Character in Slot 1: You press "2", Current Window receives "2", and all other windows receive "CTRL+SHIFT+2"
 
* What happens when playing Character in Slot 2: You press "2", Current Window receives "2", and all other windows receive "ALT+SHIFT+2"
 
  
;Some people like to put their FTL macros on a separate key instead of the key pressed in the main window:
+
;Note about Automatic Assist with Focus Targeting
* Slot 1 FTL modifiers: CTRL+SHIFT
+
:After finishing this guide I realized that macros using Focus Targeting cannot currently be made self-aware. This means the same Macro cannot be used for the Hot Character, and is a Con for using Automatic Assist with Focus Targeting. You can create a separate Macro Action (which must be assigned a different Key Combination) for the Hot Character as part of your Mapped Key to work around this problem. I have put a [http://forums.worldofwarcraft.com/thread.html?topicId=15443447242&sid=1 request on the World of Warcraft UI & Macros forum] to find a solution.
* Slot 2 FTL modifiers: ALT+SHIFT
 
* Mapped Key: Hotkey is "2". Step 1 sends "2" to Current Window, and "]" to All w/o current.
 
* What happens when playing Character in Slot 1: You press "2", Current Window receives "2", and all other windows receive "CTRL+SHIFT+]"
 
* What happens when playing Character in Slot 2: You press "2", Current Window receives "2", and all other windows receive "ALT+SHIFT+]"
 
  
 
== See Also ==
 
== See Also ==
 
* [[IS:ISBoxer|ISBoxer]]
 
* [[IS:ISBoxer|ISBoxer]]

Revision as of 21:53, 1 March 2009

This page is about ISBoxer, specifically regarding World of Warcraft.

Is this allowed by Blizzard?

Multi-boxing
Multi-boxing is allowed by Blizzard. There are many resources that can be found with details, but here is one of them from WoW Insider: Chilton content to endorse multi-boxing
Using Inner Space and ISBoxer for multi-boxing
This is where it gets hairy, no matter what software the question is about. The answer most commonly received when asking a Blizzard Customer Service Rep (e.g. GM) is that as long as you are at the keys, pressing the buttons, and no automation is being performed, and no delayed actions are used (i.e. something only happens as an instant response to your manual toggling of inputs), and the game data (e.g. your character's health, mob locations, ability cooldowns) is not being read or modified by other software, then it is not a violation of the World of Warcraft Terms of Use. ISBoxer is specifically crafted to help configure multi-boxing with Inner Space while abiding by the rules.
Anecdote: I have been multi-boxing in World of Warcraft for several months. My actual characters are shown in the ISBoxer and configured-by-ISBoxer gameplay videos. My accounts (which are in my real name, with my real information, paid for by my real credit cards, and note that Blizzard is well aware of my real name and related information) are in good standing, even though a handful of people told me they were reporting me. I explain to these people that multi-boxing is allowed (I get one every few weeks or so that apparently doesn't know that), and I am not secretive that I use Inner Space and ISBoxer -- I tell anyone that asks. A lot of people are now multi-boxing with ISBoxer as well, and there have been zero reported bans or suspensions.

Terminology

Focus Target
World of Warcraft allows you to keep a secondary target, called the Focus Target. Many players do not even know what this is, or cannot fathom a use for it (or have an Addon that helps with what they would be using it for anyway), and so it becomes a good way to keep a permanent target of the Hot Character.
FTL
FTL is short for Focusless, Targetless, Leaderless. This is the phrase used to describe configurations, particularly in World of Warcraft, where specifying the Hot Character is done by different combinations of shift, alt, and control keys. In-game macros (built with the game's macro system) check which keys are pressed and depending on the combination, the 'slave' windows will, for example, cast a spell on that character's target.
Hot Character
As defined in the ISBoxer Glossary: Hot Character means the Character currently being played (the active, focused, foreground, etc window).

World of Warcraft Macro features in ISBoxer

. Click to enlarge.

The ISBoxer Toolkit can now export an actual World of Warcraft Addon (called ISBoxer) capable of creating Macros and assigning them to Key Bindings in the game.

Macros are created on a Character-per-Character Set basis, meaning that a Macro that is only used on a given Character when playing a given Character Set will not interfere with a different Macro on the same keystroke when playing a different Character Set. It is important to note that there is absolutely no communication between the Addon and Inner Space or ISBoxer -- this feature is implemented via automatic Virtual Files. Slightly technical explanation follows (you can skip it if you are not interested in the details): When Exporting to Inner Space, the Addon is generated with a dummy Lua file for a Character Set (ISBoxer_Character_Set.Lua), and a dummy Lua file for a Character (ISBoxer_Character.Lua). Those 2 files are then Virtualized, sort of like a symbolic link active for a single instance of the game, such that when the game loads the 2 Lua files, the files that are loaded in place are e.g. ISBoxer_Character_Set-My Character Set.Lua and ISBoxer_Character-My Character.Lua.

ISBoxer World of Warcraft Macros are bound to keys using Override Key Bindings. This means that you can replace (i.e. Override) your existing Key Bindings when multi-boxing with ISBoxer, and still have them as they were before when not multi-boxing with ISBoxer. Override bindings are not stored and do not un-bind existing Key Bindings.

ISBoxer World of Warcraft Macros are much like many Macro addons (Macaroon, Super Duper Macro, etc): created on invisible buttons using the "macro" type and "macrotext" attribute and the Override Key Bindings are set to click the button. This means no existing World of Warcraft Macros will be modified and any number of Macros can be created, each up to 1023 characters in length (so I've read).

There are two ways to create a World of Warcraft Macro through ISBoxer Toolkit:

  1. Automatic generation of a Focus Target Macro (see Hot Character switch notifier section below)
  2. When creating a Mapped Key, select "New World of Warcraft Macro Action" to create a Keystroke coupled with a World of Warcraft Macro, which is fully configurable (see Mapped Keys: World of Warcraft Macro Action section below)

Mapped Keys: World of Warcraft Macro Action

As of ISBoxer Build 23, ISBoxer has a new type of Action for Mapped Keys that doubles as a Keystroke Action, but can also create and bind a World of Warcraft Macro. This section will explain the additional features of the World of Warcraft Macro Action. The image on the right will help you follow along. There are only a few options, so this won't take but a moment.

Before I continue, let me explain that the Key combination must be configured, and the World of Warcraft Macro will automatically be bound to this key combination to match the keystroke being sent. It is acceptable (and perhaps recommended in many cases) to use obscure key combinations that World of Warcraft will recognize. If not using FTL Modifiers on a given key, separate Macros can be assigned to different modifier combinations on that key -- for example, the ] key can have ], Alt-], Ctrl-], Shift-], Alt-Shift-], Alt-Ctrl-], Ctrl-Shift-], and Alt-Ctrl-Shift-] for a total of 8 Macros on the same key.

The first option is the "Display as (in Step)" line. By checking the check box and entering something in the text box next to it, you can make the Action show up as whatever you like in the Action list. In the example image, I have set it to Lightning Bolt, and since the Target is "All w/ Current", the Action shows up as "Lightning Bolt -> all" instead of "2 -> all" for example. That's all this option does, it is purely cosmetic (display purposes only) and does not affect the in-game Macro.

Next is the "Commands" box. You can manually enter any commands that are available to standard World of Warcraft Macros. The "Final macro text" at the bottom will update as you type, as long as a Character Set has been selected at some point by clicking the * button next to the Target drop-down box. Here are a few simple examples:

/follow focus
Follows the Focus Target
/assist focus
Assists (targets the same thing as) the Focus Target
/cast Lightning Bolt
Casts Lightning Bolt

The list goes on and on with more complex possibilities. You can read Cogwheel's Complete Macro Guide for a very in-depth and helpful guide to making Macros.

You do not need to worry about complex Macros unless you really want to. Some of the complexity of World of Warcraft Macros can automatically be handled for you by the Targeting options below the Commands box. For example, FTL Macros typically involve a conditional /assist before casting a spell to assist the Hot Character, followed by a /targetlasttarget after beginning to cast. Additionally, if the same macro is to be used for the Hot Character himself, the Macro gets slightly more complex in order to be self-aware (so as to not mess with your target).

ISBoxer's Targeting options automatically generate self-aware Targeting commands, and will automatically generate FTL conditionals if FTL is enabled for the Mapped Key (FTL is enabled if (a) Use FTL Modifiers for the Mapped Key is set to On, or (b) Use FTL Modifiers for the Mapped Key is set to Default and Use FTL Modifiers for its Key Map is set to On -- also note that FTL Modifiers must be selected per Slot in your Character Set), or Focus Targeting if FTL is not enabled for the Mapped Key. It is perfectly acceptable to use different options for different Macros as desired.

Now that I've explained that, here's how to use the options. If ANY of the Targeting options are to be used, you must check the "But first" box (otherwise, you are free to enter any commands you like in the Commands box, and they will comprise the entire macro). You can either Assist (target the same thing as) the Hot Character, or Target the Hot Character. Assisting would be used for things like casting spells on the same mob, while Targeting might be used for quickly casting a beneficial spell such as a heal or buff on the Hot Character. If you wish the original target to be restored -- so for example the Character casting a beneficial spell on you can go back to attacking a mob instead of keeping you targeted -- simply check the "... and restore Target afterward" box.

So the image on the right is a working example of creating a FTL Macro to cast Lightning Bolt with 5 Characters. The Targeting options are used to Assist the Hot Character and Restore target afterward. Since the Mapped Key in this example is set to use FTL Modifiers, and FTL Modifiers are selected per Slot in the Character Set, FTL Modifiers are automatically applied as can be seen in the Final macro text box.

Pros and Cons

Hot Character identification: Focus Target vs FTL

Using ISBoxer to manage World of Warcraft Macros reduces the complexity of configuration, regardless of whether Focus Target or FTL is used. Most of the traditional Pros and Cons do not apply (such as having to know how to create the Macros, needing enough Macro slots to handle them all, needing to manually configure them for each Character, and so on).

  1. The main difference between the two methods of Hot Character identification is obviously that one uses up your Focus Target, and the other does not. If you need Focus Target for another purpose, this is a Pro for FTL, and a Con for the Focus Target method. If not, then there is no Pro or Con as far as this specific difference goes.
  2. Using FTL Modifiers reduces the number of Macros you can possibly have, because you could not, for example, bind one action to ], another to Alt+], another to Shift-], and so on. If you need a lot of Macros for some reason, then this is a Pro for Focus Target and a Con for FTL Modifiers. If not, then again there is really no Pro or Con.
  3. ISBoxer does not include FTL Modifiers when using Repeater broadcasting (which is one-to-one) -- you must use Key Maps. If you do not intend to use Key Maps, then this is a Pro for Focus Target and a Con for FTL Modifiers. If not, then again there is really no Pro or Con.

That's really about it. For most people, there will be no real difference between the two, and it will be a matter of personal preference.

The easiest way to use the Focus Target method is with the Hot Character switch notifier in each Character Set Slot: Set a keystroke to be broadcast when switching, and check the Generate Focus Target macros box. You can then set up a Mapped Key for Follow with a World of Warcraft Macro Action -- just put /follow focus for the command, and you do not need to use the Targeting options below the Commands box.

The way to use the FTL method is to select a different set of FTL Modifiers per Character Set Slot (the Hot Character will be identified by determining exactly which of them are held down). Note that if you are using a keyboard that has AltGr in place of the Right Alt key, you may not be able to use Right Alt in your FTL Modifiers. You can then set up a Mapped Key for Follow with a World of Warcraft Macro Action -- put /follow for the command, check the "But first" box, select "Target Hot Character" and check the "... and restore Target afterward" box.

Manual vs Automatic Assist

The real difference in configuration is Manual vs Automatic Assist, not whether the Hot Character is identified by modifier keys or Focus target.

  1. Manual Assist requires exactly one Macro for Assisting. Automatic Assist requires one Macro per ability. In terms of configuration complexity and amount of time involved, Manual Assist is quick and dirty, and Automatic Assist is mostly just dirty. This is a Pro for Manual Assist and a Con for Automatic Assist. However, this particular Pro and Con is mitigated if you want to use World of Warcraft Macro Actions instead of Keystroke Actions anyway -- in this case, both methods "require" one Macro per Ability and therefore this is neither a Pro nor a Con. In fact, it may be very beneficial to use World of Warcraft Macro Actions instead of Keystroke Actions, as this way your actual World of Warcraft Key Bindings are basically irrelevant, you can move abilities around in your Action Bars all you want without affecting your multi-boxing, and you don't have to recognize which key is what ability when making changes to your Mapped Keys because you can make it show the name of the ability (example: I have a Mapped Key that drops a different totem on each of my Shamans. With using Macros, I can easily tell which Shaman is dropping which Totem, instead of seeing that one is pressing -, one is pressing alt+=, one is pressing 6, and so on).
  2. Manual Assist requires pressing a key combination to force your Characters to assist exactly when you want them to. Automatic Assist will of course Automatically Assist on demand, on a case by case basis, with no additional step required. This is both a Pro and a Con for each. Firstly, there may be times when it is helpful to have a different target selected on the Hot Character, which is a Pro for Manual Assist and thusly a Con for Automatic Assist. However, it does require an additional step, which takes time, which is a Con for Manual Assist and thusly a Pro for Automatic Assist.

The easiest way to use Manual Assist is to create a Mapped Key for Assist, using a World of Warcraft Macro Action. Do not enter a command, but check the "But first" box, select Assist Hot Character, and do not check the "... and restore Target afterward" box. As with all World of Warcraft Macro Actions, if FTL is enabled for the Mapped Key, FTL conditionals will be applied. If not, Focus Target will be used.

To use Automatic Assist, create a World of Warcraft Macro Action for each ability to be used in a Mapped Key. Enter the desired commands, such as /cast Lightning Bolt, then check the "But first" box, select "Assist Hot Character" or "Target Hot Character" as desired, and check the "... and restore Target afterward". If using FTL, each Macro can be used for the Hot Character without changing your Target.

Note about Automatic Assist with Focus Targeting
After finishing this guide I realized that macros using Focus Targeting cannot currently be made self-aware. This means the same Macro cannot be used for the Hot Character, and is a Con for using Automatic Assist with Focus Targeting. You can create a separate Macro Action (which must be assigned a different Key Combination) for the Hot Character as part of your Mapped Key to work around this problem. I have put a request on the World of Warcraft UI & Macros forum to find a solution.

See Also