MyChatAlert

Alerts the player when designated keywords are found in specified chat channels

Using the Addon

Download it and install as a typical wow addon. Customization can be found in the interface/addons panel. Clicking on an author's name in the alert frame or printed alerts will open a whisper to that player.

Chat Commands

/mca opens the addon options panel
/mca alerts opens the alert frame
/mca ignore {player} adds the player to the addon's ignore list

Minimap Functionality

Left Click Toggles the alert frame to show/hide
Control + Left Click Opens the interface options panel for the addon
Right Click Clears stored alerts in the alert frame
Control Right Click Toggles the Enable setting, controls whether alerts are enabled or disabled

Creating a Basic Alert

Open the addon's options
In the Channels section, select a channel from the dropdown, or manually type in the name
In the Keywords section, select the channel you want to add an alert to
Type in the keyword that you want to be alerted for
You now have a functioning alert! Further configuration can be done, the settings section below will explain each setting

Settings Walkthrough

General Section

Enable - Toggles alerts on or off
Disable in instance - If checked, suppress alerts while inside of an instance
Minimap - Toggle the minimap button on or off
Time to wait - Controls how long to prevent duplicate messages from repeat authors from triggering a second alert (in seconds, 0 to disable the feature)

Sound Section

Enable - Whether to play a sound when alert is triggered
Alert Sound - The soundID (number) to play, this can be browsed on Wowhead
- There is a GitHub issue regarding a quick-add list of sounds, similar to the channels, and I'm trying to build a list of some good sounds to use; if you have some favorite alerts sounds please comment them!

Printing Section

Enable - Whether to print alerts to the screen
Destination - Where should the printed alerts be displayed
Print Message - If you want to override the default printed message, what you enter here is used as the format
- ${keyword}, ${author}, ${message} will be replaced with the respective fields when an alert is triggered
- E.g. [${author}]: ${message} will output an alert of the format: [Name]: Something said to trigger an alert
Base Text Color - The base color of the alert text (anything that isn't a replacement)
Keyword Color - The color to use for the keyword, colors both ${keyword} replacements and the keyword within ${message} replacements
Author Color - The color to use for the author
Message Color - The color to use for the message that triggered the alert

Trigger Section

Channels

Select New Channel - Quick-add list of channels you can add to be watched
Remove Channel - Selectable list of added channels, pick one to be removed
Remove Channel (Button) - Press the button after selecting a channel to remove it (along with associated keywords and filter words)
Add Channel - You can manually type in a channel name if you want to add something not in the quick-add list

Keywords

Select Channel - Selectable list of added channels, pick one to add keywords too
- MyChatAlert Globals is for keywords to watch for in every added channel
Add Keyword - Type in the keyword you want to be alerted for
- Simple keyword: dm - Alerts if dm is found in a message
- Advanced keyword: dm+west-east - Alerts if dm is found in a message that also contains west and does not contain east
Remove Keyword - Selectable list of added keywords, pick one to be removed
Remove Keyword (Button) - Press the button after selecting a keyword to remove it

Filter Section

Filter Words

Select Channel - Selectable list of added channels, pick one to add filter words to
- MyChatAlert Globals is for words to filter from every added channel
Add Filter - Type in a word if you don't want to receive alerts for messages containing the word
- E.g. guild - Don't alert for messages that contain guild, even if the message contains a keyword
Remove Filter - Selectable list of added filter words, pick one to be removed
Remove Filter (Button) - Press the button after selecting a filter word to remove it

Ignore Authors

Add Name - Type in the name of a player you don't want to receive alerts from
- E.g. GuildRecruiter: Don't alert for messages sent by GuildRecruiter, even if the message contains a keyword
Remove Name - Selectable list of added names, pick one to be removed
Remove Name (Button) - Press the button after selecting a name to remove it

Missing Localization

If you want to help translate the addon to your locale, you can view what phrases are missing on Curseforge

Support the Dev

Donation info was requested, so I added it to the Curseforge project. The side panel has a button with this PayPal link, or you can also use Venmo if you prefer that

ninthwalker / MyChatAlert