Hashbot can automatically detect users that Discord has flagged as spammers and take action before they can cause harm. This works in two ways: auto-kick on join and bulk member scanning.Documentation Index
Fetch the complete documentation index at: https://hashbot.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Auto-Kick Spammers
When enabled, Hashbot automatically punishes any new member whose account has been flagged as a spammer by Discord. This runs silently in the background with zero configuration beyond a single toggle.Enable auto-kick
Run
/settings autokick-spammer set-state state:enable to start auto-punishing flagged spammers on join.(Optional) Set punishment level
Run
/settings autokick-spammer punishment level:kick to choose the action. Options: flag (assign a role), kick, or ban.How it works
- A new member joins your server
- Hashbot checks their Discord account flags
- If the account is flagged as a spammer by Discord, Hashbot takes the configured action
- The action is logged to your configured log channel with full details
Auto-kick is enabled by default for all servers. You only need to run the command if you previously disabled it or want to confirm the setting.
Punishment levels
| Level | What happens |
|---|---|
| Flag | Assigns a “Flagged Spammer” role to the member for manual review |
| Kick | Removes the member from the server (default) |
| Ban | Permanently bans the member |
Silent mode
By default, Hashbot pings your moderator role when a spammer is caught. If your server handles a high volume of flagged accounts, enable silent mode to suppress the ping while still logging every action.Scan Spammers
The/scan-spammers command lets you scan your entire existing member list for accounts that Discord has flagged as spammers. This is useful for cleaning up servers that may have accumulated flagged accounts before Hashbot was installed or before auto-kick was enabled.
Scan process
- Hashbot iterates through all server members and checks their Discord flags
- Progress updates appear every few seconds so you can track the scan
- When complete, Hashbot shows a summary of all flagged members found
- You confirm or cancel the bulk kick via buttons on the result message
Large server support
For servers with 400,000+ members, the scan automatically splits into phases to avoid timeouts:- Each phase scans for up to 12 minutes before saving progress
- Run
/scan-spammersagain to resume from where the previous phase left off - Partial scan state is preserved for 24 hours
Confirmation flow
After the scan completes, Hashbot shows:- Total number of flagged spammers found
- A preview list of flagged accounts (up to 15)
- Confirm and Cancel buttons
Commands
| Command | Description |
|---|---|
/settings autokick-spammer set-state state:<enable|disable> | Enable or disable automatic punishment of Discord-flagged spammers on join |
/settings autokick-spammer punishment level:<flag|kick|ban> | Set the punishment level for detected spammers |
/settings autokick-spammer silent state:<enable|disable> | Suppress moderator role ping (actions are still logged) |
/scan-spammers | Scan all current members for Discord-flagged spammers |
FAQ
What does 'flagged as a spammer by Discord' mean?
What does 'flagged as a spammer by Discord' mean?
Discord maintains an internal system that flags accounts exhibiting spam behavior across the platform. This is a platform-level flag set by Discord itself, not by Hashbot. When an account carries this flag, it means Discord has identified the account as likely being used for spam.
Can legitimate users be flagged?
Can legitimate users be flagged?
Discord’s spammer flag has a very low false positive rate since it reflects platform-wide enforcement. However, if a legitimate user is incorrectly flagged, they would need to appeal directly to Discord. You can allowlist specific users if needed.
Does this replace name filters or PFP protection?
Does this replace name filters or PFP protection?
No. Spam detection works alongside your existing filters. Name filters catch impersonation based on usernames, PFP protection catches avatar copying, and spam detection catches accounts flagged at the platform level. Use all three for comprehensive protection.
Will the scan kick allowlisted users?
Will the scan kick allowlisted users?
Allowlisted users, manager roles, and their members are all respected. Members on your allowlist or with a manager role will not be punished even if they carry a spammer flag.