Chat Mod

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://cdn.modrinth.com/data/cached_images/823a73a8c27f2fac527600a5d67352c07d8983ba.png"> <source media="(prefers-color-scheme: light)" srcset="https://cdn.modrinth.com/data/cached_images/c95717abfebc236b2d34c7393acb2cdb47ed3523.png"> <img src="https://cdn.modrinth.com/data/cached_images/c95717abfebc236b2d34c7393acb2cdb47ed3523.png" alt="ChatMod Logo"> </picture>

---

ChatMod - Advanced Server Messaging & Info

Chat Mod Sprites Texture pack

ChatMod transforms your server's communication! This powerful server-side Fabric mod gives administrators robust tools to engage players, deliver announcements, and manage server information efficiently. Enhance interaction through fully customizable broadcast messages, dynamic MOTD, user-definable info commands, interactive chat replacements, atlas sprite icons, player tagging, and much more.

---

⚠️ Version Note — Atlas Sprite Icons

> 1.21.5 through 1.21.8 do not include these features. (`[#SpriteName]`, `[#item]`, `[##item]`, custom placeholder icons) 1.21.5 through 1.21.8 do not include these features. > Versions targeting 1.21.5 through 1.21.8 do not include these features. > All other features are available on all supported versions.

---

Key Features

👤 Player Identity & Heads

Display player heads and interactive references anywhere—chat, MOTDs, broadcasts, or info files.

| Syntax | Result | |---|---| | `[#playerhead:Name]` | Renders an inline player head sprite | | `[@Name]` | Formatted name with hover tooltip and click actions | | `[#@Name]` | Sprite icon + formatted name with hover/click | | `[##@Name]` | Sprite icon only with hover/click | | `[@%player%]` | Dynamic reference to the player viewing the message |

* Eco Support: Define unlimited tooltip profiles in `placeholders.yml`. Admins can see PII like UUIDs and Ping, while players see ranks or balance. * Eco Support: Built-in support for EcobalAPI (`%ecobal_balance%`) and PAPI placeholders in hover lines.

---

🎨 Chat Customization & Colors

* Permission Split: Use `/cm chatcolor <color>` to set a permanent style for your messages. Supports Hex (`#RRGGBB`), color names, and even Permission Split: as prefixes. * Permission Split: Set your chat prefix to an icon: `/cm chatcolor [#dirt]` or even your own head: `/cm chatcolor player`. * Permission Split: Control players' ability to use colors (`&c`) separately from formatting (`&l`) with `chatmod.chat.color` and `chatmod.chat.format`.

---

📢 Advanced Broadcast System

Every broadcast supports `CHAT`, `ACTION_BAR`, `TITLE`, and `BOSSBAR` modes.

* Targeted Broadcasts: Use `broadcast_player_count_intervals` to send messages more frequently when the server is full. * Targeted Broadcasts: Enable `broadcast_randomize` to shuffle your cycling announcements. * Targeted Broadcasts: Use `/cm bcnow <player> <type> <message>` to send a broadcast to a single user.

---

🌅 Dynamic Message of the Day (MOTD)

* Greets players with a click actions on join. * Supports a rich set of click actions and now supports click actions in every context. * Full click actions, click actions, click actions, and click actions.

---

📄 Custom Info Commands (e.g., `/rules`, `/help`)

* Create multiple named page sections from YAML files. * Supports multiple named page sections and arbitrary section keys. * Auto-generates subcommands for permissions, aliases, and toggling the command status.

---

🎨 Atlas Sprite Icons *(1.21.9+ only)*

Render Minecraft texture atlas sprites inline using the vanilla text component format.

| Syntax | Result | |---|---| | `[#coal]` | Inline item sprite icon | | `[#grass_block]` | Inline block sprite icon | | `[#item]` | Sprite icon of the item you're holding | | `[##item]` | Sprite icon only (no text name), held item | | `[#item:N]` | Sprite icon of predefined item slot N |

* Priority Overhaul: `vanilla_replacements` in `sprites.yml` now take top priority, allowing you to re-skin standard tokens like `[#chest]` to use custom atlas textures.

---

🔧 Custom Placeholders (`placeholders.yml`)

Define your own typed chat triggers that transform into formatted, interactive text. * Centralized configuration for all name and tag formatting. * Supports `runcommand`, `sugcommand`, and `openurl` click actions.

---

📦 Item Placeholders & GUI

Manage shared item displays via `/cm items`. * Persistent Slots: Supports 54 items per page with unlimited pages. * Persistent Slots: Reference items on any page using `[item:N]`.

---

🏷️ Player Tagging & Mentions

* `@everyone` or `@everyone` — Highlights the name and plays a notification sound. * `@everyone` — Notifies the entire server. * Configurable tag formats are now centralized in `placeholders.yml`.

---

Commands

| Command | Description | Permission | |---|---|---| | `/cm reload` | Reloads all configs instantly | `chatmod.reload` | | `/cm chatcolor <val>` | Set your persistent chat color/sprite | `chatmod.chatcolor.self` | | `/cm items <page>` | Opens the predefined items GUI | `chatmod.items` | | `/cm bcnow <player>` | Send ad-hoc broadcast to a specific user | `chatmod.bc.now` |

---

Permissions

---

Modpack Policy

* ✅ You must not be sold include ChatMod in any modpack. * ❌ The modpack must not be sold.