Mr. Vanity
Guilds
—
Users
—
Latency
—
Uptime
—
Vanity Stats
Updates(Scans)
—
Granted
—
Removed
—
Net Change
—
Custom Patterns
—
Vanity Guilds
—
GuildTag Stats [BETA]
Updates(Scans)
—
Granted
—
Removed
—
Net Change
—
GuildTag Guilds
—
Highlights
- ✅ Automatic vanity role assignment from the user’s custom status
- 🏷️ Automatic GuildTag role syncing based on external tag/clan info
- 🧩 Per-guild regex pattern — flexible and case-insensitive (Vanity)
- 📣 Optional webhook logging for role changes (Vanity & GuildTag)
- ⚡ Manual checks:
/statuscheck•/vanitylist•/guildtag_check - 📡 Public API:
?api=status•?api=stats•?api=commands…
Current Version
v2.0.0
Regex-based (Vanity)
Tag-based (GuildTag)
Role Automation
Webhook Logs
Global Stats API
How Vanity detection works
- Read member’s custom status.
- Compare with your guild’s regex pattern.
- If it matches → assign configured Vanity role.
- If it stops matching → remove the role.
Regex examples (Vanity)
# 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) if your backend isn’t already case-insensitive.
GuildTag flow
- Read the user’s current tag/clan from the external source.
- Compare with your configured GuildTag tag (e.g.
ZMT). - If it matches → assign configured GuildTag role.
- If it stops matching → remove the role.
Required permissions
- 🔒 Manage Roles (Vanity & GuildTag)
- 🌐 Create Webhook (for logs)
- 📄 View & Send Messages (log channels)
Quick commands
| Command | Description |
|---|---|
/setpattern <regex> | Define your status pattern (per guild, Vanity) |
/setrole <role> | Choose which role is granted on match (Vanity) |
/vanitylist | List members whose status matches right now |
/statuscheck [user] | Manually check yourself or a member (Vanity) |
/logchannel set|create|reset | Configure or disable Vanity webhook logs |
/showconfig | Show current Vanity role/pattern/log settings |
/guildtag_setup | Configure tag, role and log channel for GuildTag |
/guildtag_check [user] | Manually sync/check GuildTag role for a user |
/guildtag_reset | Reset GuildTag configuration for a server |
Notes
• Custom status updates can take a moment to propagate.
• Tag updates für GuildTag hängen von der externen Quelle ab.
• Use
• Ensure the bot’s top role is above your Vanity & GuildTag roles in the hierarchy.
• Custom status updates can take a moment to propagate.
• Tag updates für GuildTag hängen von der externen Quelle ab.
• Use
/vanitylist und /guildtag_check to verify your setup quickly.• Ensure the bot’s top role is above your Vanity & GuildTag roles in the hierarchy.
Enter an invite code to generate patterns.
Public JSON endpoints (click to copy).
Stats endpoint contains both Vanity and GuildTag metrics.
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