IntroWe 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.

Virtually anything in the combat log can be announced, so almost all game happenings are fair game. Just be sure not to make too many, or you'll drive your raid crazy!

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 WorkHere'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 RulesAs 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:

I found these lines by opening my combat log (located in YourWoWDirectory>Logs>WoWCombatLog.txt), and doing a Ctrl+F Find for Hammer of Justice, as this is the stun I'm looking to announce. As you can see, the first line includes me (Modus), the mob (Dreadfang Lurker), and the spell (Hammer of Justice). It also lists the event, SPELL_CAST_SUCCESS. The second line, though, lists only the mob's name and the spell, with the event "SPELL_AURA_APPLIED". This is because the first line said I cast the spell on the mob, and the second line says he is afflicted by the "Hammer of Justice" debuff, and is stunned. The third line is when the stun fades from the mob (SPELL_AURA_REMOVED).

So, each of those combat log entries should give you a pretty good indication of what your rule should look like.

...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.

FAQQ: 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 ;;;;;;

It has no defined characteristics, so it will announce anything that happens to anyone to the default channel (SELF, your chat box). If the mod is on, and this doesn't work, something is wrong.

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.

theckhd wrote:Fuck no, we've seen what you do to guilds. Just imagine what you could do to an entire country. Just visiting the US might be enough to make the southern states try to secede again.

halabar wrote:Noo.. you don't realize the problem. Worldie was to negative guild breaking energy like Bolvar is to the Scourge. If Worldie is removed, than someone must pick up that mantle, otherwise that negative guild breaking energy will run rampant, destroying all the servers.

No, they aren't. You'll have to copy them from this page, as this is a more tank/raid-leader based set. I'm not the developer, but I have been following its development and offering feedback to the author almost since its inception.

No. I'll see if I can bug him to get it on the WoWAceUpdater. I don't know how Chloe did it with Tankadin, or if it was tough.

Just out of curiousity, there has to be somewhere where these rules are stored for the addon, so I wonder if it is possible to figure that out and "make" a rule file by taking a list of the rules and copy/pasting them into whatever file the addon uses rather than having to add them in manually one by one.

Apologies if you put that in the guide somewhere, but I am at work and was only able to skim through it for the moment.

jere wrote:Just out of curiousity, there has to be somewhere where these rules are stored for the addon, so I wonder if it is possible to figure that out and "make" a rule file by taking a list of the rules and copy/pasting them into whatever file the addon uses rather than having to add them in manually one by one.

Apologies if you put that in the guide somewhere, but I am at work and was only able to skim through it for the moment.

That's possible. I've already seen the file and it's quite easy to configure, but I don't want to put ALL these rules in it, cause that will bug the crap out of people. I may just, say, color code the ones in the base package as red or something, though. I'll be thinking about it.

Yep, sorry I didn't mean all of them. I was more thinking on a way of adding multiple ones faster in general. You know, we could copy the ones we wanted into notepad, make a list that we like and then copy paste that list into whatever file the addon uses. Just wasn't sure if this was possible (it would depend on the file's format I would imagine).

I wouldn't say so, at least not yet. If this mod becomes as standard as, say, Tankadin, or close to it, then I'd say probably. For now, though, we can just be sure it gets bumped once in a while to the front page. :)