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

results matching ""

    No results matching ""