Overview
The embed builder system provides two ways to create custom Discord embeds: a script-based approach using embed syntax, and an interactive button-based builder. Both support advanced features like custom buttons, placeholders, and VoiceMaster integration.Embeds support dynamic placeholders for user info, server stats, timestamps, and more.
Two Methods
Script Method (Prefix)
Use embed script syntax with placeholdersCommands:
~embed create, ~embed copyBest for: Advanced users, automation, templatesInteractive Builder (Slash)
Click buttons to build embeds visuallyCommands:
/embed builder, /embed editBest for: Quick creation, visual editingScript Method Commands
embed create
embed create
Create and send an embed using script syntax.Options:
Permissions: None
--name <name>β Save the embed--welcome <#channel>β Add to welcome system--goodbye <#channel>β Add to goodbye system--booster <#channel>β Add to booster system
ce, createembedPermissions: None
embed preview
embed preview
Preview an embed without sending it publicly.What It Does:
- Shows how the embed will look
- Doesnβt save or send publicly
- Perfect for testing
embed copy
embed copy
Copy embed code from any message.What It Does:
- Extracts embed code from message
- Includes buttons if present
- Returns ready-to-use script
embed list
embed list
View all your saved embeds.What It Shows:
- All embeds youβve saved
- Embed names
- Quick reference list
embed delete
embed delete
Delete a saved embed.What It Does:
- Permanently deletes the embed
- Cannot be undone
- Removes from all systems
Interactive Builder Commands
/embed builder
/embed builder
Start the interactive embed builder.Options:
- number β Create multiple embeds (1-10)
- Opens button interface
- Click buttons to add/edit fields
- Save when finished
- Title, Description, Author
- Footer, Color, Thumbnail
- Image, URL, Timestamp
- Add Field, Add Button
- Send via Webhook
- Add VM Buttons (requires Manage Server)
/embed edit
/embed edit
Edit a saved embed interactively.What It Does:
- Loads saved embed
- Opens button interface
- Make changes and save
/embed send
/embed send
Send a saved embed to a channel.What It Does:
- Sends the saved embed
- Includes buttons if configured
- Parses all placeholders
/embed list
/embed list
View your saved embeds (slash version).Permissions: None
/embed delete
/embed delete
Delete a saved embed (slash version).Permissions: None
Embed Script Syntax
Basic Structure
Available Properties
| Property | Usage | Example |
|---|---|---|
| title | Embed title | $v{title: Welcome!} |
| description | Main text | $v{description: Hello {user}!} |
| color | Hex color | $v{color: ff0000} or $v{color: {random.color}} |
| footer | Bottom text | $v{footer: Server Info} |
| footer_icon | Footer image | $v{footer_icon: {guild.icon}} |
| author | Top name | $v{author: {user.tag}} |
| author_icon | Author image | $v{author_icon: {user.avatar}} |
| author_url | Author link | $v{author_url: {author.url}} |
| thumbnail | Small image | $v{thumbnail: {user.avatar}} |
| image | Large image | $v{image: https://example.com/image.png} |
| url | Title link | $v{url: https://example.com} |
| timestamp | Current time | $v{timestamp} |
| field | Add field | $v{field: Name && Value && true} |
| message | Text above embed | $v{message: Welcome to the server!} |
Adding Buttons
linkβ Opens URL (requiresurl)primaryβ Blue buttonsecondaryβ Gray buttonsuccessβ Green buttondangerβ Red button
Placeholders
User Placeholders
| Placeholder | Output |
|---|---|
{user} | Username |
{user.mention} | @mention |
{user.id} | User ID |
{user.tag} | Username#0000 |
{user.avatar} | Avatar URL |
{user.joined_at} | Join date |
{user.created_at} | Account creation |
{user.top_role} | Highest role name |
{user.nickname} | Server nickname |
{user.boost} | true/false |
Server Placeholders
| Placeholder | Output |
|---|---|
{guild.name} | Server name |
{guild.id} | Server ID |
{guild.icon} | Server icon URL |
{guild.count} | Member count |
{guild.owner} | Owner name |
{guild.owner_mention} | Owner mention |
{guild.boost_count} | Boost count |
{guild.boost_tier} | Boost tier (0-3) |
Channel Placeholders
| Placeholder | Output |
|---|---|
{channel} | Channel mention |
{channel.name} | Channel name |
{channel.id} | Channel ID |
{channel.topic} | Channel topic |
Time Placeholders
| Placeholder | Output |
|---|---|
{time} | Relative time |
{timestamp} | Full timestamp |
{date} | Date only |
{unix} | Unix timestamp |
Special Placeholders
| Placeholder | Output |
|---|---|
{random.color} | Random hex color |
{author.url} | Discord profile URL |
Usage Examples
- Welcome Embed
- Server Info
- Interactive Builder
- Edit Saved
VoiceMaster Buttons
Embeds can include VoiceMaster control buttons (requires Manage Server permission). How to Add:- Use
/embed builderor/embed edit - Click βAdd VM Buttonsβ
- Save the embed
- Lock/Unlock
- Hide/Reveal
- Kick
- Decrease/Increase limit
- Info
- Rename
- Claim
- Send embed in channel
- Members click buttons to control their voice channels
- Requires VoiceMaster system enabled
Permission Requirements
Bot Permissions
The bot needs:
- Send Messages
- Embed Links
- Manage Messages (for button interactions)
User Permissions
Command Requirements:
- None β Create/send/save embeds
- Administrator β Slash commands visible to all
- Manage Server β Add VM buttons
Common Use Cases
Welcome messages with stats
Welcome messages with stats
Server rules with buttons
Server rules with buttons
Announcements with images
Announcements with images
Interactive voice panel
Interactive voice panel
Tips & Tricks
Script Tips
- Use
~embed previewto test before sending - Copy existing embeds with
~embed copyto learn syntax - Save frequently used embeds with
--name - Combine multiple fields for organized info
Builder Tips
- Create multiple embeds at once with
numberoption - Use βSelect Embedβ to switch between multiple embeds
- Buttons expire after 20 minutes
- VM buttons require VoiceMaster setup
Related Features
Welcome Messages
Use embeds in welcome system
VoiceMaster
Set up voice controls for VM buttons