CommandCleanup is a bot that can delete a variety of different messages, wether it be messages that begin with the most common command symbols, messages by a certain user or messages sent by bots, there is a command/parameter that'll help clean up your chats regardless of what's posted.
Pairing this command with parameters gives you MAXIMUM chat moderation control
requires permissions: `MANAGE MESSAGES`
Get an invite link to add the bot to more servers
Sends helpful documentation about commands, their usages, their aliases and even a short description
Parameters allow for 100% control over the content deleted, giving you complete chat moderation control.
Below is a list of all available parameters and what they do.. You can use multiple parameters in a single command, so mix and match to your liking.
Parameter Legend: (required) - <optional>
(message id | message link | timeframe)
Targets messages posted before the specified message id, message link or timeframe.
(message id | message link | timeframe)
Targets messages posted after the specified message id, message link or timeframe.
<extensions>
aliases: files
Deletes messages with file attachments (not images) Valid extensions are a fullstop followed by the extension, example:
.mov
<extensions>
aliases: imgs
Deletes messages with image attachments (not files) Valid image extensions are
webp
,png
,jpg
,jpeg
&gif
<quotes>
aliases: txt
, contains
Deletes messages with plain text, commands and emojis (no embeds, no images, no files, etc..) If quotes are provided, then only messages containing the quotes will be targeted*Valid quotes are any word/sentence enclosed in quotation marks, example
"hello world"
<prefixes>
aliases: cmds
, startsWith
Deletes messages that begin with the most common command symbols (-, !!, /bb, etc..) If prefixes are provided, then only messages beginning with those prefixes will be targetedValid prefixes are any word/symbols enclosed in quotation marks, example
"!play"
<urls>
Deletes messages that contain links If urls are provided, then only messages containing those links will be targeted
Deletes messages that contain embeds
Targets messages sent by other bots
Targets messages from users that no longer exist in the server (kicked, banned, left, etc..)
Deletes discord system messages (welcome messages, pin added messages, etc..)
Deletes discord invites
(number)
aliases: amount
Sets the maximum number of messages to be deleted This parameter cannot be used by itself and must be paired with at least one other parameter from this list
Targets messages of any kind, excluding pinned
Deletes messages that are pinned
@mentions
Targets messages of the mentioned user or role If a user has left the server but you still want to clean their messages without cleaning all other members who have left, copy their user id and type
<@!id>
(replacing id with the users id) as the response instead of a mention.
Timeframes are arguments only available to the
before
andafter
parameters. Timeframes are constructed by numbers followed by a letter/work representing the duration, example1d
equals 1 day.Timeframes can also be stacked on top of each other for more complicated timeframes, example1d 20h 10m 30s
equals 1 day, 20 hours, 10 minutes and 30 seconds.
Unfortunately this bot (like many others) cannot delete messages older than 14 days in mass amounts, this is due to the discord api limiting the
bulk-delete
endpoint to only delete messages that do not exceed 14 days old.
purge
command but it's not working..This is a common misconception,
purge
is a parameter and should be added after the commandcleanup
. Example.cleanup purge
We touched up on why this occurs earlier in the FAQs section, talking about discord bulk-delete limitations
There could be many number of reasons, the most common though is incorrect permissions inside the channel. Best way to check is make sure the bots (and any of it's roles) aren't denied access to manage messages inside the guild or the channel. If errors persist then feel free to stop by the support server linked below
Here is a great support article talking about how to copy ids from users, roles, messages, guilds, etc..
If you have any issues that aren't mentioned here, stop by our support server and see if we can help there