Moderation Commands

Core moderation tools for server management and member protection.

Clear

Quickly deletes a specified number of messages from the current channel. The Slash command can also clear everything down to a target message ID while keeping that target message, as long as it is no older than 3 days. The prefix command keeps the existing amount-based syntax.

Usage:

/clear [amount to clear] [optional: user] [optional: clear_until_message]

;clear [amount to clear] [optional: user]

;purge [amount to clear] [optional: user]

Example:

/clear 5
/clear clear_until_message:1413565360911769600
;clear 5
;purge 100 @Wumpus

If clear_until_message is provided, /clear ignores amount and deletes messages newer than that message ID while keeping the target message itself. The target message must be from the last 3 days.

Required Role: Moderator

Pro Tip

Use this to quickly clean up spam or unwanted messages without manual deletion.

Mute

Temporarily mutes a member, preventing them from speaking in voice/text channels. Works as both a Slash command and a traditional prefix command.

Usage:

/mute [user] [optional: reason] [optional: time] [optional: send_dm]

;mute [user] [optional: reason] [-t time] [--timeout yes/no] [--dm yes/no]

Example:

/mute @Wumpus Advertising 1day Yes
;mute @Wumpus Advertising -t 1d --dm no
;mute @Wumpus (unmutes if already muted)

Notes:

If no time is specified, the user remains muted until manually unmuted
Running the command again on a muted user will unmute them
Set send_dm to Yes or use --dm yes to notify the user via DM

Required Role: Moderator

Kick

Removes a member from the server without banning them. Works as both a Slash command and a traditional prefix command.

Usage:

/kick [user] [reason]

;kick [user] [optional: reason]

Example:

/kick @Wumpus Spamming chat
;kick @Wumpus Spamming chat

Required Role: Moderator

Warning

The user can rejoin the server immediately after being kicked.

Ban

Permanently or temporarily removes a member from the server and prevents them from rejoining. Works as both a Slash command and a traditional prefix command.

Usage:

/ban [user] [reason] [optional: days to delete messages] [optional: ban duration]

;ban [user/user_id] [optional: reason] [-t duration] [-d delete_days]

Example:

/ban @Wumpus Repeated violations 7 permanent
;ban @Wumpus Repeated violations -t 7d -d 1
;ban @Wumpus (unbans if already banned)

Parameters:

days to delete messages / -d - Number of days of messages to delete (0-7)
ban duration / -t - How long the ban lasts (leave empty or use permanent for permanent bans)

Notes:

Running the command again on an already banned member will unban them (acts as a toggle, similar to mute).

Required Role: Moderator

Caution

This action is permanent (unless toggled/unbanned) and cannot be easily undone. Use caution.

Unban

Reverses a ban and allows a user to rejoin the server.

Usage:

/unban [userid] [optional: reason]

Example:

/unban 123456789012345678 Appealed via Google Forms

Required Role: Moderator

Info

You need the user's ID to unban them. You can find this by looking at the ban audit log or using the user's numeric ID.

Nickname

Changes a member's server nickname.

Usage:

/nickname [user] [nickname] [optional: reason] [optional: dm_user]

Example:

/nickname @Wumpus Wumpus Junior Nickname violation Yes

Parameters:

user - The member whose nickname you want to change
nickname - The new nickname (max 32 chars). Enter clear to reset the nickname to their default username.
reason - The reason for the nickname change (defaults to "No reason specified")
dm_user - Whether to send a DM notification to the user (True/False, defaults to False)

Required Role: Trial Moderator

Ban Appeals

Allows banned members to formally submit an appeal through the web dashboard, which is then dynamically routed to a designated discord channel for moderators to review.

Configuration:

Navigate to the Web Dashboard > Moderation > Ban Appeals.
Enable the feature and assign a targeted Log Channel where appeals will be actively deposited.
When enabled, members who are banned via the /ban command will automatically receive a DM outlining the reason and containing a secure link to submit their appeal.

Reviewing Appeals:

Appeals surface in the assigned log channel as rich Discord embeds.
Moderators can click Accept Appeal directly in Discord (which automatically unbans the member and updates the log embed status) or Deny Appeal.
Administrators can alternatively view, accept, or deny appeals natively via the View Appeal History tab within the dashboard settings.

Announce

Creates a formatted announcement and posts it as an embed to a channel.

Legacy Command

This command has not yet been ported to slash commands. Use: @raptor announce

Usage:

@raptor announce

Effects:

Opens an interactive prompt to create an announcement embed
Posts the formatted message to the specified channel

Required Role: Moderator

Repeat

Makes the bot repeat a specific message and deletes the original command message.

Not slash command

This is not a Slash command, use the server prefix to run this command. By default, that is ;

Usage:

;repeat [text]

Example:

;repeat Hello World!

Required Role: Moderator / Admin

Invite

Creates an unlimited, never-expiring invite for the current channel.

Usage:

/invite [optional: channel]

Effects:

Generates a permanent Discord invite link
Logs the invite generation in the designated moderator channel

Required Role: Admin

Export

Exports selected moderation-related server data and sends it as a .zip file attachment.

Usage:

/export list [type]

Types:

Server Emojis
Server Stickers
Server Soundboard
Server Info
Server Warnings
Server Automod History
Server Automod Config
User Leveling
Server Structure
All Available

Example:

/export list Server Warnings

Output:

A .zip attachment containing one or more JSON files based on the selected export type

Required Role: Admin

Channel Commands

Channel Lockdown

Makes a channel read-only for anyone with the @everyone role.

Usage:

/channel lockdown [channel]

Example:

/channel lockdown #general

Notes:

Members with higher roles can still send messages
Run the command again to unlock the channel

Required Permission: Manage Channels

Channel Hide

Hides a channel from anyone with the @everyone role.

Usage:

/channel hide [channel]

Example:

/channel hide #general

Notes:

The channel becomes invisible to unprivileged roles
Members with higher roles can still see and access it
Run the command again to show the channel

Required Permission: Manage Channels

Warning System

Manage member warnings and infractions.

automod-member status

View a user's current filter trigger counts and active punishment scaling level.

Usage:

/automod-member status [user]

Required Role: Moderator

automod-member reset

Clears all active violation counts and resets a user's scaling level to 1 for all rules.

Usage:

/automod-member reset [user]

Required Role: Moderator

warnings add

Issues a warning to a member, with an option to warn multiple users simultaneously.

Usage:

/warnings add [member] [optional: dm_member: yes/no] [optional: optional_user_ids]

Example:

/warnings add @Wumpus yes "123456789012345678, 234567890123456789"

Notes:

After running, Discord provides a text box to enter the warning reason
Optionally send the member a DM about their warning (Defaults to Yes)
optional_user_ids accepts space or comma-separated User IDs to process the warning on multiple users.

Required Role: Moderator

;warn (Prefix Command)

Warns one or more members. Works as a traditional prefix command.

Usage:

;warn [member(s) or user_id(s)] [optional: -dm yes/no] [reason]

Example:

;warn @Wumpus -dm no Spamming chat
;warn 123456789012345678, 234567890123456789 Mass advertisement

Notes:

Supports multiple space or comma-separated mentions and User IDs.
Use the -dm flag to choose whether to DM the warned member (defaults to yes). Accepted values (case-insensitive): Yes, No, True, False, 1, 2.

Required Role: Moderator

warnings recent

Lists all recently issued warnings.

Usage:

/warnings recent

Output:

Lists warnings by date and affected member
Sent to the moderator log channel

Required Role: Moderator

warnings lookup user

Shows all warnings for a specific user.

Usage:

/warnings lookup user [user] [optional: include_auto]

Example:

/warnings lookup user @Wumpus yes

Output:

Sent to the moderator log channel
Includes warning dates and reasons (both manual and auto infractions if include_auto is set to yes)

Required Role: Moderator

;warnings (Prefix Command)

Checks warnings on a user, or lists recent warnings if no user is specified. Works as a traditional prefix command.

Usage:

;warnings [optional: member] [optional: -auto]

Example:

;warnings @Wumpus -auto
;warnings

Notes:

If a member is specified, shows that member's warnings. If no member is given, lists the server's most recent warnings.
Add the -auto (or --auto / --include_auto) flag to include automod infractions alongside manual warnings — works for both user lookups and recent warnings (defaults to no).

Required Role: Moderator

warnings lookup id

Gets details about a specific warning by ID.

Usage:

/warnings lookup id [id]

Example:

/warnings lookup id 1234567

Required Role: Moderator

warnings send_dm

Manually sends a DM to the member for a specific warning ID if it was previously missed.

Usage:

/warnings send_dm [id]

Example:

/warnings send_dm 1234567

Required Role: Moderator

warnings remove specific

Removes a specific warning from a user's record.

Usage:

/warnings remove specific [id] [optional: reason] [optional: dm_member]

Example:

/warnings remove specific 1234567 "Appeal accepted" yes

Notes:

Optionally send the member a DM about the removal (Defaults to No)

Required Role: Moderator

Caution

Use this carefully, removing warnings should only be done for errors or appeals.

;delwarning (Prefix Command)

Removes a specific warning by its ID. Works as a traditional prefix command.

Usage:

;delwarning [warning_id] [optional: -dm yes/no] [optional: reason]

Example:

;delwarning 1234567 -dm no Appeal accepted

Notes:

Use the -dm flag to choose whether to notify the member of the warning removal via DMs (defaults to yes). Accepted values (case-insensitive): Yes, No, True, False, 1, 2.

Required Role: Moderator

fullpardon

Removes ALL warnings from a user, clearing their record.

Usage:

/fullpardon [user] [optional: reason] [optional: dm_member] [optional: only_automod]

Example:

/fullpardon @Wumpus "Clearing old history" yes yes

Notes:

Optionally send the member a DM about the pardon (Defaults to No)
Set only_automod to Yes to only remove warnings issued by the bot's automod system.

Required Permission: Manage Messages

Caution

This permanently removes all warning history. Use for appeals or correcting mistakes only.

warnings add_note

Adds a custom infraction note or update to a specific warning.

Usage:

/warnings add_note [text] [optional: id]

Example:

/warnings add_note "User is extremely argumentative about this" 1234567

Notes:

If Warning ID id is omitted, the bot will automatically default to the last infraction given by you if it is recent (within 1 hour).

Required Role: Moderator

warnings remove_note

Removes a specific infraction note from a warning.

Usage:

/warnings remove_note [id] [update_id]

Example:

/warnings remove_note 1234567 827163

Required Role: Moderator

warnnote (Prefix Command)

Prefix command to add an infraction note to a warning. Supports the aliases: ;addnote, ;warningnote, ;note, ;update.

Usage:

;warnnote -id [warning_id] [text]
;warnnote [text]

Example:

;warnnote -id 1234567 User was toxic
;warnnote User was toxic

Notes:

If Warning ID is omitted, it automatically targets your last given infraction, or the last warning in this server.

Required Role: Moderator