Unzip the contents into the AddOns directory of your WoW game directory.

This is typically C:\Program Files\World of Warcraft\Interface\AddOns.

If your are upgrading the mod from a previous version, make sure to delete the old version prior to installing the new version.

This mod makes it easier to see combat information by scrolling it on the screen in 3 configurable scrolling areas. There is a scroll area for incoming heals/damage, one for outgoing heals/damage, and a third for notifications. Each scroll area is completely customizable.

Features:

• Scroll incoming damage/heals, outgoing damage/heals, and notifications in separate configurable scroll areas on the playing field.
• Customize the position, animation style, show state, font style, font size, and font outline for each of the scroll areas.
• Customize each individual event's color, font style, font size, font outline, output message, and show state.
• Set "Master Font" settings that will be inherited by all of the scroll areas and the events in them unless they are overriden at the scroll area or event level.
• Merge AoE data into one event with cumulative damage/healing done with number of normal and crits specified.
• Show overhealing amounts against yourself or party/raid members.
• Add triggers that will allow you to show notifications based on various health and mana thresholds, or custom search patterns. Triggers are also set to only fire for specific classes.
• Suppress particular messages you do not want to see such as mana gains from Blessing/Judgement of Wisdom.
• Load on demand options.

Supported Events:

• Incoming:
• Melee Damage
• Melee Misses, Dodges, Parries, Blocks, Absorbs, and Immunes
• Ability/Spell Damage
• Ability/Spell Damage Over Time (DoTs)
• Ability/Spell Misses, Dodges, Parries, Blocks, Absorbs, Immunes, and Reflects
• Spell Resists
• Heals
• Heals Over Time (HoTs)
• Environmental Damage


• Outgoing:
• Melee Damage
• Melee Misses, Dodges, Parries, Blocks, Absorbs, and Evades
• Ability/Spell Damage
• Ability/Spell Damage Over Time (DoTs)
• Ability/Spell Misses, Dodges, Parries, Blocks, Absorbs, Immunes, Reflects, and Evades
• Spell Resists
• Heals
• Heals Over Time (HoTs)
• Pet Melee Damage
• Pet Melee Misses, Dodges, Parries, Blocks, Absorbs, Immunes, and Evades
• Pet Ability/Spell Damage
• Pet Ability/Spell Misses, Dodges, Parries, and Blocks, Absorbs, Immunes, Reflects, and Evades
• Pet Spell Resists


• Notification:
• Debuffs
• Buffs
• Item Buffs
• Buff Fades
• Enter/Leave Combat
• Power Gains and Losses
• Combo Point Gains
• Combo Points Full
• Honor Gains
• Reputation Gains and Losses
• Skill Gains
• Experience Gains
• Killing Blows (Player and NPC)


• Default Triggers:
• Low Health
• Low Mana
• Low Pet Health
• Execute
• Counter Attack
• Mongoose Bite
• Clearcast
• Riposte
• Windfury
• Nightfall
• Overpower


• Default Suppressions:
• Blessing/Judgement of Wisdom (+30 Mana, +33 Mana, +59 Mana)

/msbt	Shows the options interface.
/msbt reset	Resets the current profile to the default settings.
/msbt disable	Disables the mod.
/msbt enable	Enables the mod.
/msbt version	Shows the current version.
/msbt stats	Reports stats about table recycling.
/msbt search pattern	Sets a pattern for searching event types.
/msbt debug	Toggles debug mode.
/msbt help	Shows the command usage.

The trigger system allows you to specify notifications based on events that are not already covered by MSBT's native events. The trigger system has been optimized so that having extra triggers which are not enabled or which do not apply to the class you are currently playing add no overhead.

Due to this optimization, a lot of triggers that people will want (Windfury, Nightfall, Mongoose Bite, etc) are probably already there by default, and will not waste resources for those which don't apply to your class or are not enabled.

The following is a description of the fields unique to the Trigger Settings interface (see the Frequently Asked Questions section for a tutorial on how to create a new trigger):

Output Message	This is the message that will be displayed when the trigger fires. If you are using a Search Pattern with captures you can enter %1 through %9 to use the data that was captured. Also, for trigger types with thresholds, the amount of health or mana will be in %1.
Applicable Trigger Classes:	These are the classes that you want the trigger to apply to. NOTE: THIS IS YOUR CLASS NOT THE TARGET CLASS. You may look at the Execute trigger for an example. Since Warrior and Paladin are selected, the trigger will only apply when you are playing on a warrior or paladin.
Trigger Type:	This is the type of trigger. Self Health - This will trigger when your health falls below the selected threshold. Self Mana - This will trigger when your mana falls below the selected threshold. Pet Health - This will trigger when your pet's health falls below the selected threshold. Enemy Target Health - This will trigger when your target is an enemy and their health falls below the selected threshold. Friendly Target Health - This will trigger when your target is friendly and their health falls below the selected threshold. Search Pattern - This will trigger when the search pattern you enter is found.
Threshold:	This slider will only be present if the selected trigger type is one of the types that support it. It specifies the threshold percentage that must be crossed for the trigger to fire.
Trigger Event Types:	This list will only be present if the selected trigger type is Search Pattern. This exists solely for optimization and is probably the most difficult field to enter. While not having this field would make the trigger system easier to use, it would also make it extremely inefficient since searching through an array of triggers which don't apply every time ANY event happens wastes precious resources. In order to find the appropriate event types to use, type /msbt search pattern, where the word pattern is a lua search string. Only combat messages that match the search string will display their associated event type. Once you are done you can type /msbt search to toggle event searching mode back off.
Search Pattern 1 & 2:	These fields will only be present if the selected trigger type is Search Pattern. These fields can either contain a global string from globalstrings.lua (if you happen to know which one you want) or a lua formatted search string. The mod also supports data captured from the pattern. The output message specified for the trigger can use the captured data by putting %1 - %9 where the number is the position of the captured data.

The suppression system allows you to suppress specific text that MSBT is displaying to the screen via lua search patterns.

The text next to enable checkbox is the search pattern that will be checked for matches against the output text. If a match is made, the output text will be suppressed.
See the Frequently Asked Questions section for a tutorial on how to create a new suppression.

Here is the official lua reference for patterns:

Character Class:

A character class is used to represent a set of characters. The following combinations are allowed in describing a character class:

• x: (where x is not one of the magic characters ^$()%.[]*+-?) represents the character x itself.
• .: (a dot) represents all characters.
• %a: represents all letters.
• %c: represents all control characters.
• %d: represents all digits.
• %l: represents all lowercase letters.
• %p: represents all punctuation characters.
• %s: represents all space characters.
• %u: represents all uppercase letters.
• %w: represents all alphanumeric characters.
• %x: represents all hexadecimal digits.
• %z: represents the character with representation 0.
• %x: (where x is any non-alphanumeric character) represents the character x. This is the standard way to escape the magic characters. Any punctuation character (even the non magic) can be preceded by a '%' when used to represent itself in a pattern.
• [set]: represents the class which is the union of all characters in set. A range of characters may be specified by separating the end characters of the range with a '-'. All classes %x described above may also be used as components in set. All other characters in set represent themselves. For example, [%w_] (or [_%w]) represents all alphanumeric characters plus the underscore, [0-7] represents the octal digits, and [0-7%l%-] represents the octal digits plus the lowercase letters plus the '-' character.
  
  The interaction between ranges and classes is not defined. Therefore, patterns like [%a-z] or [a-%%] have no meaning.


• [^set]: represents the complement of set, where set is interpreted as above.

For all classes represented by single letters (%a, %c, etc.), the corresponding uppercase letter represents the complement of the class. For instance, %S represents all non-space characters.

The definitions of letter, space, and other character groups depend on the current locale. In particular, the class [a-z] may not be equivalent to %l.

Pattern Item:

A pattern item may be:

• a single character class, which matches any single character in the class;
• a single character class followed by '*', which matches 0 or more repetitions of characters in the class. These repetition items will always match the longest possible sequence;
• a single character class followed by '+', which matches 1 or more repetitions of characters in the class. These repetition items will always match the longest possible sequence;
• a single character class followed by '-', which also matches 0 or more repetitions of characters in the class. Unlike '*', these repetition items will always match the shortest possible sequence;
• a single character class followed by '?', which matches 0 or 1 occurrence of a character in the class;
• %n, for n between 1 and 9; such item matches a substring equal to the n-th captured string (see below);
• %bxy, where x and y are two distinct characters; such item matches strings that start with x, end with y, and where the x and y are balanced. This means that, if one reads the string from left to right, counting +1 for an x and -1 for a y, the ending y is the first y where the count reaches 0. For instance, the item %b() matches expressions with balanced parentheses.

Pattern:

A pattern is a sequence of pattern items. A '^' at the beginning of a pattern anchors the match at the beginning of the subject string. A '$' at the end of a pattern anchors the match at the end of the subject string. At other positions, '^' and '$' have no special meaning and represent themselves.

Captures:

A pattern may contain sub-patterns enclosed in parentheses; they describe captures. When a match succeeds, the substrings of the subject string that match captures are stored (captured) for future use. Captures are numbered according to their left parentheses. For instance, in the pattern "(a*(.)%w(%s*))", the part of the string matching "a*(.)%w(%s*)" is stored as the first capture (and therefore has number 1); the character matching "." is captured with number 2, and the part matching "%s*" has number 3.

As a special case, the empty capture () captures the current string position (a number). For instance, if we apply the pattern "()aa()" on the string "flaaap", there will be two captures: 3 and 5.

A pattern cannot contain embedded zeros. Use %z instead.

---

Return to TOC

---

Return to TOC