Warnings
Warn members, view and remove their warnings, and set automatic punishments for warnings.
Overview
Warnings record the date the warning was received, the reason, and the moderator who made the warning. Warnings also automatically post to your Audit Log if you have one set up for Cakey Bot. This makes them useful for recording a user's previous moderation history and lets you impose stronger moderation punishments on repeat offenders.
Usage
Warn Users
You can warn users with a given reason using the /warn <user> <reason> command. It places a warning on their account which you can then view later. By default warnings also send the user a DM. There is also an optional "isSilent" parameter which suppresses the DM sent to the user for the warning.
The /warn reason has a 300-character limit (checked after mention substitution). Note this is lower than the 500-character limit allowed for /kick, /ban, /mute, and /timeout reasons.
Warnings will also be sent to Cakey Bot's audit log as a special event if you have one configured for moderation logs.
Anonymous Warnings
The /warn command also includes an optional "isAnonymous" parameter. If this is set to true, the user will not see the moderator's name who warned them.
This will be applied on:
- The DM the user receives (if warning is not silent)
- The audit log entry (Some servers display this publicly)
- The
/warningscommand when run by a non-moderator
This will NOT be applied on:
- The
/warningscommand when run by a moderator - When the "View Warnings" button is pressed on the
/warnconfirmation message - The website dashboard audit logs
- When a warning is triggered/created via automod or button press
Note: Other moderators will still be able to see the moderator who gave the warning.
View Warnings
There are a few ways to view warnings for users. The most popular method is slash commands, but you can also access them from the web dashboard. This list will include the warning ID, the moderator who gave the warning as well as the time and reason for the warning.
TIP: You can also view warnings using the button that pops up after you warned someone. {.is-success}
With Commands
You can view a user's warnings with the /warnings <user> command. This shows every warning the user has been given in that server and the status of it (if it is active or expired). If there are too many results, the embed will be paginated with buttons under the embed.
With Dashboard
You can also view warnings on our web dashboard. Once you log in and select a server, you can select the "Warnings" page on the left sidebar.
Remove Warnings
Cakey Bot provides a few ways to remove and clear warnings from users.
Single Warning
You can clear a specific warning from a user with the /unwarn <id> command. You can get the warning ID from the /warnings <user> command or from the web dashboard.
Clear All Warnings
You can clear every warning from a user with the /clearwarnings <user> command.
This command can NOT be undone! Once you've cleared every warning you will have to manually re-add any warnings you want the user to have.
Warning Auto Punishments
Note: Warning auto punishments will only apply to ACTIVE warnings. Expired and soft-deleted warnings are excluded from the count. {.is-info}
Overview
Warning Auto Punishments track user warnings and automatically trigger pre-defined punishments, such as mutes, kicks, or bans, when a user reaches the configured number of warnings. This reduces the burden on moderators and keeps disciplinary actions consistent.
Configuration
You can configure the Warning Auto Punishments feature from the web dashboard, on the "Warnings" page. Here's how to add your first auto-punishment:
- Click "Add Punishment".
- Select the punishment and the required warnings to get that punishment.
- Click "Update"
You have now added your first auto-punishment. You can repeat this process for additional punishments (up to 10 punishments).
Each time a member gets a warning, Cakey Bot counts their active warnings and runs at most one punishment: the one with the highest required number of warnings that the new warning just reached.
Auto Moderation Punishment
If you have any Auto Mod events enabled you can set the punishment to automatically warn users when they violate the rules as well. Any warnings given by Auto Mod will be listed next to regular warnings and will be able to be removed using the same methods.
Warning Expiry
On the "Warnings" page of the web dashboard, you can configure a Warning Expiry setting which determines how many days a warning stays active before it automatically expires. This is configurable between -1 (never expire) and 730 days.