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

Discord Module practical usage guide#

Use this guide when you want to deploy the UltimateClans Discord integration on a real server and verify it from both Minecraft and Discord.

What you are setting up#

There are two separate associations:

  1. Client association — proves which Minecraft installation is allowed to use the integration service.
  2. Clan channel link — connects one clan token to a Discord CHAT and/or NOTIFICATION channel.

Do the client association once for the installation, then register/link each clan that should use Discord.

  1. Install/enable the UltimateClans Discord Module.
  2. Invite the official bot from https://tribecraft.com.br/bot.
  3. In Discord, run /register-client.
  4. In Minecraft, run /discord_register client <discord_id> using the ID shown by Discord.
  5. Join or select a test clan with a member that has Discord-Edit.
  6. Run /clan discord register.
  7. Copy the clan UUID/token shown by UltimateClans.
  8. In a Discord test channel, run /link and select CHAT.
  9. Test Minecraft clan chat → Discord.
  10. Test plain Discord text → Minecraft clan chat.
  11. Optionally link a second channel as NOTIFICATION and verify that normal user chat is rejected there.
  12. Restart/reload the Minecraft server and verify the clan reconnects.

Using the Clan Settings GUI#

The module registers an icon in the UltimateClans settings GUI. Its default target page is clan_settings, slot 15, and both left/right click actions open the clan Discord command. The material, texture, glow, slot, page, click sound and actions are configurable under Config.Icon.

This is only a shortcut into the same integration flow; it does not bypass the player's Bukkit or clan-role permissions.

Registering additional clans#

After the client association is complete, each additional clan uses:

/clan discord register

and then /link in Discord with that clan's token.

The supplied integration service allows up to 5 clans on the free client allowance. An active TribeSync Webhook subscription removes that clan-count limit.

Testing the correct chat context#

The module forwards UltimateClans clan chat, not ordinary global server chat. If Minecraft messages are not reaching Discord, first confirm the player is actually speaking through clan chat and that the clan has an open Discord connection.

For communities that use both features:

Clan Discord category
├── clan-chat          (CHAT)
└── clan-notifications (NOTIFICATION)

Use Discord channel permissions to control who can view/write in the CHAT channel. The NOTIFICATION channel can be read-only for members because the bot itself rejects normal user messages there.

Safely changing message appearance#

Incoming Discord messages in Minecraft use Config.Discord.message_format. You can change colors, hover text and ordering while preserving the supported placeholders:

{player}
{message}
{role}
{server}
{uuid}

Keep {message} in the format or the Discord message body will not be visible to clan members.

Use /unlink in Discord when you only want to detach the current channel. Use /clan discord unregister when the clan integration itself should be removed. Use /unregister-client only when the Minecraft client association needs to be removed.

Wiki Release 2026.09.5 · Canonical TribeCraft documentation.