Mr. Vanity

Best Vanity Role/Checker Bot for Discord.
Version 1.2.0

Invite

Highlights
  • ✅ Automatic vanity role assignment from the user’s custom status
  • 🧩 Per-guild regex pattern — flexible and case-insensitive
  • 📣 Optional webhook logging for joins/leaves and match changes
  • ⚡ Manual checks: /statuscheck/vanitylist
  • 📡 Public API: ?api=status?api=stats?api=commands
Current Version v1.2.0
Regex-based Presence-aware Role Automation Webhook Logs

How detection works
  1. We read the member’s custom status (not bio, not about-me).
  2. We compare it with your guild’s regex pattern.
  3. If it matches → assign the configured role.
  4. If it stops matching → remove the role.
Bots are ignored. Role changes respect Discord role hierarchy.
Regex examples
# Simple vanity
\.gg/zmtlabs

# Allow discord.gg or .gg
(?:discord\.gg|\.gg)/zmtlabs

# Multiple links (either)
(?:\.gg/(zmtlabs|zmt|labs))

# Loose match (any case)
(?i)\.gg/zmtlabs
                
Tip: escape dots as \.. Use (?i) for case-insensitive if your backend isn’t already.

Logging
  • 🧾 Role given/removed events
  • 👤 First-time detection / Loss of match
  • 🧪 Manual checks via /statuscheck
Enable via /logchannel create or /logchannel set.
Required permissions
  • 🔒 Manage Roles — to assign/remove your vanity role
  • 🌐 Create Webhook — for logging (optional)
  • 📄 View & Send Messages — in the log channel (optional)
Place the bot’s top role above your vanity role.

Quick commands
Command Description
/setpattern <regex>Define your status pattern (per guild)
/setrole <role>Choose which role is granted on match
/vanitylistList members whose status matches right now
/statuscheck [user]Manually check yourself or a member
/logchannel set|create|resetConfigure or disable webhook logs
/showconfigShow current role/pattern/log settings

Enter an invite code to generate patterns.

Public JSON endpoints (click to copy):

https://zmtlabs.nl/bots/mr-vanity?api=status
https://zmtlabs.nl/bots/mr-vanity?api=stats
https://zmtlabs.nl/bots/mr-vanity?api=commands
https://zmtlabs.nl/bots/mr-vanity?api=features
https://zmtlabs.nl/bots/mr-vanity?api=version
https://zmtlabs.nl/bots/mr-vanity?api=uptime
Tip: Endpoints are CORS-enabled for easy integration.