Introduction

Find out all you need to know about the Modlogs feature of SajuukBot, the core of reporting everything that happens in your discord 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.

SajuukBot's usefulness comes primarily in part to the Modlogs feature. Modlogs are a core part of any moderation bot: they give you an insight of all moderation actions occurring in the server. Some of the things you can find in the modlogs are:

• People who join and leave your server: useful for detecting spammers or raids being started.

• People who edit and delete their messages: useful for determining if people are breaking rules then removing all trace of the violation

• People that have any change to their profile like usernames, nicknames, roles and more.

All the data provided allows significant insight into behavioural patterns of members. The modlogs also provide a way of checking if people have triggered auto moderators, as well as logging command use.

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.

Please note that, in the sample configuration snippet below, the root key under "extra" uses a dummy ID. Please do not use this specific ID: for more details about how this section works, read the Multi Modlogs page.

modlog:
  master:
    channel: 0
    commands: false
    timestamp: false
    timezone: "Europe/London"
  extra:
    1234567:
      enabled: false
      events:
      options:
        hide issuer: false
        timestamp: false

Settings

All settings described below represent the configuration for what is deemed the master (or primary) modlog channel. You must configure one, even if you use filtered / multiple modlogs.

Setting	Description
channel	A channel where the modlog messages will be sent. It's highly recommended to make this a separate channel with no other content sent by other users. The channel ID given must represent a channel within the guild that the bot is able to see and post messages in.
commands	Toggles the modlog messages representing the invocation of bot commands by users. If this is disabled, no modlogs will be sent to validate that someone used a command.
timestamp	Toggles the inclusion of a formatted timestamp representing when the message was sent. If this is disabled, you will have to rely on Discord timestamps against messages to find out when a message was sent.
timezone	The timezone that the timestamp should be formatted in. This is an optional setting: if you define this, all modlog messages will use this timezone for the timestamp prefixed to modlog entries. The value given here MUST be a valid string as given by the TZ Database: you can find all the values that are allowed under the TZ database name column on Wikipedia: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones