Combat Event Announcement Mod
Intro
We had some interest in the mod from a few other threads, so I made this post to help explain how it works, and to offer a place for us to share "rules" as necessary. Here's the author's description:
- This mod is an event tracker that will watch for a given event and pop up a warning in chat or on screen. It is similar to SCT or EavesDrop, but lets you spam customized events to the channel of your choice. If you want something to spam *you* when events happen, feel free to use one of those other mods. If you want to be able to set up warnings for any combat event and announce it pretty much anywhere, this mod's for you.
What Would I Announce?
The sky is the limit! Generally, I prefer to announce stuns and knockdowns to allow for my healers to know when excess damage is coming, as well as Mortal Strikes and Mind Control. You could take it a step further, though, and alert your raid when harmful totems are dropped, when you cast Avenging Wrath, or when your taunt is resisted.
How the Rules Work
Here's the syntax of a TJH rule:
/tjh rule EVENT_NAME;SourceName;TargetName;SpellName;Affiliation;Channel;Spam
The EVENT_NAME is one of many available on WoWWiki and in TJH's drop-down box. Some more popular are SPELL_CAST_SUCCESS (when a spell successfully lands), and SPELL_AURA_APPLIED (a buff or debuff is applied). However, partial phrases, such as SPELL_CAST will also work (so that SUCCESS and MISSED both trigger).
SourceName is the source of the event.
TargetName is the target of the event. When you gain or lose a buff, you are the "target" of it.
Spellname is the name (or ID) of the spell.
Affiliation is a little trickier, but allows for some good rules. Let's say you were looking to make a small announcement for when someone gains the Soulstone buff, so you know who is soulstoned. You could make an individual rule for each person in your party or raid (tedious), or leave the target field blank (in Shatt/Org/IF, you'll be constantly hearing about others' Soulstones). So, instead of specifying a target specifically, set the Affiliation to raid or party, and it will only announce the Soulstones of people in your group.
Channel is the place you want to announce this. SELF goes just to your chat box, SAY, YELL, PARTY, and RAID are self-explanatory, and RW will announce to a raid warning. You can also use the name of a player to send it to them as a whisper. UPDATE: The latest version now supports EMOTE, as well as the dynamic *source and *target. UPDATE: Even sounds are now supported. Use SOUND in the Channel and the path to it in the Spam.
Spam is what you want to be said when this event happens. If you leave it blank, you'll get a generic phrase, like "Modus is afflicted by Mortal Strike." This will work, but to cut down on the spam, and allow for less reading, it would probably be worth setting this as "Mortal Strike!" so my healers are alerted, yet I'm not filling up everyone's screen with long chat bubbles. Also, don't forget that you can use dynamic variables here (*event, *source, *target, *spell) to be a little more clear with your announcements.
Delay is an optional parameter that is used just after Spam, added in version 3.0.4. Put a number here and your announcement will be delayed by that number of seconds.
You can leave any of the fields blank for the "default" value. For example, if you leave the target field blank, it will accept all targets as a possibility.
How to Make Your Own Rules
As you get to know the combat log better, you'll be able to make them without checking the combat log, but for now, type /combatlog to start logging your combat log to your hard drive, and then get the event to happen. Here are some lines I took simply from running outside Shatt and stunning a mob:
- 7/15 17:46:19.640 SPELL_CAST_SUCCESS,0x00000000021B2798,"Modus",0x511,0xF13000482203E677,"Dreadfang Lurker",0x10a48,10308,"Hammer of Justice",0x2
7/15 17:46:19.920 SPELL_AURA_APPLIED,0x0000000000000000,nil,0x80000000,0xF13000482203E677,"Dreadfang Lurker",0x10a48,10308,"Hammer of Justice",0x2,DEBUFF
7/15 17:46:26.031 SPELL_AURA_REMOVED,0x0000000000000000,nil,0x80000000,0xF13000482203E677,"Dreadfang Lurker",0x10a48,10308,"Hammer of Justice",0x2,DEBUFF
So, each of those combat log entries should give you a pretty good indication of what your rule should look like.
/tjh rule SPELL_CAST_SUCCESS;Modus;;Hammer of Justice;;YELL;Stop! Hammer time!
...and there you are! Now my character will yell, "Stop! Hammer time!" each time I cast the spell on anything, but not when it resists. This will probably be quite annoying. It's worth noting, though, that I left the target and affiliation fields blank. This is because I don't want it to yell ONLY when I stun a specific target, and since it's an offensive stun, no affiliation description is necessary.
HINT: You can also sometimes use WoWHead to find out spell names. For example, I wanted to make an alert for Gurtogg's knockback, but didn't know the name of the spell. Sure enough, WoWHead listed his abilities, and Eject was the name of it.
FAQ
Q: It isn't working. I can't get it to announce anything.
A: First, be sure it's on. After downloading the mod, you must first use the "/tjh on" command to start it going (or /tjh, and click the Enable button). If that doesn't work, stand in a crowded area and add this rule:
- /tjh rule ;;;;;;
Q: When I save a rule on one character, does it apply to another?
A: No. I'm going to bug the author to make a "profile" feature, but right now it doesn't do this. For now, to copy one set of rules to another character, you can go to YourWoWDirectory>WTF>YourAccount>YourServer>YourCharacter>SavedVariables, and copy all the ThatJustHappened files over to another character.
TBC - 5 Mans + T4 Raid Rules:
http://www.failsafedesign.com/maintanka ... 269#295269
TBC - T5 Raid Rules:
http://www.failsafedesign.com/maintanka ... 276#295276
TBC - T6 Raid and Sunwell Rules:
http://www.failsafedesign.com/maintanka ... 281#295281
