Documentation / Clans / Settings
On this page
Overview Who can configure The Clans settings page Max channel lifetime Inactivity window Clan log channel Required roles to create clans Feature enabled toggle /clan-* command channel restriction Whitelist Blacklist Clearing the restriction The clan list Force disband a clan Saving Limits & Edge Cases

Clans — Settings Premium

The server-wide configuration page for the Clans feature — channel timers, the clan log channel, the creator-role gate, the feature toggle, command channel restrictions, and oversight of every clan in the server.

Overview

The Clans settings page lives under the Clans sidebar category in the guild (owner/manager) dashboard. It's where you configure how Clans behaves for the whole server and where you oversee the clans your members have created.

Who can configure

Only the server owner, managers, and Mokito admins can open the Clans settings page. Everyone else gets an access-denied response.

The Clans settings page

The page has three sections: a settings form, a /clan-* command channel restriction widget, and a read-only clan list with a force-disband action per row. The save button is at the bottom of the settings form.

Max channel lifetime

A dropdown that sets the hard cap on how long a clan's channels can stay live. Choices are 1 to 24 hours. When a clan's channels have been live for this many hours, Mokito force-closes them regardless of activity. Default is 24 hours.

Inactivity window

A number field (1–1440 minutes) that sets the soft-close timer. If no messages are sent in a clan's text channel for this many minutes, Mokito closes the channels. Every new message in the channel resets the timer. Default is 30 minutes.

Clan log channel

A searchable text input that picks one channel in your server. When set, Mokito posts an embed to this channel for every clan event: clan created, member joined, application submitted / approved / denied / withdrawn, member left, member kicked, member promoted, member demoted, ownership transferred, channels spawned, channels closed, clan disbanded, and force-disbanded by management. Leave it blank to disable clan logging.

The field is a type-ahead search over your server's channels. If a channel you previously picked is deleted from Discord, the field shows a stale-channel warning the next time you open the page.

Required roles to create clans

A multi-select of your server's roles. If you pick one or more roles, only members who hold at least one of those roles can create a clan. Leave it empty to allow everyone to create clans. This gate only affects clan creation — joining an existing clan with an invite code is not restricted by this setting.

Feature enabled toggle

A checkbox that turns the entire Clans feature on or off for the server. When you turn it off:

This is the same effect as a Premium lapse, except the data is preserved indefinitely (there is no 24-hour purge) because the server still has Premium — you've just turned the feature off.

/clan-* command channel restriction

Restrict where the 10 clan slash commands can be used. The mode dropdown has three choices:

Whitelist

Only the channels you select below can use clan commands. Selecting a channel search box lets you pick from your server's channels. Commands invoked outside the whitelisted channels reply with an ephemeral "not allowed in this channel" message.

Blacklist

Clan commands work everywhere except the channels you select below. Useful for keeping clan commands out of announcement or rules channels.

Clearing the restriction

Set the mode dropdown back to No restriction — all channels to allow clan commands in every channel again. The previously selected channels are forgotten.

The clan list

Below the settings form is a read-only list of every active clan in your server, sorted alphabetically by name. Each row shows the clan's name, tag, invite code, owner, member count, and channel status. You cannot edit a clan from this list — that's the owner's job on the member panel. The one management action available here is force disband.

Force disband a clan

The red Force Disband button on each clan row lets management instantly disband a clan that's causing problems. A confirmation modal asks you to confirm before the clan is deleted. Force-disbanding:

Force disband cannot be undone. The clan and all of its data are permanently deleted. Use it for clans that violate your server rules — not for routine cleanup.

Saving

The settings form saves via AJAX. Click Save at the bottom of the form and a toast confirms the save. You don't need to save after using the force-disband button — that action takes effect immediately on confirmation.

Limits & Edge Cases