Discord Vanity Tracker with Auto Roles
VanityPulse automates vanity detection in Discord servers. When members add your trigger words to their custom status, the bot detects it instantly and assigns reward roles automatically. Built for community managers who want hands-free engagement tracking with enterprise-level reliability.
Core Functionality
Real-Time Detection Engine Monitors all server members' custom statuses continuously. When a configured trigger word or phrase is detected, validates the match through anti-duplicate protection, checks role hierarchy permissions, and assigns the reward role within milliseconds. Complete audit logging tracks every detection with timestamps.
Anti-Spam Protection Intelligent cooldown system prevents users from farming rewards by rapidly toggling their status. Each user has configurable cooldown periods between valid detections. Historical detection tracking maintains streak counts even if users temporarily remove vanity.
Retroactive Bulk Scanning Scan entire server memberships and assign roles to current vanity carriers. Includes dry-run mode to preview results before applying changes. Perfect for initial setup or periodic catch-up scans.
Complete Command Suite (13 Slash Commands)
Configuration
Advanced Features
Custom Embed Builder Create personalized detection announcements with dynamic placeholders: {user.mention}, {username}, {server.name}, {trigger}, {timestamp}, {streak}. Full Markdown formatting support.
Smart Reminder System Automatically DM users who previously had vanity but removed it. Polite re-engagement with opt-out support via /vanityreminders optout. Configurable intervals and messaging.
Live Statistics Deploy updating widgets showing total detections, unique users, current carriers, and average streaks. Leaderboards gamify engagement with ranked streak displays.
Data Export Export complete detection history to CSV including user IDs, usernames, timestamps, triggers matched, and streak counts. Integrates with spreadsheets and external analytics tools.
Technical Specifications
What You Receive
VanityPulse automates vanity detection in Discord servers. When members add your trigger words to their custom status, the bot detects it instantly and assigns reward roles automatically. Built for community managers who want hands-free engagement tracking with enterprise-level reliability.
Core Functionality
Real-Time Detection Engine Monitors all server members' custom statuses continuously. When a configured trigger word or phrase is detected, validates the match through anti-duplicate protection, checks role hierarchy permissions, and assigns the reward role within milliseconds. Complete audit logging tracks every detection with timestamps.
Anti-Spam Protection Intelligent cooldown system prevents users from farming rewards by rapidly toggling their status. Each user has configurable cooldown periods between valid detections. Historical detection tracking maintains streak counts even if users temporarily remove vanity.
Retroactive Bulk Scanning Scan entire server memberships and assign roles to current vanity carriers. Includes dry-run mode to preview results before applying changes. Perfect for initial setup or periodic catch-up scans.
Complete Command Suite (13 Slash Commands)
Configuration
- /vanitysetup — Interactive multi-page setup guide
- /vanityconfig — View complete guild configuration summary
- /vanitytrigger set — Configure trigger words or phrases
- /vanitytrigger remove — Remove specific triggers
- /vanityrole set — Assign reward role for detections
- /vanityrole remove — Clear reward role assignment
- /vanitychannel set — Designate log channel for notifications
- /vanityscan — Bulk scan with dry-run option
- /vanityembed set — Custom detection messages with placeholders
- /vanityplaceholders — List dynamic placeholders available
- /vanityreminders — Automated DM reminders for lapsed vanity
- /vanitywidget — Live updating statistics display
- /vanityleaderboard — Ranked streak leaderboards
- /vanityexport — CSV export of detection history
- /vanityaudit — Paginated detection history review
Advanced Features
Custom Embed Builder Create personalized detection announcements with dynamic placeholders: {user.mention}, {username}, {server.name}, {trigger}, {timestamp}, {streak}. Full Markdown formatting support.
Smart Reminder System Automatically DM users who previously had vanity but removed it. Polite re-engagement with opt-out support via /vanityreminders optout. Configurable intervals and messaging.
Live Statistics Deploy updating widgets showing total detections, unique users, current carriers, and average streaks. Leaderboards gamify engagement with ranked streak displays.
Data Export Export complete detection history to CSV including user IDs, usernames, timestamps, triggers matched, and streak counts. Integrates with spreadsheets and external analytics tools.
Technical Specifications
- Runtime: Node.js 20+ LTS
- Library: discord.js v14 with Gateway Intents
- Database: MongoDB Atlas with Mongoose ODM
- Deployment: Docker support with included compose files
- Logging: Structured JSON logging with Pino
- Architecture: Event-driven with in-memory caching
What You Receive
- Complete source code (comment-free, ready for customization)
- 13 slash commands with full permission handling
- 5 event handlers for presence detection and interactions
- 8 utility modules for embeds, detection, permissions, and logging
- MongoDB schemas with atomic updates and indexing
- Docker configuration for containerized deployment
- Beginner tutorial with 9-step visual setup guide
- Setup flow diagrams with ASCII walkthroughs
- MIT License for unrestricted commercial use
