embellish chat

v3.6.0 Update

This v3.6.0 update focuses on adding Advanced Chat channel mentions and making invalid input handling more explicit.
It also improves log readability for server operators and makes chat processing more stable when unexpected errors occur.

New Features & Improvements

Advanced Chat Channel Mention Support

• A new ADVANCED_CHAT_CHANNEL mention type has been added.
• Function: You can now mention players who are currently in a specific Advanced Chat channel.
• In addition to player, team, world, LuckPerms group, permission-based, and custom targeting, channel-based targeting is now supported as well.

Same-Channel Mention Restriction

• A new require_same_channel configuration option has been added.
• Function: When enabled, players can only mention the Advanced Chat channel they are currently in.
• This option is enabled by default to help prevent players from unintentionally calling users in other channels.

Message Block Feedback

• Blocked messages can now show the reason directly to the sender.
• Function: When a message is blocked because of cooldown, invalid input, missing items, or channel restrictions, the sender receives a red notice.
• This makes it easier for users to understand why their message was not sent.

Input Handling Policy Changes

Invalid Mention Input Now Stops the Message

• Invalid mention targets are now treated as explicit input errors.
• Function: If a player tries to mention a non-existent player, team, world, selector, or Advanced Chat channel, the message is stopped and the sender is notified.
• Instead of silently ignoring invalid mentions, the mod now gives clear feedback so users can fix their input.

Mention Cooldown Now Stops the Message

• Messages that trigger an active mention cooldown are now stopped.
• Function: If a player tries to use a mention rule while it is still on cooldown, the message is not sent and a cooldown notice is shown.
• This makes mention cooldown behavior clearer and more predictable.

Item Style Handling Changed

• Item-related styles now require a valid item to be present.
• Function: If a player uses an item showcase style without an available item, the message is stopped and the sender is notified.
• Instead of sending an empty item showcase message, the mod now explains what is missing.

Logging & System Changes

Structured Log Prefixes Added

• Server logs now include clearer embellish-chat category prefixes.
• Function: Config, command, mention, style, integration, stress-test, lifecycle, and chat-log messages are now easier to distinguish.
• This makes troubleshooting configuration issues, integration problems, and chat processing failures more convenient.

Integration Logging Improved

• LuckPerms, Discord, and Advanced Chat integration logs have been clarified.
• Function: Missing integrations, failed Discord webhook delivery, and unavailable external APIs now produce more identifiable log messages.
• This helps server operators tell whether a problem comes from Embellish Chat itself or from an external integration.

Stability & Bug Fixes

• Unexpected errors during style or mention processing are now handled more safely. → Intended message blocks still stop the message, while unexpected processing errors are logged and the original chat message can continue.

• Config loading and saving logs have been made more specific. → Config read, validation, parse, and write failures are easier to identify from the server console.