🧠 Vanity Detection System

The Vanity Detection System is a production-grade Discord automation bot designed to help server owners increase engagement through real-time custom status detection and automated reward systems.

Built with scalability in mind, the bot supports multiple servers simultaneously, each with fully independent configurations stored securely in MongoDB Atlas.

⚙️ What the Bot Does

The bot continuously monitors user activity through Discord’s presence system and detects custom status messages that match server-defined trigger keywords.

When a match is found, the system automatically:

Assigns a configured role to the user
Sends a customizable embed notification
Tracks the user to prevent duplicate rewards
Logs activity based on server settings

If a user removes the trigger and later adds it again, the system treats it as a new valid event and reprocesses the reward accordingly.

🧠 Key Features
🔍 Real-Time Status Detection

Detects changes in user custom statuses and matches them against configured trigger keywords in real time.

🎁 Automated Reward System

Automatically assigns roles and sends embeds when users meet trigger conditions, increasing engagement and activity.

⚙️ Fully Configurable Per Server

Each Discord server can independently configure:

Trigger keywords
Reward roles
Logging channels
Custom embed messages
🧩 Advanced Embed Builder

Includes an interactive embed creation system where administrators can design and preview embeds directly inside Discord before saving them to the database.

🛡️ Anti-Spam & Duplicate Protection

Prevents repeated rewards by tracking users who have already been processed, ensuring efficient and clean execution.

💾 Scalable Database Architecture

Uses MongoDB Atlas to store all guild configurations and user tracking data in a single scalable cluster.

🚀 Performance & Design

The bot is built using a modular architecture with Discord.js v14 and Node.js, optimized for performance across large-scale deployments.

Key optimizations include:

In-memory caching of guild configurations
Debounced presence update handling
Minimal database queries during runtime
Efficient event-driven processing
🧩 Use Cases

The Vanity Detection System is ideal for:

Gaming communities
Reward-based Discord servers
NFT / crypto communities
Social engagement servers
Automation-focused Discord setups
🔒 Permissions & Safety

The bot requires Administrator permissions for configuration commands to ensure secure setup and proper role management. It does not collect or store unnecessary user data beyond what is required for functionality (guild configuration and detection tracking).

🌍 Vision

This project is built as a scalable Discord SaaS-style automation tool — not a simple bot. It is designed to feel like a professional backend system that can power engagement and reward mechanics across thousands of servers reliably.

VanityPulse

Automate Discord status detection with instant role rewards, custom embeds, and scalable multi-server configuration.

Voting for VanityPulse

Do you want to support us?