Documentation / Channel & Server Moderation

Channel & Server Moderation

Clear messages, lock or hide channels, slow chat down and handle emergencies.

!purge

ModeratorPrefixModule: purger

Purge a number of messages from the channel. You can specify specific modifiers to filter down which messages are to be deleted. Providing a user/role id will only purge messages from that user/role. Possible modifiers:
--startat: Dictates the newest message that the purge will start at, going older
--stopat: Dictates the oldest message that the purge will end at
--range: Provided two message ids, dictates a range of messages to delete
--startswith: Only delete messages that start with the provided text
--includes: Only delete messages that include the provided text
--endswith: Only delete messages that end with the provided text
--mentions: Only delete messages that contain the provided mention(s)
--links: Only delete messages that contain links
--bots: Only delete messages created by bots
--images: Only delete messages that contain an attachment
--invites: Only delete messages that contain an invite
--embeds: Only delete messages that contain an embed
--not: Will invert all options except startat, stopat, and range
--silent: Will not post the confirmation message, even for purges that don't purge the full amount

Members with the Discord Manage Messages permission can also use this command.

Usage

!purge amount
!purge amount modifiers
!purge amount target
!purge amount target modifiers*

Examples

!purge 10
!purge 10 --not --bots
!purge 10 --startswith pancakes
!purge 10 --startat 833536475148058624
!purge 10 --range 833536475148058624 833536475148058624

“I'm not your personal maid! I wear this outfit for my own personal enjoyment!”

!lock

AdminPrefix

Locks a channel so members can not send messages in the channel. You may also specify a role to lock the channel for as well as target a specific channel. If no channel is specified it will use the current channel, if no role is specified then it will use the everyone role.

Usage

!lock [channel] [role]

Examples

!lock
!lock @Role
!lock #Channel Rolename
!lock #Channel channel

“Oops, oh no, I lost the key to the lock, whatever will I do? Oh well.”

!unlock

AdminPrefix

Unlock a channel that has been locked via the lock command.

Usage

!unlock [channel] [role]

Examples

!unlock
!unlock light @Role
!unlock #Channel Rolename

“Why are you asking me about this? Go find a locksmith if you lost the keys.”

!hide

AdminPrefix

Hides a channel so members can not view the channel at all. You may also specify a role to lock the channel for as well as target specific channels. If no channel is specified it will use the current channel, if no role is specified then it will use the everyone role.

Usage

!hide [channels] [role]

Examples

!hide
!hide @Role
!hide #Channel Rolename
!hide #Channel channel

“I'm not 5, I'm not playing hide and go seek with you.”

!unhide

AdminPrefix

Unhide a channel that has been hidden via the hide command.

Usage

!unhide [channel] [role]

Examples

%unhide
!unhide @Role
!unhide #Channel Rolename

“If you can't find what you're looking for, do you really think asking me will find it?”

!slowmode

AdminPrefix + Slash

Throw a channel into 'slowmode' which limits users to sending a message only on a specfic interval. Discord channel slowmode will be used if the time is 6 hours or under. Above that, the bot's internal slowmode will be used. Note, the bot's slowmode will allow moderator and staff bypass, discord's may not.

Usage

!slowmode channel time/off
!slowmode server time/off
!slowmode current

Examples

!slowmode #Channel 6
!slowmode server off
!slowmode current
Slash command /slowmode

/slowmode current List current slowmodes

/slowmode server Set a slowmode for the server

OptionTypeDescription
time requiredTextTime for the slowmode or 'off'

/slowmode channel Set a slowmode for a specific channel

OptionTypeDescription
time requiredTextTime for the slowmode or 'off'
channelChannelChannel to set the slowmode on

“No you aren't Keanu Reeves and no this isn't bullet time.”

!stickymsg

ModeratorPrefix + Slash

Create a sticky message for a specific channel.

Usage

!stickymsg add/delete [channel] message

Examples

!stickymsg add Sticky message go here
!stickymsg delete #Channel
Slash command /stickymsg

/stickymsg add Add a new sticky message

OptionTypeDescription
message requiredTextThe message to keep stuck
channelChannelThe channel to post the message in

/stickymsg delete Delete a sticky message

OptionTypeDescription
channel requiredChannelThe channel to delete the sticky message for

“Don't you DARE use super glue, I swear, that stuff is impossible to get off.”

!autoforum

AdminPrefix + Slash

Modify operations performed for forum based guild channels, currently only supports auto posting messages to new forum posts.
For auto posting messages provide 'off' to turn a auto messager off.

Usage

!autoforum channel message

Examples

!autoforum 12312412412123 Please make your posts clean and informative.
Slash command /autoforum
OptionTypeDescription
forum requiredChannelForum channel to post automatically to
message requiredTextMessage to automatically post to new forum posts

“If only your users were as smart as me, then I wouldn't have to repeat myself.”

!nick

ModeratorPrefix + Slash

Rename a member via the bot. To add the current name to the nickname, use %name.

Usage

!nick member newname

Examples

!nick @12312412412123 New Name
Slash command /nick
OptionTypeDescription
memberUserUser to edit the nickname of.
memberidTextUser id to edit the nickname of.
newnameTextThe new name for the member

“Here's your new name, 'doofus', you've earned it.”

!freeze

AdminPrefix

Freeze the server by wiping all channel permissions.
WARNING: Use at your own risk. Many safeguards have been in place but you should still only use this command in the event of a massive raid across multiple channels. For single channels look into lock command instead.

Usage

!freeze

Examples

!freeze

“Every-body clap your hands!”

!thaw

AdminPrefix

Thaw the server that has been frozen by the 'freeze' command. You may also choose to recover an old backup if neccessary. You may fully thaw a server or thaw roles/members or channels one by one.

Usage

!thaw
!thaw recover [timestamp]
!thaw channel/role/member

Examples

!thaw
!thaw recover 1234567890
!thaw #Channel

“Oi, who turned on the heat? I like my ice palace!”

!panic

AdminPrefix

Enable or disable panic mode, as well as configure autopanic. Valid configuration options are 'users', 'seconds', and 'message'. To turn the auto panic on or off use 'auto'. To get current settings use 'current'.
Users: Dictates how many users must join in the timeframe to trigger autopanic
Seconds: Dictates the time frame in which the amount of users is exceeded to trigger autopanic
Message: Dictates the message sent to users who join during autopanic, will be dm'd to them if possible.

Usage

!panic [on/off]
!panic users number
!panic seconds number
!panic auto on/off
!panic current
!panic message message

Examples

!panic on
!panic users 5
!panic seconds 20
!panic auto on
!panic current
!panic message Hello, the server is currently in panic mode.

“Your own personal panic button! Except it's actually mine. Don't break it!”

!smartprune

AdminPrefix

Prune existing members with specific qualities. You may also prune invites under X amount of uses. Pruned users by default will be messaged why they were pruned. You can remove this by using 'nomessage'

Usage

!smartprune avatar/norole [nomessage]
!smartprune invite

Examples

!smartprune avatar nomessage
!smartprune invite

“Are we going to have a re-run of the autodel command here? Why do I have to clean up your messes?”

!stattrack

AdminPrefix

Add, edit, or review stat tracking channels. These channels can track different statistics. There are four types, 'members', 'countdown', 'clock', or 'age'.
Members: Tracks the total members in the server
Clock: Configure a clock to a specific timezone
Age: Show the current age of the server, in days.
Countdown: Countdown timer until a specified time.
For members, countdown and age, use %d to designate where to put the data
For clock, you may use the following:
%24: Use a 24 hour clock
%tz\\\*: Designate a specific [timezone](https://publib.boulder.ibm.com/tividd/td/TWS/SC32-1274-02/en_US/HTML/SRF_mst273.htm)
%-DST: Ignore daylight savings time (on by default)
%t: The current time (HH:MM AM/PM)
%d: The current day of the month
%wd: Current day of the week
%y: The current year
%m: The curren month

Usage

!stattrack current
!stattrack add channel clock/age/countdown/members message
!stattrack edit channel message
!stattrack rem channel

Examples

!stattrack current
!stattrack add #Channel clock %t %24 %tzGMT %-DST %d/%m/%y
!stattrack edit #Channel %t %tzEST %m/%d/%y
!stattrack rem #Channel

“You know, I could get in trouble for doing this...”

!setcounter

AdminPrefix + Slash

Set up a counting channel for people to count in.

Usage

!setcounter channel

Examples

!setcounter #Channel
Slash command /setcounter
OptionTypeDescription
channel requiredChannelChannel for people to count in

“My money is on them not making it past 10”