Skip to main content

Status Blacklist

Status Blacklist scans custom statuses and presence activity text for forbidden phrases, scam links, competitor invites, or fake staff tags when Discord presence data is available.

Plan Required

Premium.

Required Bot Permissions

  • Guild Presences intent for live detection
  • Send Messages and Embed Links for logs
  • Manage Roles for reward-role removal
  • Moderate Members for timeout action

Setup

/modules enable status_blacklist
/statusblacklist setup
/statusblacklist add
/statusblacklist scan
/statusblacklist logs

Example Setup

/statusblacklist setup action:notify_staff log_channel:#mod-logs
/statusblacklist add term:discord.gg/scamserver match_type:contains severity:high

Testing

Run a dry-run scan first:

/statusblacklist scan dry_run:true

The scan only checks presence data Discord has made available to the bot. A member can appear unavailable even when configuration is correct.

Common Issues

  • Statuses are not detected: enable the Guild Presences intent.
  • Timeout fails: grant Moderate Members.
  • Reward role not removed: check Manage Roles and role hierarchy.
  • Repeated notifications: cooldown prevents repeated enforcement for the same match.
/diagnostics module module:status_blacklist
/license plan