Purge Commands

Clean up recent channel messages fast. The main command is /purge, capped at 99 messages so staff can remove spam without wiping a whole channel by accident. Focused purge commands scan the same recent window, then remove only the messages that match.

How it works

Every purge command requires Manage Messages for the staff member and for Beacon. The result is sent privately, so cleanup does not create more noise in the channel. Messages older than 14 days are skipped because Discord blocks bulk deletion for them.

Use /purge when you just need the latest messages gone. Use the focused commands when a raid, invite spam, link dump, bot loop, or copied phrase needs to be cleaned without touching normal chat around it.

1

Choose

Use /purge for normal cleanup, or pick a focused command like /purge-user or /purge-links.

2

Limit

Set count from 1 to 99. Beacon never accepts more than 99 messages in one run.

3

Clean

Beacon deletes matching recent messages and privately confirms how many were removed.

/purge

Delete up to 99 recent messages. This is the normal cleanup command.

Main
/purge-after

Delete messages sent after a specific message ID or message link.

After
/purge-user

Delete recent messages from one selected user.

User
/purge-bots

Delete recent messages sent by bots.

Bots
/purge-humans

Delete recent messages sent by non-bot members.

Humans
/purge-links

Delete recent messages that contain links.

Links
/purge-invites

Delete recent messages that contain Discord invite links.

Invites
/purge-images

Delete recent messages with files, images, image embeds, or thumbnails.

Files
/purge-embeds

Delete recent messages that contain embeds.

Embeds
/purge-mentions

Delete recent messages that mention users, roles, or everyone.

Mentions
/purge-match

Delete recent messages that contain a specific text match.

Text
/purge-startswith

Delete messages that start with a selected word, prefix, or phrase.

Start
/purge-endswith

Delete messages that end with selected text.

End
/purge-not

Delete recent messages that do not contain the selected text.

Not

Command options

Click a field to see what it does.

count

How many recent messages Beacon should delete or scan. Minimum 1, maximum 99.

message

Message ID or Discord message link. Beacon deletes messages sent after this target in the same channel.

user

The member whose recent messages should be removed.

text

Text that must appear inside the message. Matching is case-insensitive.

startswith text

Text the message must start with. Useful for repeated spam prefixes, copied raid messages, or broken bot output.

endswith text

Text the message must end with. Useful when spam shares the same final phrase or tag.

not text

Deletes messages missing the selected text. Use carefully, because this is intentionally broad.

mentions

Removes messages that ping users, roles, or everyone. Good for cleaning mention spam quickly.

reason

Optional note for staff. The purge result is sent privately to the moderator.

14-day limit

Discord blocks bulk deletion for messages older than 14 days. Beacon skips those safely.

Examples

/purge count: 25

Removes the 25 newest messages from the current channel.

Fast
/purge-user user: member count: 50

Scans 50 recent messages and removes only that member's messages.

Staff
/purge-links count: 99

Scans the maximum recent window and removes messages with links.

Spam
/purge-startswith text: free nitro count: 99

Targets copied spam that starts with the same phrase.

Raid