![\"Icon\"](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/common\/src\/main\/resources\/assets\/chatnotify\/icon.png\"){kind=icon}
<\/p>\n
## ChatNotify<\/p>\n
Plays a ping sound when your name is mentioned, with options to create custom alerts.<\/p>\n
![Environment]()
\n<\/p>\n
\n
\n<\/p>\n
\n
\n<\/p>\n
<\/center><\/div>\n
### Features<\/p>\n
– Custom triggers – never worry about missing a message again!
\n– Choose notification sounds from the full range of built-in and resourcepack sound effects.
\n– Adjust sound volume and pitch per-notification.
\n– Customize message highlighting with a color picker and format controls.
\n– Use regex patterns, inclusion and exclusion triggers for fine-grained control.
\n– Add automatic response messages or trigger CommandKeys
\n macros.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/chat_cropped.png\")
<\/p>\n
### How it Works<\/p>\n
1. ChatNotify has a list of `Notifications`, each of which has one or more `Triggers`.
\n2. When a new message arrives in chat, ChatNotify starts checking the triggers of each notification.
\n3. If a trigger matches the chat message, the corresponding notification will be activated. By
\n default;
\n 1. The message will be edited to highlight the trigger that activated the notification.
\n 2. A sound will be played.<\/p>\n
– You can create and customize your own notifications via the options screen, which can be opened
\n via ModMenu on Fabric, or the mod list on NeoForge.<\/p>\n
### Setup<\/p>\n
When you open the options screen, you’ll see a list of notifications. You can set the notification
\ntrigger, color and sound here.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/root\/notifications.png\")
<\/p>\n
#### Trigger types<\/p>\n
To change the trigger type, click the `~` button to the left of the text field.<\/p>\n
– Normal
\n – This is what you probably want to use at first. Normal triggers aren’t case-sensitive (so a
\n trigger `hello` will match messages containing `HELLO`), and they don’t match partial words (so
\n a trigger `rock` will match `rock!` but not `rocket` or `rock932`).
\n– Key
\n – In vanilla, each type of chat message has a different translation key (such as `chat.type.text`
\n or `chat.type.advancement.task`). You can use a key-type trigger to match all messages of that
\n type.
\n – Note: Many servers remove keys from messages, which will prevent this type of key from working.
\n To check if a message has a key, use the trigger editor (see below).
\n– Regex
\n – If you want more precise control, you can switch to this type and enter a regex pattern in the
\n text field.
\n – Consider using the trigger editor (see below) and\/or a tool such
\n as regex101 to help create regex patterns.<\/p>\n
#### Trigger editor<\/p>\n
Click the `\u270e` button to the left of the text field to open the trigger editor.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/trigger\/editor.png\")
<\/p>\n
In the trigger editor, recent chat messages will be displayed in a list (most recent first). Use the
\n`Filter` and `Restyle` buttons to preview the effect of your trigger.<\/p>\n
Click on a message to view the text and translation key (if any) so you can copy them.<\/p>\n
Additionally, some common keys are available for selection in the `Key Selector`.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/trigger\/selector.png\")
<\/p>\n
#### Trigger List<\/p>\n
If you want to add more triggers, go back to `Notifications` and click on the options button to the
\nleft of the color button. You’ll now see a list of triggers, which you can edit as desired.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/triggers.png\")
<\/p>\n
#### Style target<\/p>\n
Sometimes for key-type and regex-type triggers you may want to highlight a different part of the
\nmessage to what the trigger matches.<\/p>\n
Adding a style target allows you to specify what part of the message should be highlighted. If the
\nstyle target doesn’t match the message, the trigger will be used as normal.<\/p>\n
#### Format<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/format.png\")
<\/p>\n
#### Sound<\/p>\n
All built-in and resourcepack sounds can be used (click on the text field). Additionally, some
\nsounds are available for quick selection.<\/p>\n
The sound source controls which of Minecraft’s volume control sliders will affect the notification
\nsound, in addition to the volume control slider provided here.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/sound.png\")
<\/p>\n
#### Inclusion<\/p>\n
Inclusion triggers do nothing by themselves, but if a trigger from the `Triggers` list matches a
\nmessage, ChatNotify will check all the triggers in this list and only activate the notification if
\nthey all match.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/inclusion.png\")
<\/p>\n
#### Exclusion<\/p>\n
Exclusion triggers are the reverse of `Inclusion` triggers; before activating a notification,
\nChatNotify will check all the triggers in this list and only proceed with activation if none of them
\nmatch the message.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/exclusion.png\")
<\/p>\n
#### Response<\/p>\n
Response messages will be sent in chat when the notification is activated.<\/p>\n
Use with caution, as you can easily make a notification send a response which triggers the
\nnotification again in a loop, which will spam chat and then crash the game.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/response.png\")
<\/p>\n
#### Custom Messages<\/p>\n
These are special ways of showing notifications, as an alternative to the normal ‘play a sound and
\nhighlight the message’.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/notif\/misc.png\")
<\/p>\n
#### Controls<\/p>\n
These options apply to all notifications, and control various aspects of ChatNotify’s behavior. You
\nshould not generally need to change them (you can if you want, of course), but the `Detect` and
\n`Send Mode` options can be useful in certain cases of conflict with other mods.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/root\/controls.png\")
<\/p>\n
#### Defaults<\/p>\n
If you want new notifications to have a particular color or sound by default, you can set that here.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/root\/defaults.png\")
<\/p>\n
#### Prefixes<\/p>\n
When ChatNotify is not using Chat Heads to detect the message sender, it will store your sent
\nmessages and compare them to incoming messages to determine which messages were sent by you. If
\nyou’re on a server that modifies your messages, that system may not work properly, so prefixes can
\nhelp.<\/p>\n
If you’re still being notified on every message that you send (because it contains your name) try
\ninstalling Chat Heads and setting `Sender Detection Mode`
\nto `Combined` in the `Controls` tab.<\/p>\n
![](\"https:\/\/raw.githubusercontent.com\/TerminalMC\/ChatNotify\/HEAD\/assets\/images\/options\/root\/prefixes.png\")
<\/p>\n
### GUI Tweaks<\/p>\n ChatNotify uses a range of custom GUI widgets which behave differently to normal Minecraft.<\/p>\n 1. Color (`\ud83c\udf22`) and sound (`\ud83d\udd0a`) status buttons on the options screen support right-click to toggle – ChatNotify modifies the chat height slider (in Minecraft’s `Chat Settings`) to increase the ### Dependencies<\/p>\n Fabric: Fabric API, ModMenu<\/p>\n NeoForge: None<\/p>\n ### Compatibility<\/p>\n If you encounter issues, please report on Discord or GitHub.<\/p>\n ### Contact<\/p>\n <\/p>\n <\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" Plays a ping sound when your name is mentioned, with options to create custom alerts.<\/p>\n","protected":false},"featured_media":38892,"template":"","meta":{"_minecraft_slug":"chatnotify","_minecraft_project_id":"Iudurxl8","_minecraft_author":"NotRyken","_minecraft_license":"Apache-2.0","_minecraft_downloads":520304,"_minecraft_follows":282,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"chatnotify.zip","_minecraft_size_bytes":58608447,"_minecraft_version_count":155,"_minecraft_updated_at":"2026-05-16T16:41:11.856207Z","_minecraft_date_created":"2023-05-04T22:04:33.093783Z","_minecraft_date_modified":"2026-04-27T11:07:17.501056Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chatnotify","_minecraft_icon_attachment_id":38892,"_minecraft_imported_at":"2026-06-01T20:17:00+00:00","_minecraft_import_hash":"a054d418fa26d3e0a9690bf8e2343a1b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,158,98,867,92],"mod_loader":[99,106,160],"minecraft_version":[57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,831,167,163],"class_list":["post-38891","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-quilt","mod_category-social","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-rc-2","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nSpecial Widgets<\/b><\/summary>\n
\n status.
\n2. Text fields have been modified to support double-clicking, triple-clicking or clicking and
\n dragging to select text.
\n3. Text fields have also been modified to support `CTRL+Z` to undo and `CTRL+Y` to redo edits. Note
\n that edit history will be erased whenever the GUI is refreshed, which often happens when you
\n click on a different widget.
\n4. Fullscreen overlay widgets such as the color picker and drop-down text field support clicking
\n outside to cancel and close.<\/p>\n<\/details>\nChat Height Slider<\/b><\/summary>\n
\n maximum value to `500px`.
\n– Your existing setting will stay the same unless you decide to change it.<\/p>\n<\/details>\n