ThatJustHappened

TJH_poly

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.

To get started, first set up some rules to monitor the events you want to watch. There are a lot of ways to choose what you want to see, including the event's source, the event's target, the watched-for spellname, the affiliation or category of events you want to watch, and the channel where the warning is sent. To see all of any of these things, just leave it blank. You can also use partial event/source/target/spell names to cast a wider net (ex: AURA), or full names to limit triggers (ex: SPELL_AURA_REMOVED). (See slash commands and examples below.) Rules are additive, so using a rule showing all "self" events with one showing all "raid" events will result in two lines per event. Rules and enable settings are saved across sessions by character (initial default is "off" but it will stay on until you turn it off). 

For example, set the "affiliation" dropdown box to "target" and the output channel to "SELF" (leave the other rule options blank). Hit the "Add Rule" button; you'll see your new rule printed in the chat window. Toggle the bottom-left button from "Disabled" to "*Enabled*". Now whenever you target a player or a mob, their combat events will be output to your chat window.

SLASH COMMANDS

• /tjh or /tjh gui for GUI
• /tjh help for this list
• /tjh on (to activate, default is on)
• /tjh off (to deactivate)
• /tjh rule EVENT_NAME;SourceName;TargetName;SpellName;Affiliation;Channel;Spam (leave blank to see all of a type, ex: /tjh rule SUMMON;;;;enemy;; channel defaults to SELF)
• /tjh list (to list current rules)
• /tjh delete (to delete all rules)
• /tjh delete;3 (to delete the third rule)
• tjh reset (deletes all rules, resets output to SELF)

Valid Source/Target Names
Player names, NPC names, and object names as seen in the in-game tooltips. Also accepts the active target or focus at that time.

Channel Options Channel settings: SELF/WARN/PARTY/RAID/RAID_WARNING/RW/RS/PlayerName/ChannelName/auto (to set output channel to SELF, RAID, whisper a player, or use a custom channel, etc.) SELF is the default channel. Enabling the "Auto-Select Channel" checkbox sets the rule channel to "auto" -- rules with "auto" as the channel will be output to self, party, or raid chat depending on your group status.
Channel settings are on a "by rule" basis; each event is output to the specified channel. For example the first rule spams RAID when anyone takes Spout damage, the second alters a custom mage channel when a stealable buff is applied:

• /tjh rule ;Lurker;;Spout;;RAID;
• /tjh rule AURA_APPLIED;Greyheart Nether-Mage;;Arcane Destruction;;GDMAGES;

Custom Rule Spam
Basics: You have the option to set custom spam text for each rule, which replaces the standard combat log-type output. For example, if Savar is my main tank:

• /tjh rule SPELL_AURA_APPLIED;;Savar;Mortal Strike;;RW;Incoming heals on Savar reduced by 50%!

Dynamic Variables: using any of the following in your spam will substitute the current event's variable, or blank if that variable is nil:

• *event = current event's name
• *source = current event's source
• *target = current event's target
• *spell = current event's spellname

Note: depending on the event, these variables may not always give you what you expect, but they can be great for rules like the following:

• /tjh rule UNIT_DIED;;;;raid;RW;*target is down!

Affiliation
The last rule option can be used to filter out all events except those that affect either self/party/raid/friend/enemy/target/focus. So if you want to see every time a buff expires on your current focus (whatever that is), use "/tjh rule SPELL_AURA_REMOVED;;;;focus;;" (Note: this would also trigger if your focus removed a buff from another mob.)

EXAMPLES

• Basic Rule Structure: event;source;target;spell;affiliation;channel;spam

To track all interrupts on a specific target and splash it up on your screen:

• /tjh rule INTERRUPT;;TargetNameHere;;;WARN;

To announce all kills made by party members and output to party chat:

• /tjh rule PARTY_KILL;;;;;PARTY;

To alert yourself to all buff-related events on your current target:

• /tjh rule AURA;;;;target;SELF;

To announce custom spam in raid chat when your target summons a Tremor Totem:

• /tjh rule SUMMON;target;Tremor Totem;;;RAID;Totem up!

To track all events on a player done by your target, and whisper them to that player:

• /tjh rule ;PlayerName;;;target;PlayerName;

Announces in the custom channel "gdmages" when Greyheart Nether-Mage gains any of the three spell-stealable Destruction buffs:

• /tjh rule AURA_APPLIED;Greyheart Nether-Mage;;Destruction;;GDMAGES;Steal that spell!

Spams raid warning when Greyheart Tidecaller summons a water elemental:

• /tjh rule SUMMON;Greyheart Tidecaller;;Water Elemental Totem;;RW;

Tracks expiring weapon oil on my weapon and alerts me with a custom message:

• /tjh rule ENCHANT_REMOVED;;Belleboom;;Oil;;SELF;Time for an oil change.

Tracks all expiring buffs on your focus and alerts me via splash screen:

• /tjh rule SPELL_AURA_REMOVED;;;;focus;WARN;

To see all events (warning, lots of spam), output to the default channel "SELF":

• /tjh rule ;;;;;;

Announces in raid chat when anyone is hit by The Lurker Below's Spout damage:

• /tjh rule ;Lurker;;Spout;;RAID;

See the TJH_ReadMe.txt file for more details, troubleshooting, and notes on how to research the combat log.

ThatJustHappened Change Log
1.0.7
-- added "YELL" as a channel option
-- minor gui adjustments

1.0.6
-- minor adjustments to the gui
-- default setting is "off" but enable status is now persistent across sessions (by character), so if you log out with TJH active, it will be on next time you log that character
-- added basic set of rules for SSC "/tjh ssc" to activate

1.0.5
-- added dynamic variables to custom spam: using any of the following in your spam will substitute the current event's variable, or blank if that variable is nil:
*event = current event's name
*source = current event's source
*target = current event's target
*spell = current event's spellname
-- Note: depending on the event, this may not always give you what you expect, but it can be great for rules like the following:
/tjh rule UNIT_DIED;;;;raid;RW;*target is down!
-- code updates to improve speed and efficiency
-- added "Load Rule" and "Clear GUI" options in GUI: there is now one "individual rule" entry box, once you enter a rule number you can choose to delete it or to load it into the GUI to act as the basis for a new rule. I've also added a "clear gui" button to start afresh

1.0.4
-- changed "Auto channel" checkbox to work more intuitively; when enabled rules will have "auto" as the channel, and will be output to self, party, or raid chat depending on your group status
-- added option to use custom spam text by rule, leave blank if you want the standard combat text spam
-- updated code related to new spam option
-- updated gui to include custom spam entry box, text, and updated help text
-- updated TJH_ReadMe.txt
-- changed SPELL_START spam to match standard combat log text
-- NOTE: changed rule syntax to use ";" instead of "," so commas could be used in custom spam. sorry, but old rules will have to be updated

1.0.3
-- changed channel settings to a "by rule" basis, so each event can be output to its own separate channel (spam the raid when Leeroy breaks a sheep, but only spam yourself when you do;)
-- updated ReadMe to include new rule structure
-- gui adjustments for coding and screen efficiencies
-- added the previously forgotten "/tjh spam,delete" commmand

1.0.2
-- added "warn" as a channel option; splashes screen like raid warning but to player only (like SCT, for ex.)
-- tweaks to make the gui more legible
-- added code efficiencies
-- added counts for "_APPLIED_DOSE" buffs like "Electrical Charge (2)"
-- fixed manual event entry field clearance, should now clear on Add Rule
-- channel text should now update in gui as expected

1.0.1
-- updated Rule buttons for easier viewing
-- minor adjustments to GUI

1.0
-- updated code to allow entry of event names in lower case
-- all rule entry fields now cleared when new rule is created, no deleting required
-- replaced enable checkbox with pretty toggle button
-- adjusted dropdown window locations
-- first release version, because beta is so passe

0.1.8b
-- added a GUI: note that if you have both a manual and dropdown event filled in, the manual event will be used in making the rule; slash commands are still valid if you prefer that method; left "report" and "spam" out of the GUI but both are valid via slash command

0.1.7.1b
-- fixed flipped source/target syntax in help spam

0.1.7b
-- added affiliation option as a fifth rule variable
-- code cleanup
-- made friend/enemy affiliation apply to events both "from" and "to" but I may change this later
-- if channel is set to RAID or PARTY but you aren't grouped, spam now defaults to SELF (but channel does not change, so if you join a group spam should be directed appropriately)
-- now accepts lowercase channel names

0.1.6b
-- fixed blank event spam on login
-- updated output code to include all event variables (although not every single argument for each variable is included in the spam)
-- updated existing event spam to better reflect events
-- updated code to include damage and power gain types
-- added creator to reports of event SPELL_CREATE
-- added "thing interrupted" to INTERRUPT reports
-- corrected ENERGIZED to ENERGIZE; gains should now register properly
-- added separate code for EXTRA_ATTACKS like Windfury

0.1.5b
-- updated custom channel code
-- added "reset" as a valid command

0.1.4b
-- initial beta release