Cosmic Chat Alerts

A client-side Fabric mod that lets you create custom chat notifications through a fully in-game UI. Set a phrase or regex pattern to watch for, choose a sound, and the mod plays it whenever a matching message appears. Works on any server with no server-side installation required.

---

!screenshot: The main Chat Alerts list screen showing several configured alerts with green and red tinting, reorder arrows, and per-row controls

---

Features

Sound Alerts

Choose any in-game sound as your alert tone from a searchable picker with a quick-pick row for common choices. Sounds can be previewed before confirming. Volume is configurable per alert (0–200%) with automatic preview playback as you adjust the slider.

!screenshot: The sound picker screen showing the search field, quick-pick grid, scrollable sound list with a highlighted selection, and confirmation buttons

Pattern Matching

Alerts can match by plain text substring or full Java regular expression, with an optional case-sensitive toggle per alert.

On-Screen Text Alerts

Pair any alert with on-screen text displayed as a Title, Subtitle, or Action Bar message. Use $1, $2, … to embed regex capture groups into the displayed text — for example, detect "(\d+) seconds left" and display the number as a subtitle.

!screenshot: The alert edit screen showing the text alert section with type selector, duration slider, and a text template field using a $1 placeholder

Time Delay

Trigger an alert a set number of seconds after a message is detected, with decimal precision. Useful for countdowns — detect the start of an event and receive a reminder when it is about to end.

Formatting Palette

An inline color and style palette sits directly in the alert editor. Click any of the 16 color swatches or 5 style buttons to insert the formatting code at your cursor — no manual color codes required.

!screenshot: The color grid and style buttons within the edit alert screen

Load From Recent Chat

Browse your last 100 chat messages and load any one directly into the pattern field when creating or editing an alert.

Import & Export

Share alerts with other players using a compact JSON export code. Copy it from the editor, send it however you like, and the recipient can paste it directly into the Import screen.

Alert Management

• Name alerts for easy identification
• Enable or disable alerts individually without deleting them
• Reorder alerts with per-row ▲ / ▼ buttons, or sort all disabled alerts to the bottom in one click
• Green and red row tinting provides an instant visual overview of active alerts

---

Getting Started

Bind a key to "Open Chat Alerts" under the Chat Alerts category in Controls — it is unbound by default. The UI can be opened from anywhere, including the main menu.

---

Example Use Cases

• Server event starting soon — plain text match on "begins in 30 seconds"
• Time remaining on screen — regex "(\d+) seconds left" with display text $1
• Name mention detection — regex "(?i)YourName" with case-sensitive off
• Delayed reminder — detect an event start message, set a 300-second delay
• Multiple keywords — regex "(keyword1|keyword2|keyword3)"

---

Installation

1. Download the .jar file from this Modrinth project
2. Add the Cosmic Chat Alerts jar to your mods folder

Client-side only. No server installation required. Settings are stored in config/cosmic-chat-alerts.json.

Requires: Fabric API
Environment: Client only
Minecraft: 1.21.11