VanityPulse

🧠 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.