🔨 VoidSentry v2.1

A high-performance Discord security bot designed to catch and remove self-bots and malicious users who ignore server warnings. The bot monitors specific "Trap" channels and instantly bans anyone who sends a message there.

🚀 Features

• Multi-Server Support — One bot instance serves any number of servers. Each server has its own trap channels, log channel, ban reason and purge duration, managed with slash commands (no restart needed).
• Instant Detection — Real-time monitoring of multiple restricted channels.
• Auto-Ban — Immediately bans violators with zero tolerance.
• Message Purge — Deletes the banned user's recent messages across the server (24h by default, configurable per server).
• DM Notification — Sends a notification to the user before banning (best-effort, 3 s timeout, fails silently if DMs are disabled).
• Safety Net — Administrators and configurable exempt roles are never banned (their trap message is only deleted). A per-server dry-run mode reports violations without banning, and failed bans (missing permission, role hierarchy) are reported to the log channel.
• Privacy — Captured message content is cleared from the ban history after MESSAGE_RETENTION_DAYS (default 90).
• MySQL Database — Persistent ban history storage with search and statistics.
• Detailed Ban Logs — Rich embed logs with:
  • User avatar, tag, ID, and mention
  • Account creation date
  • Server join date
  • Display name and roles
  • Captured message content
  • Suspicious account age warning (< 7 days old)
• Slash Commands:
  • /help — List all commands (built from the loaded commands, always up to date)
  • /setup-trap — Register the current channel as a trap for this server and post the warning
  • /trap-settings — View or change this server's trap channels, log channel, ban reason, purge duration, dry-run mode and exempt roles
  • /add-logchannel [channel] — Choose where ban logs are posted on this server (any channel, any name)
  • /remove-logchannel — Stop posting ban logs
  • /unban — Unban a user by ID (ban history is kept)
  • /purge-user — Bot owner only: delete all stored ban records of a user (data deletion requests)
  • /status — View bot uptime, statistics, and recent bans
  • /ban-info — Look up ban information for a user by ID (Discord ban lookup)
  • /bans — Ban history from database:
    • /bans recent [limit] — Show recent bans
    • /bans search <user_id> — Search bans by user ID
    • /bans stats — Show database statistics
    • Results are limited to the current server (the bot owner can add global:true)
• Unban from the log — Every ban log has an Unban button for administrators.
• Change log — Every settings change and unban (from a command, the log button or the dashboard) is recorded with who made it, in the audit_log table.
• Owner alerts — When the bot cannot ban on a server (missing permission, role too low), the server owner gets at most one direct message a day about it.
• Optional web dashboard — The hosted bot at voidsentry.vercel.app has a dashboard for settings, ban history, statistics, unbans and CSV export. Its website is not open source; the API it uses is in this repository and switched off unless you configure it. Self-hosted bots are fully usable with slash commands alone (see Running without the dashboard).
• Live Status — The bot's "Watching" status rotates between your STATUS_TEXT, the number of servers and the total number of users banned.
• Structured Logging — Pino-based logger with categories (system, security, ban, detection, command)
• Statistics Tracking — In-memory tracking of bans, detections, and DM success rate
• Branded Design — Custom logo and professional embeds

This is the beginning of the README. Read the rest at the original. Read the full README ↗