Clans — Command Reference Premium

The full reference for every Clans slash command.

Overview

Clans ships with 10 slash commands. They are separate top-level commands (not a subcommand group), so members type /clan-join, /clan-info, and so on directly. All commands are premium-gated and only registered with Discord on servers that have Premium and have the Clans feature enabled.

Most clan commands reply ephemerally — only the caller sees the response. The exceptions are /clan-spawn and /clan-close, which are ephemeral confirmations, and any action that posts a clan log entry to your configured log channel.

Permissions

Every clan command requires the caller to be a member of a clan in the server (except /clan-join, which is how you become one). Beyond that, each command checks the caller's clan role:

Command	Who can run it
`/clan-join`	Anyone not already in a clan in this server.
`/clan-info`	Any clan member.
`/clan-invite-code`	Any clan member.
`/clan-members`	Any clan member.
`/clan-spawn`	Owner or staff.
`/clan-close`	Owner or staff. Members cannot close channels.
`/clan-leave`	Member or staff. The owner must transfer ownership first.
`/clan-promote`	Owner only.
`/clan-demote`	Owner only.
`/clan-kick`	Owner or staff. Staff cannot kick the owner.

Channel restrictions

The server owner or manager can restrict where the /clan-* commands work by configuring a whitelist or blacklist on the Clans settings page. If a command is invoked in a disallowed channel, Mokito replies with an ephemeral "not allowed in this channel" message and does nothing.

`/clan-join`

Join a clan with its invite code. The behavior depends on the clan's join mode:

Auto — you join instantly and get the [TAG] nickname prefix plus channel access.
Apply — a pending application is created. The owner or staff will review it.
Deny — the clan is closed; the command tells you it isn't accepting new members.

Arguments

Name	Type	Required	Description
`code`	String	Yes	The 7-character invite code for the clan.

Example

/clan-join code: PxD5cX6

Responses (ephemeral):

Auto — You joined [B1PY] Black Pyramid!
Apply — Application submitted to [B1PY] Black Pyramid. The clan owner or staff will review it.
Already in a clan — You are already in a clan in this server. Leave it before joining another.
Invalid code — No clan found with that invite code.
Abuse cooldown — You've abandoned several clans recently — please wait until Jun 28, 2026 3:00 PM UTC before creating or joining another.

`/clan-info`

Show an ephemeral embed summarizing your clan — the tag and name, description, your role, member count, total messages captured, channel status, join mode, and the invite code in the footer.

Example

/clan-info

Response (ephemeral embed):

[B1PY] Black Pyramid
No description set.

Your role: Owner
Members: 12
Messages: 348
Channels: Channels are live
Join mode: Auto

Invite code: PxD5cX6

If you're not in a clan: You are not in a clan in this server. Use /clan-join with an invite code to join one.

`/clan-invite-code`

Reply with your clan's invite code so you can share it. Ephemeral.

Example

/clan-invite-code

Response: [B1PY] Black Pyramid — invite code: PxD5cX6

`/clan-spawn`

Spawn the clan's channel category (a category + one text + one voice channel). Only the owner or staff can run this. If the clan already has live channels, the command refuses. For large clans (more than 30 members) a temporary Discord role is created and used for access; for smaller clans, individual permission overwrites are used.

Example

/clan-spawn

Response: Clan channels for [B1PY] Black Pyramid are spawning. Members are being granted access — this may take a moment for large clans.

Access for large clans is granted in the background at a rate Discord accepts. Members may not see the channels the instant the command returns — give it a few seconds for big rosters.

`/clan-close`

Close the clan's channels early — the category, text channel, voice channel, and any temporary clan role are deleted. Only the owner or staff can run this. The clan itself is not deleted; the owner can re-spawn channels later with /clan-spawn.

Example

/clan-close

Response: Closed the channels for [B1PY] Black Pyramid. You can re-spawn them anytime.

`/clan-leave`

Leave your clan. Your [TAG] nickname prefix is removed and your previous nickname is restored; your channel access is revoked. The owner cannot leave — they must transfer ownership first (see the Member Panel page).

Example

/clan-leave

Response: You left [B1PY] Black Pyramid.

`/clan-members`

Show an ephemeral embed listing the first 30 members of your clan, sorted by role (owner first, then staff, then members). Each row is prefixed with an icon: 👑 for owner, 🛡️ for staff, • for members. The footer shows the total count if it exceeds 30.

Example

/clan-members

Response (ephemeral embed):

[B1PY] Black Pyramid — Members
👑 <@575805961315287061>
🛡️ <@684919170189885598>
• <@111111111111111111>
• <@222222222222222222>

12 members

`/clan-promote`

Promote a clan member to staff. Owner only. The promoted member gains the management capabilities listed under Clan roles on the overview page.

Arguments

Name	Type	Required	Description
`user`	User	Yes	The member to promote. Must be a current clan member.

Example

/clan-promote user: @sara

`/clan-demote`

Demote a staff member back to a regular member. Owner only.

Arguments

Name	Type	Required	Description
`user`	User	Yes	The staff member to demote. Must currently be staff.

Example

/clan-demote user: @sara

`/clan-kick`

Remove a member from the clan. Owner or staff can run this. The kicked member's [TAG] prefix is stripped, their previous nickname is restored, and their channel access is revoked. Staff cannot kick the owner.

Arguments

Name	Type	Required	Description
`user`	User	Yes	The member to kick. Must be a current clan member.

Example

/clan-kick user: @troublemaker