Embed & Message sendEmbedMessage

$sendEmbedMessage[]

Sends a constructed embed (via $title, $description, $addField, etc.) to a specific channel. Optionally edits an existing message if a messageId is provided.

Syntax
$sendEmbedMessage[(channelId);(messageId)]

$sendEmbedMessage[] — Send an Embed

$sendEmbedMessage[] sends the previously constructed embed to a Discord channel. This is the primary method for sending rich messages (embeds) to a target channel, distinct from $sendMessage[].

Syntax

$sendEmbedMessage[(channelId);(messageId)]

Parameters

Parameter Required Default Description
channelId No Current channel ID of the destination channel.
messageId No New message ID of a message to edit.

Return Value

  • Type: string
  • Returns the identifier of the message created or edited. Can be used for subsequent operations.

Usage

Simple embed in the current channel

$title[Server Status]
$description[All systems functioning normally]
$color[#2ECC71]
$addField[Uptime;$uptime;yes]
$addField[Players;$var[players];yes]
$sendEmbedMessage

Embed in a specific channel

$title[New Member]
$description[$username has joined the server!]
$addField[ID;$authorID;yes]
$thumbnail[$authorAvatar]
$color[#5865F2]
$sendEmbedMessage[$channelID[welcome]]

Editing an existing embed

$title[Leaderboard - Updated]
$description[Updated leaderboard]
$addField[1st;$var[top1];yes]
$addField[2nd;$var[top2];yes]
$addField[3rd;$var[top3];yes]
$color[#F1C40F]
$footer[Updated at $time]
$sendEmbedMessage[$channelID[leaderboard];$var[leaderboard_msg_id]]

Capturing the ID for later use

$title[Editable Message]
$description[This message will be updated]
$var[msgId;$sendEmbedMessage]
$editEmbedIn[10s]
$title[Editable Message - Updated]
$description[The update was successful]
$color[#27AE60]

Notes

  • The embed must be constructed before calling $sendEmbedMessage[] (using $title[], $description[], $addField[], etc.).
  • If no embed is defined, the message will be empty (which should be avoided).
  • The return value (message ID) is useful for subsequent edits or deletions.
  • To send both text and an embed, use $sendMessage[] which can combine both.