Embed Management ✏️

The Dungeon Hub Bot contains an advanced feature to read message data from embeds, send new embeds and also edit them afterward. This feature fully supports adding multiple embeds onto one message, which is supported by discord. This feature is mainly enabled through the command /embed.

Embed Format

Most sub-commands of /embed expect the embed-data to be passed as a json-string. This can either contain one object, or a json array of multiple objects. You can get an example of the format that is used by running the command /embed get ✏️ and supplying the message link of a message with an embed.
The format that is expected in those arguments looks like this:

{ "title": "title", "description": "description", "url": "url for title", "timestamp": "timestamp in epoch milliseconds", "color": "color in hex format, with leading #", "image": "example image url", "footer": { "text": "footer text", "icon": "icon url" }, "thumbnail": { "url": "thumbnail url" }, "author": { "name": "author name", "url": "author url", "icon": "author icon url" }, "fields": [ { "name": "field name", "value": "field value", "inline": "boolean, if the field should be inline" } ] }

{ "title": "Example Embed", "description": "Example embed, just to try it out", "url": "https://example.com/", "timestamp": 1732920448245, "color": "#A51770", "image": "https://static.dungeon-hub.net/blaze.png", "footer": { "text": "footer text", "icon": "https://static.dungeon-hub.net/favicon.gif" }, "thumbnail": { "url": "https://static.dungeon-hub.net/enderman.png" }, "author": { "name": "author name", "url": "https://example.com/", "icon": "https://static.dungeon-hub.net/livid.png" }, "fields": [ { "name": "field name", "value": "field value", "inline": true }, { "name": "field name 2", "value": "field value 2", "inline": false } ] }

URL format

Some fields in the embed can contain a URL. This URL is often a link to an image that should be used, but it can reference any possible url. These fields are checked before the embed is sent, and if any of the URLs are not valid, an error will be shown. The URL must contain a valid protocol, meaning it must start with e.g. http:// or https://.

Message Link

The message link is a link to a message in discord, which can be obtained by right-clicking on a message and selecting Copy Message Link. This link is used to identify the message that should be edited or read from.

(?x) # enable comment mode (?i) # ignore case (?:https?+://)?+ # 'https://' or 'http://' or '' (?:(?:canary|ptb)\\.)?+ # 'canary.' or 'ptb.' discord(?:app)?+\\.com/channels/ # 'discord(app).com/channels/' (?:(?<server>[0-9]++)|@me) # '@me' or the server id as named group / # '/' (?<channel>[0-9]++) # the textchannel id as named group / # '/' (?<message>[0-9]++) # the message id as named group

Timestamp

The timestamp field is a unix timestamp in milliseconds. This is used to display a timestamp in the embed.
You can convert a date to a timestamp and vice versa by using websites like this.
Please make sure that the timestamp is in milliseconds, as the bot will not convert it for you, resulting in incorrect dates being shown.

Color

The color field is a hex color code, with a leading #. This color is used to color the left bar of the embed.
You can use websites like this or this to find a color you like.

Last modified: 27 February 2025