Discord makes it difficult to truly remove data from the platform. Using this script you can scrub your entire server back to the first messages at creation using 3 different matching patterns:
- Regex based deletion on the message contents for all users
- Message deletion based on user IDs
- Message deletion based on on user IDs AND a regex pattern.
It is highly recommended setting your Discord client to developer mode and having a basic understanding of the Discord snowflake ID format before attempting to use this script.
Per the Discord TOS this script is designed to only accept valid Bot tokens and respects enforced rate limits. Running userbots will get your account disabled and is NOT recommended.
{
"guild":"265256381437706240",
"token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"mode":"regex",
"match_regex":"\\bretard(?:ed)?\\b",
"match_users":["252869311545212928","265255911012958208"],
"ignore_channels":["270579644372090880","356781927836942339","270578632026488851","270695480873189376","419976078321385473","273164941857652737"],
"archival_enabled":"true",
"archival_file":"deleted_this.csv"
}
| Setting | Accepted Value |
|---|---|
| guild | Discord Server Snowflake |
| token | Discord Bot Token |
| mode | "regex", "users", or "regexuser" |
| match_regex | regex to compare messages against if mode is set to regex |
| match_users | list of Discord User Snowflakes if mode is set to users |
| ignore_channels | list of Discord Channel Snowflakes to bypass, can be empty list |
| archival_enabled | true or false, toggles saving of deleted messages |
| archival_file | location to save deleted messages csv if archival_enabled is true |
These are optional. Best used to pick off where the script stopped on a crash or disconnect or debugging.
--resumefrom <Discord Message Snowflake>
--resumechannel <Discord Channel Snowflake>
--dryrun <bool, disables sending delete commands to API>
--lookback <int>, only go back x messages per channel.
python .\delet.py
python .\delet.py --resumechannel 265256381437706240
python .\delet.py --resumechannel 265256381437706240 --resumefrom 469620983704190999 --dryrun
This is written in Python 3, with the only external library needed is Requests. This can be done with python3 -m pip install -r requirements.txt.
Depending on your server message volume size and messages to be deleted this might take several days to run. My testing revealed a rate of about 1000 messages per hour can be deleted from the API.
The bot account you are running this under must have the VIEW_CHANNEL, READ_MESSAGE_HISTORY, and MANAGE_CHANNELS permissions in all channels you wish to scrub