Docs Commands Reference Moderation Commands

Moderation Commands

Server moderation commands for managing members, roles, channels, and moderation records.

moderation ban kick mute warn timeout role channel jail

Ban

Permanently bans a user from the server. Checks role hierarchy to prevent banning higher-ranked members. Records the action in the moderation log database and sends a log entry to the configured log channel. Prevents self-banning.
/ban BanMembers
/ban <user> [reason]
user user required The user to ban
reason string Reason for the ban
Examples
/ban @user Repeated rule violations

Unban

Unbans a user from the server using their user ID. Also clears any active temporary ban (tempban) record from the database. Logs the action to the configured log channel.
/unban BanMembers
/unban <userid> [reason]
userid string required The user ID to unban
reason string Reason for the unban
Examples
/unban 123456789012345678 Appeal accepted

Tempban

Temporarily bans a user for a specified duration. Supports hours (h), days (d), and weeks (w) as duration units, with a maximum of 365 days. The ban is stored in the database with an expiration timestamp and is automatically lifted when the duration expires. Records the action in the moderation log.
/tempban BanMembers
/tempban <user> <duration> [reason]
user user required The user to ban
duration string required Duration: 1h (hour), 7d (day), 2w (week)
reason string Reason for the ban
Examples
/tempban @user 7d Cooling off period

Kick

Kicks a user from the server. Checks role hierarchy to prevent kicking higher-ranked members. Records the action in the moderation log database and sends a log entry to the configured log channel. Prevents self-kicking.
/kick KickMembers
/kick <user> [reason]
user user required The user to kick
reason string Reason for the kick
Examples
/kick @user Spamming in chat

Timeout

Applies a timeout (communication disable) to a user for a specified number of minutes. The user cannot send messages, react, or join voice channels during the timeout. Validates that the duration is at least 1 minute. Records the action in the moderation log.
/timeout ModerateMembers
/timeout <user> <duration> [reason]
user user required The user to timeout
duration string required Timeout duration in minutes
reason string Reason for the timeout
Examples
/timeout @user 30 Disruptive behavior

Untimeout

Removes an active timeout from a user, restoring their ability to communicate. Logs the action to the configured log channel.
/untimeout ModerateMembers
/untimeout <user> [reason]
user user required The user to remove timeout from
reason string Reason for removing timeout
Examples
/untimeout @user Timeout served

Mute

Mutes a user by applying a Discord timeout. Duration is specified in minutes and defaults to 60 if not provided. Maximum duration is 28 days (Discord timeout limit). Checks role hierarchy before applying.
/mute ModerateMembers
/mute <user> [duration] [reason]
user user required The user to mute
duration string Mute duration in minutes (default: 60)
reason string Reason for the mute
Examples
/mute @user 120 Excessive noise

Unmute

Removes a mute (timeout) from a user. Checks whether the user is actually muted before attempting to unmute. Verifies role hierarchy before acting. Logs the action to the configured log channel.
/unmute ModerateMembers
/unmute <user> [reason]
user user required The user to unmute
reason string Reason for unmuting
Examples
/unmute @user Mute period over

Voice Mute

Server-mutes a user in voice channels, preventing them from speaking. The target user must be connected to a voice channel. Checks role hierarchy before applying the mute.
/mute_voice MuteMembers
/mute_voice <user> [reason]
user user required The user to mute
reason string Reason for mute
Examples
/mute_voice @user Background noise

Voice Unmute

Removes a server-mute from a user in voice channels, allowing them to speak again. Checks role hierarchy before acting.
/unmute_voice MuteMembers
/unmute_voice <user> [reason]
user user required The user to unmute
reason string Reason for unmute
Examples
/unmute_voice @user Issue resolved

Warn

Issues a warning to a user. The warning is stored in the database with a case ID and timestamp. Also sends a DM notification to the warned user. Records the action in the moderation log. Prevents warning yourself or bots. Checks role hierarchy.
/warn ModerateMembers
/warn <user> <reason>
user user required User to warn
reason string required Reason for warning
Examples
/warn @user Breaking channel rules

Remove Warning

Removes the most recent warning from a user. If the user has no warnings, an error message is shown. Logs the removal action to the configured log channel.
/warn_remove ModerateMembers
/warn_remove <user>
user user required User to remove warning from
Examples
/warn_remove @user

Warnings

Displays the warning history for a user. Shows up to the 10 most recent warnings, each with a case ID, timestamp, moderator, and reason. Also displays the total warning count in the footer.
/warnings ModerateMembers
/warnings <user>
user user required User to check
Examples
/warnings @user

Modlog

Displays the full moderation history of a user in the current server. Shows bans, tempbans, kicks, timeouts, and warnings with type icons, timestamps, reasons, and moderator info. Includes a summary count of each action type. Configurable record limit (1-15, default 10). Requires ModerateMembers or BanMembers permission.
/modlog ModerateMembers or BanMembers
/modlog <user> [limit]
user user required The user to check
limit integer Number of records to show (default 10, max 15)
Examples
/modlog @user
/modlog @user 5

Clear

Bulk-deletes a specified number of messages from the current channel. Uses Discord's bulkDelete which only removes messages younger than 14 days. Accepts 1-100 messages. Logs the action with the count of actually deleted messages.
/clear ManageMessages
/clear <amount>
amount integer required Number of messages to delete (1-100)
Examples
/clear 50

Role

Adds or removes a role from a user via subcommands. Checks that the target role is below both the moderator's highest role and the bot's highest role. Prevents assigning managed (integration) roles. Shows an error if the user already has (or doesn't have) the role.
/role ManageRoles
/role add <user> <role> | /role remove <user> <role>
user user required Target user
role role required Role to add or remove
Examples
/role add @user @Member
/role remove @user @Muted

Mass Role

Adds or removes a role from multiple members at once via subcommands. Supports targeting all members, humans only, or bots only. Optionally filter by an existing role. Includes rate-limit protection and periodic progress updates during the operation. Shows a final summary with success/failure counts.
/massrole ManageRoles
/massrole add <role> <target> [filter_role] | /massrole remove <role> <target> [filter_role]
role role required Role to add or remove
target string required Who to target: All Members, All Humans, or All Bots
filter_role role Only members with this role (optional)
Examples
/massrole add @Verified humans
/massrole remove @Event all

Lock

Locks the current channel by denying the SendMessages permission for the @everyone role. Prevents all non-privileged members from sending messages. Logs the action to the configured log channel.
/lock ManageChannels
/lock
Examples
/lock

Unlock

Unlocks the current channel by resetting the SendMessages permission override for the @everyone role back to neutral. Logs the action to the configured log channel.
/unlock ManageChannels
/unlock
Examples
/unlock

Slowmode

Sets the slowmode (rate limit) for the current channel. Duration is specified in seconds, from 0 (disable) to 21600 (6 hours). Setting to 0 disables slowmode. Shows a different embed depending on whether slowmode was enabled or disabled.
/slowmode ManageChannels
/slowmode <duration> [reason]
duration integer required Slowmode duration in seconds (0 to disable, max 21600)
reason string Reason for slowmode
Examples
/slowmode 10 Calm the chat
/slowmode 0 Slowmode no longer needed

Set Nickname

Changes a user's server nickname. If no nickname is provided, resets the nickname to the user's default username. Shows both the old and new nicknames in the response. Checks role hierarchy before applying.
/setnick ManageNicknames
/setnick <user> [nickname]
user user required The user to change nickname
nickname string New nickname (leave empty to reset)
Examples
/setnick @user CoolName
/setnick @user

Voice Kick

Disconnects a user from their current voice channel. The target must be connected to a voice channel. Checks role hierarchy before disconnecting.
/vkick MoveMembers
/vkick <user> [reason]
user user required The user to kick from voice
reason string Reason for kick
Examples
/vkick @user AFK in voice

Jail

Jails a user by stripping all their current roles and assigning the 'Jailed' role. The user's original roles are saved to the database so they can be restored upon unjailing. Requires the 'Jailed' role to exist (use /jail-setup to create it). Logs the action.
/jail BanMembers
/jail <user> [reason]
user user required User to jail
reason string Reason
Examples
/jail @user Under investigation

Jail Setup

Automatically sets up the jail system by creating a 'Jailed' role and a 'jail-cell' text channel. The role is configured to deny ViewChannel, SendMessages, and Connect permissions on all existing channels. The jail-cell channel is only visible to users with the Jailed role. Skips creation if the role or channel already exists.
/jail-setup Administrator
/jail-setup
Examples
/jail-setup

Unjail

Releases a jailed user by removing the 'Jailed' role and restoring their previously saved roles from the database. Clears the jail record from the database. Returns an error if the user is not currently jailed. Logs the action.
/unjail BanMembers
/unjail <user>
user user required User to unjail
Examples
/unjail @user

Account Record (Seceresi)

Displays a privacy-safe global moderation summary for a user across all servers. Shows total and recent (last 30 days) counts of bans, kicks, timeouts, and warnings. Calculates a risk status (Clean, Low Records, Cautious, High Risk) based on total action count. Also displays account age and the number of affected servers. Does not reveal server names, moderator identities, or detailed reasons.
/seceresi ModerateMembers
/seceresi <user>
user user required The user to check
Examples
/seceresi @user
Next
Economy Commands

Related Articles

Moderation System
Configure moderation command permissions, role restrictions, and channel limits through the dashboard
Logging System
Track server events with 36 event types, per-event channel routing, and detailed audit logs through the dashboard
Logs Commands
Server logging configuration for tracking messages, members, channels, roles, voice activity, and invite events.