Infractions

Understand all the subcommands available for checking and managing a users' history of punishments in your community.

SajuukBot will be ceasing operations on March 31st 2024, due to a variety of factors. For more information, please refer to the announcement provided on the SajuukBot discord server and your options for migrating to a new bot.

So you have a mod policy on warning first, then tempmuting and then permabanning. But you want to make sure that your moderators check the users history first before deciding on actions. Giving punishments is all fine and well, but you really need a way of checking up the history of the user.

SajuukBot provides you with two methods to check infractions:

• Within discord servers themselves, you can use the !inf search command to pull back a record of all infractions the user has received. This works on people who are banned as well, so if you offer ban appeals, you can find out what they posted to get banned in the first place.

• Via the bots dashboard, for users who have permission to view them there. This allows you to find every infraction ever given, and provides easy filtering to find specific infractions in an easy to read table that doesn't involve command spamming.

As with the base moderation commands described on the Moderation page, the cleaning module uses levels and allows exemptions to be applied.

Configuration

This section of configuration is a root key, which means it should not be indented and in line with the basic settings like levels, prefix and the like. Please see the full basic configuration for more details on how it should be formatted.

infractions:
  enabled: false
  commands:
    search:
      enabled: false
      level: 50
    issuer:
      enabled: false
      level: 50
    info:
      enabled: false
      level: 50
    delete:
      enabled: false
      level: 100 
    clear:
      enabled: false
      level: 100
    reason:
      enabled: false
      level: 50

Commands

Due to space constraints, the required syntax of commands, and an example of how they work, are given provided after the list of commands and explanations.

Every command follows the exact same formatting:

• A key called enabled determining if the command is enabled or not.

• A key called level, determining the minimum level required to use the command

At the root of the infractions key is an enabled key, which globally controls the commands assigned to this module. If the root key is false, then no command will operate, regardless of whether an individual command is enabled.

All commands are subcommands to the !inf group. The reason command has a shorthand alias.

Command	Description
!inf search	Searches the database to find infractions from a specific user. The given argument can be a User ID or an @ mention. If the amount of infractions returned exceeds 2000 characters, the bot will paginate the output. Only the invoker can use the pagination functionality. You cannot search up infractions made against you using this command.
!inf issuer	Searches the database to find infractions issued by a specific user. The given argument can be a User ID or an @ mention. If the amount of infractions returned exceeds 2000 characters, the bot will paginate the output. Only the invoker can use the pagination functionality.
!inf info	Provides extended information about a specific infraction. The given parameter should be an Infraction ID, which can be found by using !inf search or the dashboard. The embed data will display expiry information of the infraction if it is a tempmute or tempban. Additionally, the embed colour bar on the left side will be red or green depending on active status.
!inf delete	Removes an infraction entirely from the database. Caveats: - You can only use this against your own issued infractions. - You cannot remove infractions issued against you. - You cannot remove infractions if the issuer of it has a higher effective level than your own.
!inf clear	Removes all infractions associated to a user. This is a destructive action, and it will ask for confirmation before doing anything. Once complete, the infractions are no longer retrievable in any manner.
!reason !inf reason	Alters the infraction reason on file. You can only update your own infractions: users with a higher effective level, or the server owner can update any infraction reason.

Syntax and Examples

Below are the syntax requirements of the above commands, along with an example to show how it works.

Syntax	Examples
!inf search QUERY	!inf search @SajuukBot#2980 !inf search 161815653387468800
!inf issuer QUERY	!inf issuer @SajuukBot#2980 !inf issuer 161815653387468800
!inf info INFRACTION_ID	!inf info 100
!inf delete INFRACTION_ID	!inf delete 100
!inf clear MEMBER/USER	!inf clear @SajuukBot#2980 !inf clear 161815653387468800
!inf reason INFRACTION_ID NEW REASON !reason INFRACTION_ID NEW REASON	!inf reason 100 This is a new reason to replace the existing one. !reason 100 This is a new reason to replace the existing one.