TribeCraft Wiki · Release 2026.09.5
Wiki Release: 2026.09.5 · UltimateClans: 9.1.4 · Documentation branch: 9 · Discord

Discord chat and notifications#

The Discord Module supports two channel purposes. They are intentionally different and should normally be configured as separate Discord channels.

CHAT channel — two-way clan conversation#

A CHAT link bridges UltimateClans clan chat and Discord.

Minecraft → Discord#

The module listens for UltimateClans clan chat events. It forwards a message only when the player is in the clan chat context expected by the module, rather than copying all server chat to Discord.

The payload includes:

  • player UUID;
  • player name;
  • current UltimateClans role name;
  • the message with Minecraft color formatting removed;
  • the UltimateClans server name.

This lets the Discord side present a clan message with useful identity/context instead of sending an anonymous line of text.

Discord → Minecraft#

A message typed in the linked CHAT channel is sent to the authenticated clan connection and displayed through:

Config.Discord.message_format

The available message fields are:

  • {player} — Discord sender display/name supplied by the bridge;
  • {message} — plain-text Discord message;
  • {role} — role field supplied by the bridge;
  • {server} — server field supplied by the bridge;
  • {uuid} — Discord user ID supplied by the bridge.

The default format uses MiniMessage and includes hover information indicating the Discord origin and sender ID.

Discord → Minecraft safety restrictions#

The supplied integration bot deliberately limits what can cross into Minecraft clan chat.

Plain text only#

Discord messages containing any of the following are blocked from the Minecraft bridge:

  • http://, https:// or www. links;
  • inline/backtick code or code blocks;
  • file/image/video/document attachments.

The rejected Discord message is removed and the channel receives a temporary warning explaining that only plain text can be sent to Minecraft.

Message length#

Messages longer than approximately 200 characters are shortened before they are forwarded to Minecraft.

Cooldown#

The bridge applies a short message cooldown. Discord-side user messages and Minecraft-side clan chat forwarding are both protected against very rapid repeated sends by the supplied integration implementation.

If Minecraft sends too quickly, UltimateClans can receive a cooldown warning and show the clan how many seconds remain.

Minecraft server offline#

If the Discord bot has no active authenticated socket for the clan, a Discord CHAT message is not queued for later delivery. The attempted Discord message is removed and the channel receives a temporary notice that Minecraft is offline or the clan is disconnected.

NOTIFICATION channel — Minecraft to Discord only#

A NOTIFICATION link is intended for automated clan notices.

The module exposes a notification send path that strips Minecraft color formatting and sends the resulting text through the clan's authenticated connection to the Discord notification channel.

Users should not use this channel as a second chat channel. When a Discord user types in a linked NOTIFICATION channel, the bot removes the message, posts a short notification-only warning, and does not send anything to Minecraft.

A simple layout is:

#clan-chat            → CHAT
#clan-notifications   → NOTIFICATION

This keeps conversation separate from automated clan activity and makes permission/visibility management easier for Discord administrators.

Reconnecting after a temporary outage#

The Minecraft module tracks active clan WebSocket connections. Temporary non-intentional disconnects use progressive retry delays. Clans saved as connected are also registered again when the UltimateClans plugin lifecycle initializes the module.

Plan-limit suspension is handled differently: the saved clan state is preserved and the module uses a slower recovery path so the integration can return if the subscription/allowance becomes valid again.

Wiki Release 2026.09.5 · Canonical TribeCraft documentation.