Infractions Plugin
The infractions plugin provides a set of useful moderator commands. These commands are intended to be used together and help handle/track misbehaving users over time.
Commands
Command Name | Description | Default Level | Usage |
---|---|---|---|
!warn {user} [reason] |
Adds a warning infraction to a user | Moderator | !warn 330770985450078208 1st warning, spamming emoji OR !warn @Aperture#8658 2nd warning, going off-topic |
!mute {user} [reason] |
Mutes a user. This will only work if mute_role is set in the config |
Moderator | !mute 330770985450078208 spamming OR !tempmute @Aperture#8658 60m spamming |
!unmute {user} |
Unmutes a user | Moderator | !unmute 330770985450078208 |
!tempmute {user} {duration} [reason] |
Temporarily mutes a user. Will only work if temp_mute_role or mute_role is set in the config |
Moderator | !tempmute 330770985450078208 30m spamming OR !tempmute @Aperture#8658 30m spamming |
!kick {user} [reason] |
Kicks the user from the server | Moderator | !kick 330770985450078208 spamming OR !kick @Aperture#8658 spamming |
!mkick {users] -r [reason] |
Kicks multiple users from the server | Moderator | !mkick 330770985450078208 80351110224678912 108598213681922048 -r "Mass Spam" |
!ban {user} [reason] |
Bans a user from the server | Moderator | !ban 330770985450078208 spamming OR !ban @Aperture#8658 spamming |
!mban {users] -r [reason] |
Bans multiple users from the server | Moderator | !mban 330770985450078208 80351110224678912 108598213681922048 -r "I blame Eri for the spam" |
!unban {user} [reason] |
Unbans a user | Moderator | !unban 330770985450078208 |
!forceban {User ID} [reason] |
Force bans a user who is not currently in the server | Moderator | !forceban 330770985450078208 spamming |
!softban {user} [reason] |
Softbans (bans/unbans) a user and deletes the user's messages sent within the last 7 days | Moderator | !softban 330770985450078208 spamming OR !softban @Aperture#8658 spamming |
!tempban {user} {duration} [reason] |
Temporarily bans a user | Moderator | !tempban 330770985450078208 5h spamming OR !tempban @Aperture#8658 5h spamming |
!infractions archive |
Creates a CSV file of all infractions on the server | Administrator | !infractions archive |
!infractions search {query} |
Searches infractions database for given query | Moderator | !infractions search 330770985450078208 OR !infractions search Aperture#8658 OR !infractions search spamming |
!infractions info {inf#} |
Presents information on the given infraction | Moderator | !infractions info 1274 |
!infractions duration {inf#} {duration} |
Updates the duration of the given infraction. Duration starts from time of initial action | Moderator | !infractions duration 1274 5h |
!infractions reason {inf#} {reason} |
Updates the reason of a given infraction | Moderator | !infractions reason 1274 rude behaviour towards staff |
Configuration Options
Option | Description | Type | Default |
---|---|---|---|
confirm_actions | Whether to confirm that an action was done in the current channel | Bool | True |
confirm_actions_reaction | Whether to confirm actions done in the channel using a checkmark reaction | Bool | False |
confirm_actions_expiry | The duration after which to delete the confirmed action message. If zero the message will never be deleted | Int | 0 |
mute_role | Role ID that is set for users who are muted | ID | None |
reason_edit_level | Minimum level to allow users to edit other users' infraction reasons | Int | 100 |
notify_actions | Whether or not a certain infraction type should DM the user about their pending infraction. | List | Empty |
show_moderator | Whether or not the DM sent to the user getting the infraction is given the moderator who did it. | Bool | False |
silence_level | Minimum level to allow users to use the --silent flag |
Int | 100 |
Notify Actions Options
Option | Description |
---|---|
warn | Whether or not to send a Direct Message to the user about their upcoming Warning. |
kick | Whether or not to send a Direct Message to the user about their upcoming Kick. |
ban | Whether or not to send a Direct Message to the user about their upcoming Ban. |
tempban | Whether or not to send a Direct Message to the user about their upcoming Temp-Ban. |
softban | Whether or not to send a Direct Message to the user about their upcoming Soft-Ban (Will Show As Kick). |
unmute | Whether or not to send a Direct Message to the user about them becoming Un-Muted. |
mute | Whether or not to send a Direct Message to the user about their upcoming Mute. |
tempmute | Whether or not to send a Direct Message to the user about their upcoming Temp-Mute. |
Note About Notify Actions
Sometimes the bot is not able to send the User a Direct Message, this could be because:
- The Bot has been blocked by the user.
- The User has Direct Messages turned off.
- The User has left the server.
Configuration Example
infractions:
confirm_actions: true
confirm_actions_reaction: false
confirm_actions_expiry: 0
mute_role: 289494296703533058
reason_edit_level: 100
notify_actions: [WARN,KICK]
show_moderator: true
silence_level: 100