Cog: Moderation - PKlempe/SAM GitHub Wiki
A cog containing commands regarding the moderation of the server. Most of them can only be used by the moderators except for some exceptions specified below.
Hint: Arguments between angled brackets
<>are required while the ones between squared brackets[]are only optional.
| Usage | Example | Description |
|---|---|---|
| report <user> <description> | !report Wumpus#1234 He broke a rule! | Reports a user to the moderators by using their ID, name + discriminator, name, nickname or by simply mentioning them. All variants except for the last one won't ping the offender. |
| modmail <message> | !modmail Hey Mods! I wanted to ask you ... | Sends a modmail message to the moderators of the server. |
Hint: Arguments between angled brackets
<>are required while the ones between squared brackets[]are only optional.
| Usage | Example | Description |
|---|---|---|
| lockdown [channel] | !lockdown #offtopic | Puts the current or specified channel in lockdown by removing the "write_messages" or "connect" permission from the default role. |
| lockdown lift [channel] | !lockdown lift #offtopic | Lifts the lockdown for the current or specified channel by granting the "write_messages" or "connect" permission to the default role. |
| lockdown server | !lockdown server | Puts the whole server in lockdown by removing the "write_messages" and "connect" permission from the default role server-wide. |
| lockdown server lift | !lockdown server lift | Lifts the lockdown for the whole server by granting the "write_messages" and "connect" permission to the default role server-wide. |
| warn <user> [reason] | !warn @Wumpus Wait, that's illegal. | Warns the specified member. If enough warnings have been received, the bot will award configured punishments automatically. |
| warnings <user> | !warnings @Wumpus | Shows a list of all the warnings the specified user has received until now. |
| warning remove <warning_id> [reason] | !warning remove 3 Oops. Wrong user. | Removes the warning with the specified id from a member. |
| warning clear <user> | !warning clear @Wumpus | Removes all warnings given to the specified member. |
| mute <user> [reason] | !mute @Wumpus He writes silly stuff. | Mutes the specified member server-wide. He/She won't be able to write messages, join voice channels or even add reactions. This is done by granting the configured mute role. |
| umute <user> [reason] | !unmute @Wumpus That's long enough. | Unmutes the specified member on the server. This is done by removing the configured mute role from him. |
| tempmute <user> <duration> [reason] | !tempmute @Wumpus 5d He annoys other people. | Same effect as the "mute" command but only temporarily for the specified duration. |
| kick <user> [reason] | !kick @Wumpus No bots allowed. | Kicks the specified member from the server. |
| ban <user> [reason] | !ban @Wumpus Breaks the rules too often. | Bans the specified member from the server. |
| tempban <user> [reason] | !tempban @Wumpus Think about what you did. | Temporarily bans the specified member from the server for the duration given. |
| namehistory <user> | !namehistory @Wumpus | Shows a list of all the nicknames which the specified member has used on the server. |
| newmembers [amount] | !newmembers 5 | Shows the last X users who have joined the server. |
| avatar <user> | !avatar @Wumpus | Shows the avatar of the specified user. |
| userinfo <user> | !userinfo @Wumpus | Shows various information about the specified member. |
| purge [channel] <amount> | !purge #offtopic 15 | Deletes the last X messages in the current or specified channel. |
| modmail get <status> | !modmail get open | Shows a list consisting of all the received modmail messages with the specified status. |