Chat Mod

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.

💬 Primary Support (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord Server. We actively monitor it and will respond as soon as possible so the whole community benefits.

🆘 Urgent PM Policy

You may PM me directly only under specific urgent circumstances:

• Allowed reason: Your server is crashing or experiencing critical, game-breaking errors directly related to this mod.
• Requirement: You must be the server owner.
• Time zone: (CET/CEST) — Brussels Time
• PM hours: 10:00 AM – 10:00 PM Brussels Time only

Immediate responses are not guaranteed. Private messaging is a professional courtesy, not an entitlement. Thank you for your understanding!

⚠️ Version Note — Atlas Sprite Icons

Atlas sprite icon features ([#SpriteName], [#item], [##item], custom placeholder icons) require Minecraft 1.21.9 or newer. 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

• Custom Hover Profiles: 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

• Persistent Chat Colors: Use /cm chatcolor <color> to set a permanent style for your messages. Supports Hex (#RRGGBB), color names, and even sprites as prefixes.
• Atlas Sprite Prefixes: 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.

• Dynamic Intervals: Use broadcast_player_count_intervals to send messages more frequently when the server is full.
• Randomization: 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 personalized welcome message on join.
• Supports a rich set of built-in placeholders and now supports Atlas Sprite tokens in every context.
• Full Minecraft color codes, hex colors, hover text, and click actions.

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

• Create unlimited custom commands 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.

• Unlimited Paging: Supports 54 items per page with unlimited pages.
• Persistent Slots: Reference items on any page using [item:N].

🏷️ Player Tagging & Mentions

• @PlayerName or PlayerName@ — 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

Chat & Identity

• chatmod.chat.color — Use color codes (&0-&f, Hex)
• chatmod.chat.format — Use formatting codes (&l, &o, etc.)
• chatmod.chatcolor.self — Change your own chat color
• chatmod.chatcolor.others — Change others' chat color
• chatmod.chatcolor.sprites — Use sprites in chat color
• chatmod.player.tag — Tag players with @Name

Atlas Sprites

• chatmod.chaticon — Use [#SpriteName] icons
• chatmod.chatitem.icon — Use [#item] (icon + name)
• chatmod.chatitem.icon_only — Use [##item] (icon only)

Admin & Broadcast

• chatmod.reload — Reload all configs
• chatmod.bc.now — Send / schedule broadcasts
• chatmod.items.edit — Edit predefined items GUI
• chatmod.info.<name> — Access specific custom commands

Modpack Policy

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