Required Permission: Admin Access or higher — Server Owner, Extra Owner, Trusted User, or Administrator with a role above the bot can use these commands.
Vanity Client Bot
Due to Discord API limitations, the main bot cannot reliably track custom status changes across all members in real time. To solve this, Vanity Roles uses a separate lightweight bot (the Vanity Client) that runs alongside ZEON specifically to monitor member statuses. You must invite the Vanity Client to your server for this module to function. It requires no extra permissions beyond reading member presences. → Invite Vanity Client BotThe Vanity Client is a companion bot that works silently in the background. It does not respond to any commands — all configuration is done through the main bot using the
.vanityrole commands.Setting Up
Follow these steps to configure vanity roles for your server.Invite the Vanity Client
Use the invite link above to add the Vanity Client bot to your server. Without it, status tracking will not work.
Commands
Configuration
| Command | Description |
|---|---|
.vanityrole channel <channel> | Updates the log channel for reward messages |
.vanityrole message <text> | Sets the reward message |
.vanityrole show | Shows the current configuration |
.vanityrole reset | Deletes the entire configuration |
Role Management
| Command | Description |
|---|---|
.vanityrole role add <role> | Adds an award role (max 3) |
.vanityrole role remove <role> | Removes an award role |
Controls
| Command | Description |
|---|---|
.vanityrole enable | Enables the vanity role system |
.vanityrole disable | Disables the vanity role system |
.vanityrole test | Sends a test reward message to the configured channel |
.vanityrole sync | Manually syncs vanity roles for all members (60s cooldown) |
Customizing Messages
The reward message is fully customizable and supports both dynamic variables and custom embeds. When a member puts your vanity in their status, the bot sends the configured message to the log channel with all variables parsed into real data.Using Variables
You can dynamically insert information like the user’s name, server name, or role count. Refer to the Variables reference for the full list. Available contexts: Server, Channel, User, Author, TargetUsing Custom Embeds
Design a rich embed using the interactive embed builder, then attach it to your message with the{embed:name} syntax.
Create the Embed
The
{embed:name} placeholder is invisible in the final output. The bot strips it from the text and attaches the rich embed below the message. Variables placed inside the embed builder (like {user} in the title) will also parse correctly.