Moderation

Many commands in this module require higher-level permissions such as Manage Channels, Manage Messages, Manage Roles, Ban Members and Kick Members.

Features

  • Kick Members

    • Ability to kick members with an optional warning.

  • Ban Members

    • Ability to ban members with an optional warning.

    • You can also ban people temporarily using the !tempban command

  • Purge/Clear/Clean Messages

    • Ability to purge the last X amount of messages in a channel.

    • Advanced purge commands allow you to purge messages from bots only, specific users, between specific time frames and more!

  • Mute Members

    • You can assign mutes to members with an optional reason.

    • You can either use a custom mute role or let Cakey Bot generate a default mute role.

    • If you have multiple mute roles Cakey bot will either use the first valid one or the one specific set in Cakey Bot's configuration.

    • You can also mute people temporarily using the !tempmute command

  • Warn Members

    • You can place a warning on users with a specific reason

    • Warnings get logged to your Audit Log if one is setup

    • You can see how many warnings a user has gained, as well as their reasons and who warned them each time.

  • Silent Actions

    • You can mute, kick, ban and warn users silently using "-s" or "-silent" anywhere in the reason section of the command.

Auto Moderation

If you are wanting Cakey Bot to automatically handle moderation you can check out this section for more information.

Warnings

You can warn users with a given reason using the !warn <user> <reason> . It will place a warning on their account which you can then view later with the !warnings <username>. Warnings will record the date the warning was received, the reason as well as the moderator who made the warning. Warnings will also automatically post to your Audit Log if you have one set up for Cakey Bot. If you want to remove a specific warning from a user you can simply do !unwarn <user> <warning ID>.

Muting

When you run the !mute <user> command, Cakey Bot will assign a mute role to that user preventing them from chatting/speaking in voice channels. Now, You might be asking "What role does Cakey Bot use for this?". This depends on a few factors:

  1. If you have set a mute role with !setting muterole or have one set in the web dashboard, Cakey Bot will use that role.

  2. If you have not manually set a mute role, Cakey Bot will scan for any role with the name "Muted", if it finds one it will use that role.

  3. If Cakey Bot does not find a "Muted" role, it will generate a brand new role with appropriate permissions

Note: In order for Cakey Bot to mute a user several things must happen. Cakey Bot must have Manage Roles permission and Cakey Bot's highest role must be higher than the Mute role and the muted user's highest role.

Temporary Mutes

You can also mute people temporarily. It works exactly like normal muting above and requires the same setup/permissions but it will automatically remove the mute after the specified time. You can temporarily mute someone by using the !tempmute <user> <time> <opt:reason>command.

Silent Actions

When you run most moderation commands on a user, they send a DM/Notification to the user via private messages. There are some instances where you may not want this capability. You can cancel sending a DM notification by adding -s or -silent anywhere in the "reason" section of the command.

For example: !warn TestSubject -s Spamming the chat will add a warning to the user but will not send a DM to them.

Advanced Purge Features

Advanced purge features are currently disabled for Cakey Bot while they are being updated/fixed. Check back later for more information.