Wiki Release: 2026.09.5 · UltimateClans: 9.1.4 · Documentation branch: 9 · Chat

Chat practical usage guide#

Chat adds clan chat routing and formatting integrated with the clan/player state. This guide focuses on the actual administrator and player workflow: what to set up first, how to test it in-game, and what to check before enabling it for everyone.

How the feature works#

In normal use, the feature follows this flow: Enable/configure the clan chat channel and formatting. Use the configured clan chat command/toggle, then verify only intended clan recipients receive the message. Test formatting with your external chat plugin if one is installed.

Recommended in-game workflow#

1. Enable/configure the clan chat channel and formatting.
2. Use the configured clan chat command/toggle, then verify only intended clan recipients receive the message.
3. Test formatting with your external chat plugin if one is installed.

Administrator setup checklist#

• Keep legacy color/format conversion compatible with the server chat stack.
• Test muted/no-clan/offline cases with non-OP accounts.

Commands and GUI access#

Use the command examples in the workflow above and open the Commands page in the sidebar for the complete configured command tree. Command labels can be changed in commands.yml, so the Wiki keeps the player-facing examples separate from the raw message templates.

Configuration areas#

• Clan — chat, player donthave clan

Changing settings safely#

1. Back up the component configuration and persistent data before changing a live server.
2. Change one feature area at a time.
3. Reload only if the component documents reload as safe; otherwise restart the server.
4. Test with a non-OP account that has exactly the intended clan role/permission.
5. Watch the console from the first relevant warning/error, not only the final stack trace.
6. On multiserver networks, repeat the check on every node and confirm shared storage/sync settings match.