Configuring a moderation action log

Do you need to have all your moderation actions logged? Do you want to disable logs for certain actions? Well, these are both things that yzbot can do.

Permissions

There are some permissions that you will need to grant yzbot and for yourself to have before proceeding. Yzbot must have the EMBED_LINKS permission and you must have the MANAGE_SERVER or ADMINISTRATOR permission, or be the owner.

What will yzbot log?

So, which actions will yzbot log? By default, it will log every time that a moderation action is performed with yzbot. The specific commands are as follows:

• ban

• kick

• mute

• unban

• hackban

• softban

• unmute (auto unmute too)

Setting up a mod log

To set up a default mod log that will log all moderation actions, there is one command that you need to enter:

;modlog set <channel>

Let's see an example:

This will set the moderation log to #general. Now let's perform a moderation action.

Yzbot got banned, and the moderation log got posted.

Disabling and re-enabling certain logs

So you might not want yzbot to log certain actions, for example if a user got unmuted or hackbanned. In this example I'll demonstrate what it would look like if I disabled the unban log. To disable a log just type the following:

;modlog disable <log>

Where <log> is one of the logs I mentioned in the section 'What will yzbot log?'.

In the command I replaced <log> with unban because that's the command that I don't want logged. Now let's test this.

I'm in the general channel, and there is no mod log. That means that the log was successfully disabled. Now let's re-enable it. To do this, type the following:

;modlog enable <log>

Where, once again, <log> is one of the logs I mentioned in the section 'What will yzbot log?'. I will re-enable it and then unban yzbot again, after banning it.

Now let's unban yzbot.

Yzbot was successfully unbanned, and the moderation log was posted.

Listing disabled logs

If you have disabled some moderation logs and you want to know which ones you have disabled exactly, type this command to do so:

;modlog listdisabled

If there is more than one log, yzbot will list the logs which are disabled separated by a comma for every log.

Removing the mod log

You can stop yzbot from sending moderation logs altogether by just typing the command:

;modlog remove

After that, unless you choose to set the mod log again, yzbot will no longer post logs of moderation actions.