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

Discord setup and linking#

This page covers the complete administrator flow for connecting an UltimateClans installation and an individual clan to Discord.

Before you begin#

You need:

  • UltimateClans V9 with the Discord Module installed and enabled.
  • permission to add/manage the official TribeCraft bot in the Discord server;
  • access to the Minecraft server with uclans.discord_register.admin for the client-association command;
  • a clan member with the normal Discord command permission and the clan role permission Discord-Edit for clan registration.

The official bot invite is:

https://tribecraft.com.br/bot

Step 1 — Invite the official bot#

Open the official invite link and add the TribeCraft bot to the Discord server that will host the clan channels.

The bot is part of the integration transport. The current module does not ask you to create or paste a raw Discord webhook URL.

Step 2 — Register the Discord account/client#

In Discord, run:

/register-client

The bot registers the Discord account for the integration and shows the Discord user ID that must be associated with the Minecraft installation.

If the Discord account was already registered but was never associated with Minecraft, the bot reports that the registration is still pending.

Step 3 — Associate the Minecraft installation#

In Minecraft, run:

/discord_register client <discord_id>

Example:

/discord_register client 123456789012345678

This is the actual standalone administration command implemented by the module. It sends the Discord ID together with the Minecraft installation's internal client identity to the TribeCraft integration service.

A successful association is required before clans from that client can authenticate normally.

Common association failures#

The integration can reject the request when:

  • the Discord ID is malformed;
  • /register-client was never run for that Discord account;
  • the Discord account is already associated with another client;
  • the Minecraft client identity is already associated elsewhere;
  • the integration service cannot be reached.

Do not repeatedly create new registrations to work around one of these states; resolve the existing association first.

Step 4 — Register a clan from Minecraft#

A clan member with permission to manage Discord runs:

/clan discord register

The module opens/authenticates a connection for that clan using the clan UUID as its integration token. When the client is valid and the clan is allowed by the current plan, UltimateClans displays the token required by Discord.

If the clan is already connected, the command reports the existing state and can show the same clan UUID/token again.

Clan role requirement#

The member must pass the internal UltimateClans permission configured at:

Config.Permissions.edit.name

The default value is:

Discord-Edit

By default it applies to the moderator and admin clan roles.

Go to the Discord text channel you want to connect and run:

/link

The Discord command asks for:

  • type: CHAT or NOTIFICATION;
  • token: the clan UUID/token shown by Minecraft.

A single Discord channel cannot be linked to two clans at the same time. If the current channel is already linked, use /unlink there first.

CHAT or NOTIFICATION?#

CHAT#

Choose CHAT for the clan's conversation channel.

  • Clan chat from Minecraft is sent to this Discord channel.
  • Plain-text Discord messages are sent back to Minecraft clan chat.
  • Messages are subject to bridge restrictions and cooldowns.

NOTIFICATION#

Choose NOTIFICATION for automated notices.

  • Minecraft can send notifications to the channel.
  • Messages typed by Discord users are removed and are not forwarded to Minecraft.
  • The bot briefly explains that the channel is notification-only.

A clan can use both types at once by linking two different channels.

Step 6 — Verify the connection#

After /link succeeds, UltimateClans receives a link-success event and notifies the clan according to the linked type.

For a CHAT channel, test both directions:

  1. enter the clan chat context in Minecraft and send a short message;
  2. confirm it appears in the linked Discord channel;
  3. type a short plain-text reply in Discord;
  4. confirm clan members receive it in Minecraft.

For a NOTIFICATION channel, trigger a feature that sends a Discord notification and confirm it reaches only the notification channel.

Unlinking one Discord channel#

In a linked Discord channel, run:

/unlink

This removes the link belonging to that channel. If the clan has separate CHAT and NOTIFICATION channels, unlinking one does not inherently require deleting the other.

Removing the clan integration from Minecraft#

To remove the clan-side integration, use:

/clan discord unregister

This is broader than /unlink: the module asks the integration service to remove the clan link and closes the clan connection, then saves the clan Discord state as disconnected.

Removing the client association#

The Discord-side command:

/unregister-client

removes the registered client association for the Discord account. This is an account/client-level action, not a normal clan unlink operation. Use it only when the installation association itself needs to be removed or rebuilt.

Free clan allowance#

A registered client without the active integration subscription is allowed up to 5 clans by the supplied integration service. An active TribeSync Webhook subscription removes the clan-count limit.

When the allowance changes, affected clan connections can be suspended and later restored; the module does not intentionally erase the saved clan state just because the plan limit is reached.

Wiki Release 2026.09.5 · Canonical TribeCraft documentation.