Moderation

Manage warnings, timeouts, bans, jail, cleanup, and moderation records.

Before you moderate

Commands check permissions and role hierarchy. The bot needs the relevant Discord permission, and its role must be able to manage the target. Some commands also require the server owner or configured staff access.

Warnings and timeouts

Warnings create records. Durations support units such as s, m, h, d, and w. Unmute removes an active timeout.

,warn @member Repeated spam
,timeout @member 30m Repeated spam
,unmute @member

Bans and jail

Temporary bans store an expiry and are lifted by scheduled checks. Jail needs configured roles and channel permissions; use setup or jailsetup first.

,tempban @member 1d Repeated rule violations
,jailsetup

Review and personalize

Use history and audit to review activity. Invoke templates customize responses, and log routes choose where events are reported.

Logging

Route moderation, message, member, and server events to staff channels.

Customization

Customize the bot’s server profile and moderation messages.

Fake Permissions

Grant bot-level permissions to roles without changing their Discord permissions.

Command reference

Examples use the default comma prefix. Required inputs use angle brackets; optional inputs use square brackets. Each command notes whether it is also registered in Discord’s slash menu.

,ban

Permanently ban a member from the server.

Aliases: ,banuser.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

ban

Permanently ban a member from the server.

Prefix syntax

,ban <user> [delete_days] [reason]

Parameter	Required	Description
user	Yes	Member to ban
delete_days	No	Days of messages to delete
reason	No	Reason

,softban

Ban and immediately unban a member to clear recent messages.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

softban

Ban and immediately unban a member to clear recent messages.

Prefix syntax

,softban <user> [delete_days] [reason]

Parameter	Required	Description
user	Yes	Member
delete_days	No	Days of messages to delete
reason	No	Reason

,tempban

Temporarily ban a member.

Aliases: ,tban.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

tempban

Temporarily ban a member.

Prefix syntax

,tempban <user> <duration> [reason]

Parameter	Required	Description
user	Yes	Member
duration	Yes	1h, 3d, 2w, or 30d
reason	No	Reason

,unban

Unban a user by ID.

Aliases: ,pardon.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

unban

Unban a user by ID.

Prefix syntax

,unban <user_id> [reason]

Parameter	Required	Description
user_id	Yes	Discord user ID
reason	No	Reason

,kick

Kick a member from the server.

Aliases: ,boot.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

kick

Kick a member from the server.

Prefix syntax

,kick <user> [reason]

Parameter	Required	Description
user	Yes	Member
reason	No	Reason

,warn

Manage member warnings.

Aliases: ,warning, ,warnings.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

warn add

Warn a member.

Prefix syntax

,warn add <user> <reason>

Parameter	Required	Description
user	Yes	Member
reason	Yes	Reason

warn list

View warnings.

Prefix syntax

,warn list <user>

Parameter	Required	Description
user	Yes	Member

warn remove

Remove one warning by case number.

Prefix syntax

,warn remove <user> <case>

Parameter	Required	Description
user	Yes	Member
case	Yes	Warning case number

warn clear

Clear all active warnings.

Prefix syntax

,warn clear <user> [reason]

Parameter	Required	Description
user	Yes	Member
reason	No	Reason for clearing

,mute

Mute a member for Discord’s maximum 28-day timeout.

Aliases: ,silence.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

mute

Mute a member for Discord’s maximum 28-day timeout.

Prefix syntax

,mute <user> [reason]

Parameter	Required	Description
user	Yes	Member
reason	No	Reason

,timeout

Temporarily timeout a member.

Aliases: ,to.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

timeout

Temporarily timeout a member.

Prefix syntax

,timeout <user> <duration> [reason]

Parameter	Required	Description
user	Yes	Member
duration	Yes	10m, 2h, 3d, or 1w
reason	No	Reason

,unmute

Remove a member’s timeout.

Aliases: ,untimeout, ,unsilence.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

unmute

Remove a member’s timeout.

Prefix syntax

,unmute <user> [reason]

Parameter	Required	Description
user	Yes	Member
reason	No	Reason

,jail

Jail a member.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

jail

Jail a member.

Prefix syntax

,jail <user> [duration] [reason]

Parameter	Required	Description
user	Yes	Member to jail
duration	No	Optional duration such as 30m, 2h, or 3d
reason	No	Reason

,unjail

Release a jailed member.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

unjail

Release a jailed member.

Prefix syntax

,unjail <user> [reason]

Parameter	Required	Description
user	Yes	Member
reason	No	Reason

,jailconfig

Configure the jail system.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

jailconfig role

Set the jail role.

Prefix syntax

,jailconfig role <role>

Parameter	Required	Description
role	Yes	Jail role

jailconfig channel

Set the jail channel.

Prefix syntax

,jailconfig channel <channel>

Parameter	Required	Description
channel	Yes	Jail channel

jailconfig view

View jail configuration.

Prefix syntax

,jailconfig view

,jailsetup

Automatically create and configure the jail role and channel.

jailsetup

Automatically create and configure the jail role and channel.

Prefix syntax

,jailsetup

,jaillist

View every currently jailed member.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

jaillist

View every currently jailed member.

Prefix syntax

,jaillist

,purge

Bulk-delete messages with optional filters.

Aliases: ,clear, ,clean.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

purge

Bulk-delete messages with optional filters.

Prefix syntax

,purge <amount> [user] [contains] [bots] [attachments]

Parameter	Required	Description
amount	Yes	Messages to scan (1-100)
user	No	Only delete messages from this user
contains	No	Only delete messages containing this text
bots	No	Only delete bot messages
attachments	No	Only delete messages with attachments

,strip

Remove roles that grant dangerous server permissions.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

strip

Remove roles that grant dangerous server permissions.

Prefix syntax

,strip <user> [reason]

Parameter	Required	Description
user	Yes	Member to strip
reason	No	Reason

,hardban

Persistently ban a user, or view the hardban list.

Aliases: ,hb.

hardban

Persistently ban a user, or view the hardban list.

Prefix syntax

,hardban <target> [reason]

Parameter	Required	Description
target	Yes	User mention/ID, or ‘list’
reason	No	Reason, or the page number when viewing the list

,lock

Lock a channel.

Aliases: ,channel-lock.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

lock

Lock a channel.

Prefix syntax

,lock [channel] [reason]

Parameter	Required	Description
channel	No	Channel to lock
reason	No	Reason

,unlock

Unlock a channel.

Aliases: ,channel-unlock.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

unlock

Unlock a channel.

Prefix syntax

,unlock [channel] [reason]

Parameter	Required	Description
channel	No	Channel to unlock
reason	No	Reason

,slowmode

Set or disable channel slowmode.

Aliases: ,slow.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

slowmode

Set or disable channel slowmode.

Prefix syntax

,slowmode <duration> [channel]

Parameter	Required	Description
duration	Yes	Example: 10s, 2m, 1h, or off
channel	No	Channel to update

,history

View moderation case history.

Aliases: ,modhistory, ,cases.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

history

View moderation case history.

Prefix syntax

,history [user] [case] [action]

Parameter	Required	Description
user	No	Filter by member
case	No	Open a specific case
action	No	Filter by action

,audit

View recent Semetary audit records.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

audit

View recent Semetary audit records.

Prefix syntax

,audit [type] [limit]

Parameter	Required	Description
type	No	Filter by audit type. Choices: invites, messages, members, boosts.
limit	No	How many records to show.

,nuke

Clone the current channel.

nuke root

Clone the current channel.

Prefix syntax

,nuke root

nuke add

Schedule a recurring nuke for a channel.

Prefix syntax

,nuke add <channel> <interval> [message]

Parameter	Required	Description
channel	Yes	Channel to nuke
interval	Yes	Repeat interval, such as 1d or 12h
message	No	Message sent after each nuke

nuke remove

Remove a scheduled nuke for a channel.

Prefix syntax

,nuke remove <channel>

Parameter	Required	Description
channel	Yes	Scheduled channel

nuke list

View all scheduled nukes.

Prefix syntax

,nuke list

nuke archive

Configure pin archival for a scheduled nuke.

Prefix syntax

,nuke archive <channel> <setting>

Parameter	Required	Description
channel	Yes	Scheduled channel
setting	Yes	Whether pinned messages should be archived

nuke view

View scheduled nuke settings for a channel.

Prefix syntax

,nuke view <channel>

Parameter	Required	Description
channel	Yes	Scheduled channel

,kicknotify

View Kick profiles and configure notifications.

kicknotify

View Kick profiles and configure notifications.

Prefix syntax

,kicknotify

,feds

Search for a feds.lol profile.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

feds

Search for a feds.lol profile.

Prefix syntax

,feds <query>

Parameter	Required	Description
query	Yes	A feds.lol username, UID, or profile URL.

,cleanup

Remove bot invocations and messages from bots.

Aliases: ,bc.

cleanup

Remove bot invocations and messages from bots.

Prefix syntax

,cleanup [amount]

Parameter	Required	Description
amount	No	Number of recent messages to scan; defaults to 100

,pin

Pin a replied-to, linked, or recent message.

pin

Pin a replied-to, linked, or recent message.

Prefix syntax

,pin [message]

Parameter	Required	Description
message	No	Message URL or ID; omit when replying or to pin the latest message

,refresh

Refresh bot profile stats.

refresh

Refresh bot profile stats.

Prefix syntax

,refresh

,rename

Change a server member’s nickname.

Aliases: ,nick.

rename

Change a server member’s nickname.

Prefix syntax

,rename <user> <nickname>

Parameter	Required	Description
user	Yes	Member to rename
nickname	Yes	New nickname

,rename-channel

Rename a channel.

Aliases: ,rc.

rename-channel

Rename a channel.

Prefix syntax

,rename-channel <name> [channel]

Parameter	Required	Description
name	Yes	The new channel name.
channel	No	Channel to rename (defaults to current channel).

,thread

Lock, unlock, or configure forum threads.

Aliases: ,threads.

thread lock

Lock and archive the current thread.

Prefix syntax

,thread lock

thread unlock

Unlock and reopen the current thread.

Prefix syntax

,thread unlock

thread config lock

Configure tags applied when a thread is locked.

Prefix syntax

,thread config lock [add_tag] [remove_tag]

Parameter	Required	Description
add_tag	No	Forum tag name or ID to add; use none to clear
remove_tag	No	Forum tag name or ID to remove; use none to clear

thread config unlock

Configure tags applied when a thread is unlocked.

Prefix syntax

,thread config unlock [add_tag] [remove_tag]

Parameter	Required	Description
add_tag	No	Forum tag name or ID to add; use none to clear
remove_tag	No	Forum tag name or ID to remove; use none to clear

,unpin

Unpin a replied-to, linked, or recently pinned message.

unpin

Unpin a replied-to, linked, or recently pinned message.

Prefix syntax

,unpin [message]

Parameter	Required	Description
message	No	Message URL or ID; omit when replying or to remove the latest pin