Skip to main content

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, templates

Interactive Builder (Slash)

Click buttons to build embeds visuallyCommands: /embed builder, /embed editBest for: Quick creation, visual editing

Script Method Commands

Create and send an embed using script syntax.
~embed create {embed}$v{title: Title}$v{description: Text}{embed}
Options:
  • --name <name> β€” Save the embed
  • --welcome <#channel> β€” Add to welcome system
  • --goodbye <#channel> β€” Add to goodbye system
  • --booster <#channel> β€” Add to booster system
Aliases: ce, createembed
Permissions: None
Preview an embed without sending it publicly.
~embed preview {embed}$v{...}{embed}
What It Does:
  • Shows how the embed will look
  • Doesn’t save or send publicly
  • Perfect for testing
Permissions: None
Copy embed code from any message.
~embed copy <message_link>
What It Does:
  • Extracts embed code from message
  • Includes buttons if present
  • Returns ready-to-use script
How to Get Message Link: Right-click message β†’ Copy Message LinkPermissions: None
View all your saved embeds.
~embed list
What It Shows:
  • All embeds you’ve saved
  • Embed names
  • Quick reference list
Permissions: None
Delete a saved embed.
~embed delete <name>
What It Does:
  • Permanently deletes the embed
  • Cannot be undone
  • Removes from all systems
Permissions: None

Interactive Builder Commands

Start the interactive embed builder.
/embed builder [number]
Options:
  • number β€” Create multiple embeds (1-10)
What It Does:
  • Opens button interface
  • Click buttons to add/edit fields
  • Save when finished
Buttons Available:
  • Title, Description, Author
  • Footer, Color, Thumbnail
  • Image, URL, Timestamp
  • Add Field, Add Button
  • Send via Webhook
  • Add VM Buttons (requires Manage Server)
Permissions: None (Admin for visibility)
Edit a saved embed interactively.
/embed edit name:<embed_name>
What It Does:
  • Loads saved embed
  • Opens button interface
  • Make changes and save
Permissions: None
Send a saved embed to a channel.
/embed send name:<embed_name> channel:<#channel>
What It Does:
  • Sends the saved embed
  • Includes buttons if configured
  • Parses all placeholders
Permissions: None (Admin for visibility)
View your saved embeds (slash version).
/embed list
Permissions: None
Delete a saved embed (slash version).
/embed delete name:<embed_name>
Permissions: None

Embed Script Syntax

Basic Structure

{embed}
$v{title: Your Title}
$v{description: Your description text}
$v{color: ff0000}
{embed}

Available Properties

PropertyUsageExample
titleEmbed title$v{title: Welcome!}
descriptionMain text$v{description: Hello {user}!}
colorHex color$v{color: ff0000} or $v{color: {random.color}}
footerBottom text$v{footer: Server Info}
footer_iconFooter image$v{footer_icon: {guild.icon}}
authorTop name$v{author: {user.tag}}
author_iconAuthor image$v{author_icon: {user.avatar}}
author_urlAuthor link$v{author_url: {author.url}}
thumbnailSmall image$v{thumbnail: {user.avatar}}
imageLarge image$v{image: https://example.com/image.png}
urlTitle link$v{url: https://example.com}
timestampCurrent time$v{timestamp}
fieldAdd field$v{field: Name && Value && true}
messageText above embed$v{message: Welcome to the server!}

Adding Buttons

{button: label:Click Me && url:https://example.com && style:link}
{button: label:Primary && style:primary && custom_id:btn_1}
{button: label:Success && style:success && emoji:βœ…}
Button Styles:
  • link β€” Opens URL (requires url)
  • primary β€” Blue button
  • secondary β€” Gray button
  • success β€” Green button
  • danger β€” Red button

Placeholders

User Placeholders

PlaceholderOutput
{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

PlaceholderOutput
{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

PlaceholderOutput
{channel}Channel mention
{channel.name}Channel name
{channel.id}Channel ID
{channel.topic}Channel topic

Time Placeholders

PlaceholderOutput
{time}Relative time
{timestamp}Full timestamp
{date}Date only
{unix}Unix timestamp

Special Placeholders

PlaceholderOutput
{random.color}Random hex color
{author.url}Discord profile URL

Usage Examples

~embed create {embed}
$v{title: Welcome to {guild.name}!}
$v{description: Hey {user.mention}, you're the {guild.member_count_ordinal} member!}
$v{color: {random.color}}
$v{thumbnail: {user.avatar}}
$v{footer: Joined {time}}
$v{footer_icon: {guild.icon}}
$v{timestamp}
{embed} --name welcome --welcome #welcome

VoiceMaster Buttons

Embeds can include VoiceMaster control buttons (requires Manage Server permission). How to Add:
  1. Use /embed builder or /embed edit
  2. Click β€œAdd VM Buttons”
  3. Save the embed
Buttons Included:
  • Lock/Unlock
  • Hide/Reveal
  • Kick
  • Decrease/Increase limit
  • Info
  • Rename
  • Claim
Usage:
  • 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

~embed create {embed}
$v{title: Welcome {user}!}
$v{description: You're member #{guild.count}}
$v{color: {random.color}}
{embed} --welcome #welcome
Dynamic welcome with member count.
~embed create {embed}
$v{title: Server Rules}
$v{description: Please read our rules}
{button: label:Full Rules && url:https://example.com/rules && style:link}
{button: label:Accept && style:success && custom_id:accept_rules}
{embed} --name rules
Rules with clickable buttons.
~embed create {embed}
$v{title: New Update!}
$v{description: Check out our latest features}
$v{image: https://example.com/update.png}
$v{color: ff6b6b}
$v{timestamp}
{embed}
Announcement with banner image.
/embed builder
# Click: Title β†’ "Voice Controls"
# Click: Description β†’ "Control your voice channel"
# Click: Add VM Buttons
# Click: Save β†’ "voice-panel"
/embed send name:voice-panel channel:#voice-text
VoiceMaster control panel.

Tips & Tricks

Script Tips
  • Use ~embed preview to test before sending
  • Copy existing embeds with ~embed copy to learn syntax
  • Save frequently used embeds with --name
  • Combine multiple fields for organized info
Builder Tips
  • Create multiple embeds at once with number option
  • Use β€œSelect Embed” to switch between multiple embeds
  • Buttons expire after 20 minutes
  • VM buttons require VoiceMaster setup

Welcome Messages

Use embeds in welcome system

VoiceMaster

Set up voice controls for VM buttons