This content (or portions thereof) describes ISBoxer 41! ISBoxer 41 has just been released, so we are still working on updating some parts of the documentation for the new version.
A Target is a destination for an Action and related features. A Target can be one or more windows.
- Types of Targets
- Current window
- All windows (or all other windows)
- A Character Set Slot
- A Character
- An Action Target Group (or others in it)
Targets that include more than one window have two versions -- "all" and "other". The difference between these two is that if you are playing one of the windows that would be part of the target, "all" will include the current window while "other" specifically excludes the current window.
ISBoxer's Target selection controls include a drop-down box and a button next to it with an asterisk (*). The drop-down box has a list of possible targets, usually filtered to those relevant to a particular Character Set. The asterisk button can be used to change the Character Set for the filtering.
Advanced Target mechanics
ISBoxer 38 now supports combining and operating on the simple Targets described above.
- Names and keywords
- For the current window, use the keyword self
- For the ordered set of all windows, use the keyword all
- For all windows except for the current one, all other
- Inner Space session names are used in place of Slot numbers, e.g. Slot 3 is is3
- Action Target Group (ATG) names may be used as-is
- For "others in" an ATG, use the keyword other before the ATG name, e.g. other paladins
- Multi-PC configurations have a special local keyword to mean only those on the current PC
- For the set of all windows, but only on the current PC: all local
- For all windows except for the current one, but only on the current PC: all other local
- For only those on the current PC in an ATG, in a multi-PC configuration, use the keyword local before the ATG name, e.g. local paladins. This can be combined with the other keyword as follows: other local paladins
Parentheses are used in standard form, to group operators and Targets together, to enforce precedence over other operators.
This standard operation combines the Targets on the left and right sides into a new set.
This standard operation combines the intersections of the Targets on the left and right sides into a new set.
This operation generates a new set of all Slots that are not in the Target on the right side.
This operation selects the Nth (1-based) window from a set. N wraps around the size of the set, as in a standard modulo operation.
This operation selects the Nth (1-based) window from a set, without wrapping (in contrast to Modulo)
Action Target Group order
Sometimes, particularly in the case of Round-robin or other uses of the Modulo operator, it may be important to enforce the order of entries in an Action Target Group.
The problem is that Action Target Groups are dynamically ordered, with entries added or removed at will, and this same ordering is used for Modulo. In other words, healers%1 might refer to player A at one point, but if player A is removed and re-added to the group, healers%1 might now refer to player B, and healers%2 might be player A.
The good news is that "all" has an enforced order, and the Intersect operator can be used to filter "all" down to an ordered Action Target Group! In other words, "(all&healers)%1" will always be the member of "healers" with the lowest Slot number, regardless of when they joined the Action Target Group.