Chat Mod

A hand full of changes in the background of the mod

Compatibility with a soon to be accepted mod (under review) Chat Format Mod https://modrinth.com/mod/chatformatmod

A handfull of Atlas Sprites being fixed mostly plant seeds / items related

What's new

🐛 Bug fixes

• Server lag & elytra resets on broadcast — Broadcasts no longer cause a main-thread freeze when PlaceholderAPI is installed but the message doesn't use any of its placeholders. This was causing players to lose momentum and elytra to cut out mid-flight.
• Action bar duration ignored — Action bar messages now stay visible for the full duration_seconds instead of disappearing after ~3 seconds.
• TITLE line 4 not showing — The fourth line (subtitle override) now displays correctly alongside the action bar line.

✨ New features

randomize_broadcast — Set to true to play broadcasts in random order instead of looping them in sequence.

randomize_broadcast: false

Per-player-count intervals — Automatically speed up or slow down broadcasts based on how many players are online.

players_5_interval_seconds: 240
players_10_interval_seconds: 180
players_25_interval_seconds: 120

ACTION_BAR upgrades

• Messages now hold for the full duration_seconds
• Add a second line to show subtitle text in the title area alongside the action bar
• Add more lines to cycle through them in sequence, each for duration_seconds

BOSSBAR multi-line — Add multiple lines to a bossbar broadcast and they will appear one after another, each for duration_seconds.

TITLE upgrades

• Now supports up to 4 lines: title / subtitle / action bar / subtitle override
• Add lines1:, lines2: etc. to cycle through multiple title screens in sequence within a single broadcast entry

Restoring the Console messages logging with an off toggle in config

ChatMod — Major Update 🧱 Atlas Sprite System — Overhaul

[#blockname] sprite tokens now work in every config context — MOTD, interval broadcasts, predefined broadcasts, info files, and chat — no longer restricted to OP-level players sprites.yml vanilla_replacements section now takes highest priority over all built-in sprite logic, including for [#chest]-style tokens (previously vanilla replacements only applied to held-item display, not typed tokens) [#chest] and any [#blockname] token now uses the same custom replacement as holding that item

👤 Player Head & Player Reference System — New Feature

[#playerhead:Name] — renders an inline player head sprite glyph in any context [@Name] — renders a formatted player name (text only) with hover and click [#@Name] — renders player head sprite + formatted name with hover and click [##@Name] — renders player head sprite only with hover and click All three accept %player% variants for dynamic contexts: [@%player%], [#@%player%], [##@%player%] Bare forms [@], [#@], [##@] resolve to the current player context (self) All work in every config: chat, MOTD, broadcasts, predefined broadcasts, info files Player head uses the correct MC 26.1.x PlayerSprite component format ({"type":"object","player":{"name":"..."},"hat":true}) @name and name@ trailing form both accepted; [@name], [#@name], [##@name] now correctly excluded from the chat @-tag interceptor

💬 Player Name Hover — New Feature

Hovering any player name in chat now shows a fully customisable tooltip instead of the vanilla "Name / Type: Player / UUID" popup Applies to chat display names, advancements, and all [@] / [#@] / [##@] tokens Permission-based hover profiles — define different tooltips for different ranks (e.g. admins see ping, UUID, world; regular players see rank and balance) Each profile has two independent sections:

player_lines / player_command — shown when hovering the sender's name in chat chat_lines / chat_command — shown when hovering an inline [@Name] token

Clicking a player name can trigger a command (suggest:/msg %player% by default) EcobalAPI support — %ecobal_balance% and %ecobal_balance_formatted% available in hover lines (soft dependency, no crash if not installed) TextPlaceholderAPI placeholders supported in hover lines (e.g. %luckperms:primary_group_name%) Hover styles no longer bleed into the chat message body (isolated to the name component leaf nodes only)

🏷️ @Tag System — Improvements

@PlayerName and PlayerName@ both accepted as tag forms @everyone and everyone@ both accepted; output always renders as @everyone at the front Tag formats (player_tag_format, everyone_tag_format) moved from messages.yml to placeholders.yml alongside all other formatting configuration

🎨 Chat Colour — New Feature (/cm chatcolor)

/cm chatcolor blue — set a persistent colour that prepends every chat message /cm chatcolor b or /cm chatcolor &b or /cm chatcolor 14568f — all input forms accepted /cm chatcolor [#dirt] — use an atlas sprite as a chat prefix /cm chatcolor player — use your own player head sprite as a chat prefix /cm chatcolor (bare command, no argument) — clears your colour /cm chatcolor — admins can set/clear other players' colours Permission nodes: chatmod.chatcolor.self, chatmod.chatcolor.others, chatmod.chatcolor., chatmod.chatcolor.RRGGBB (hex), chatmod.chatcolor.sprites (all sprites), chatmod.chatcolor.sprite., chatmod.chatcolors (all colours wildcard)

📋 Permission Split — chatmod.chat.colors

chatmod.chat.colors replaced by two separate nodes:

chatmod.chat.color — allows colour codes (&0–&f, &#RRGGBB) in chat chatmod.chat.format — allows formatting codes (&l, &o, &n, &m, &k, &r) in chat

📢 Broadcast System — Improvements

broadcast_randomize: true — broadcasts picked randomly instead of in order Per-player-count intervals — broadcast_player_count_intervals list: configure shorter intervals at higher player counts, evaluated dynamically every tick /cm bcnow chat/title/actionbar/bossbar — send an ad-hoc broadcast to a single specific player (existing global bcnow commands unchanged)

📦 Items GUI — Paging

/cm items — GUI now supports unlimited item pages (54 items per page) [item:N] placeholder slot numbers are now unbounded (page 2 = slots 55–108, etc.) /cm items 2, /cm items 3, etc. — open subsequent pages Items on other pages are preserved when editing any single page

⚙️ Config — placeholders.yml Expanded

All player-name and tag formatting now centralised in placeholders.yml New fields: player_tag_format, everyone_tag_format, player_name_format, player_icon_name_format, player_icon_only_format New player_hover_profiles map replacing the old single hover format — supports named profiles with permissions, separate player/chat sections, and independent click commands All player_* format strings support full ChatMod syntax including sprite tokens and [##@%player%]

⚙️ Config — chatmod.yml New Fields

broadcast_randomize: true/false broadcast_player_count_intervals: list of min_players + interval_seconds entries

🔧 Fixes

&+ centering now correctly counts atlas sprite tokens as 1 character wide instead of ignoring them [#@Name] / [##@Name] / [@Name] tokens no longer intercepted by the @-tag pattern in chat processing Hover styles on player display names no longer propagate into the appended message body Player head sprite purple/black box fixed — correct MC 26.1.x JSON codec format used ({"type":"object",...} not {"type":"minecraft:object",...}) vanilla_replacements in sprites.yml now evaluated before aliases and built-in overrides (correct priority order)

Config changes: Made the last 2 json configs YML too.

Chat format fix, old feature crawled back in by mistake making styled chat less compatible. Compatibility with styled chat is stronger again

🎨 Atlas Sprite Icons (Minecraft 1.21.9+) The biggest feature addition: inline item and block icons rendered directly in chat, titles, action bars, boss bars, and all other text contexts using Minecraft's new object text component. New syntax for players in chat:

[#item] — shows the atlas sprite icon of your held item + its name [#item:3] — same for predefined item slot 3 [##item] — shows only the icon (no name) of your held item [##item:3] — icon only for predefined slot 3 [#diamond] — shows any named sprite inline (block names, item names)

Custom placeholder icon syntax:

[spawn] — text only, even if icon: is set in placeholders.yml [#spawn] — shows the configured icon + text [##spawn] — shows only the configured icon

Permission nodes added:

chatmod.chatitem.icon — use [#item] / [#item:N] chatmod.chatitem.icon_only — use [##item] / [##item:N] chatmod.chaticon — use [#SpriteName] in chat

📋 New sprites.yml config A new configuration file that maps short alias names to full atlas sprite paths. Lets admins define grass: "block/grass_block_side" so players can type [#grass] instead of the full path. Ships with aliases for common blocks, items, and the three special entity sprites available in the blocks atlas. Reference link included: https://www.gamergeeks.net/apps/minecraft/list-of-atlas-sprites

📢 Broadcasts — Full placeholder support All [] placeholder syntaxes now work in every broadcast type including /cm bcnow, predefined broadcasts, and the cycling legacy broadcaster — across CHAT, ACTION_BAR, TITLE, and BOSSBAR display types.

[spawn], [discord] and all custom placeholders now expand in broadcast messages [item:N] (predefined slot items) now render correctly in broadcasts even without a player context [#item] and [##item] in /cm bcnow and scheduled broadcasts now resolve to the held item of the player who issued the command

Config Overhaul & Broadcast Types Config format changed from JSON → YAML. All config files (chatmod.yml, messages.yml, placeholders.yml, predefined_broadcasts.yml) are now YAML with full #comment support. Existing JSON configs are automatically migrated on first launch — your data is not lost.

Predefined broadcasts now support all 4 display types. Each entry in predefined_broadcasts.yml can now set type: CHAT, type: ACTION_BAR, type: TITLE, or type: BOSSBAR, with the matching options (duration_seconds, boss_bar_color, boss_bar_overlay) for title and bossbar entries.

/cm bcnow now supports all 4 broadcast types. Syntax changed to /cm bcnow <chat|title|actionbar|bossbar> . Examples: /cm bcnow actionbar Server restarts in 5 minutes! /cm bcnow title Welcome to the server!. Works with the scheduler too: /cm time 10m often 3 bcnow title Event Starting!

Fixed custom command Aliases