Class Embed

java.lang.Object

net.dv8tion.jda.api.EmbedBuilder

com.github.kaktushose.jda.commands.embeds.Embed

public class Embed
extends EmbedBuilder

Subclass of EmbedBuilder that supports placeholders and easier manipulation of fields.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Embed.Fields	Methods for manipulating the fields of an Embed.

Field Summary

Fields inherited from class net.dv8tion.jda.api.EmbedBuilder

URL_PATTERN, ZERO_WIDTH_SPACE

Constructor Summary

Constructors

Constructor	Description
Embed(EmbedBuilder embedBuilder, String name, Map<String,Object> placeholders, I18n i18n)	Constructs a new Embed.
Embed(DataObject object, String name, Map<String,Object> placeholders, I18n i18n)	Constructs a new Embed.

Method Summary

Modifier and Type	Method	Description
Embed	addField(String name, String value)	Adds a Field to the embed that isn't inlined.
Embed	author(@Nullable String name)	Sets the Author of the embed.
Embed	author(@Nullable String name, @Nullable String url)	Sets the Author of the embed.
Embed	author(@Nullable String name, @Nullable String url, @Nullable String iconUrl)	Sets the Author of the embed.
MessageEmbed	build()	Returns a MessageEmbed just like EmbedBuilder.build(), but will also localize this embed based on the locale(Locale) and placeholders provided.
Embed	color(int color)	Sets the Color of the embed.
Embed	color(@Nullable Color color)	Sets the Color of the embed.
Embed	description(@Nullable CharSequence description)	Sets the Description of the embed.
Embed.Fields	fields()	Used to modify the fields of this embed.
Embed	footer(@Nullable String footer)	Sets the Footer of the embed.
Embed	footer(@Nullable String footer, @Nullable String iconUrl)	Sets the Footer of the embed.
Embed	image(@Nullable String url)	Sets the Image of the embed.
Embed	locale(Locale locale)	Sets the Locale this Embed will be localized with.
String	name()	Gets the name of this embed.
Embed	placeholders(I18n.Entry... placeholders)	Adds all the provided placeholders to this embed instance.
Embed	placeholders(Map<String,Object> placeholders)	Adds all the provided placeholders to this embed instance.
Embed	thumbnail(@Nullable String url)	Sets the Thumbnail of the embed.
Embed	timestamp(@Nullable TemporalAccessor accessor)	Sets the Timestamp of the embed.
Embed	title(@Nullable String title)	Sets the Title of the embed.
Embed	title(@Nullable String title, @Nullable String url)	Sets the Title of the embed.
MessageCreateData	toMessageCreateData()	Transforms this embed into MessageCreateData.
MessageEditData	toMessageEditData()	Transforms this embed into MessageEditData.

Methods inherited from class net.dv8tion.jda.api.EmbedBuilder

addBlankField, addField, addField, appendDescription, clear, clearFields, copyFrom, copyFrom, fromData, getDescriptionBuilder, getFields, isEmpty, isValidLength, length, setAuthor, setAuthor, setAuthor, setColor, setColor, setDescription, setFooter, setFooter, setImage, setThumbnail, setTimestamp, setTitle, setTitle, setUrl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Embed

public Embed(EmbedBuilder embedBuilder,
 String name,
 Map<String,Object> placeholders,
 I18n i18n)

Constructs a new Embed.

Parameters:

embedBuilder - the underlying EmbedBuilder to use

name - the name of this embed used to identify it in EmbedDataSources

placeholders - the global placeholders as defined in Embeds

Embed

public Embed(DataObject object,
 String name,
 Map<String,Object> placeholders,
 I18n i18n)

Constructs a new Embed.

Parameters:

object - the DataObject to construct the underlying EmbedBuilder from

name - the name of this embed used to identify it in EmbedDataSources

placeholders - the global placeholders as defined in Embeds

Method Details

locale

public Embed locale(Locale locale)

Sets the Locale this Embed will be localized with.

Parameters:

locale - the Locale to use for localization

Returns:

this instance for fluent interface

See Also:

• I18n

name

public String name()

Gets the name of this embed. This isn't a field that get displayed but only the name this embed is referenced by in the EmbedDataSource.

Returns:

the name of this embed

title

public Embed title(@Nullable String title)

Sets the Title of the embed.

Parameters:

title - the title of the embed

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setTitle(String)

title

public Embed title(@Nullable String title,
 @Nullable String url)

Sets the Title of the embed.

Parameters:

title - the title of the embed

url - Makes the title into a hyperlink pointed at this url.

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setTitle(String, String)

description

public Embed description(@Nullable CharSequence description)

Sets the Description of the embed.

Parameters:

description - the description of the embed, null to reset

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setDescription(CharSequence)

color

public Embed color(int color)

Sets the Color of the embed.

Parameters:

color - The raw rgb value, or Role.DEFAULT_COLOR_RAW to use no color

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setColor(int)

color

public Embed color(@Nullable Color color)

Sets the Color of the embed.

Parameters:

color - The Color of the embed or null to use no color

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setColor(Color)

timestamp

public Embed timestamp(@Nullable TemporalAccessor accessor)

Sets the Timestamp of the embed.

Parameters:

accessor - the temporal accessor of the timestamp

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setTimestamp(TemporalAccessor)

footer

public Embed footer(@Nullable String footer)

Sets the Footer of the embed.

Parameters:

footer - the text of the footer of the embed. If this is not set or set to null, the footer will not appear in the embed.

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setFooter(String)

footer

public Embed footer(@Nullable String footer,
 @Nullable String iconUrl)

Sets the Footer of the embed.

Parameters:

footer - the text of the footer of the embed. If this is not set or set to null, the footer will not appear in the embed.

iconUrl - the url of the icon for the footer

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setFooter(String, String)

thumbnail

public Embed thumbnail(@Nullable String url)

Sets the Thumbnail of the embed.

Parameters:

url - the url of the thumbnail of the embed

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setThumbnail(String)

image

public Embed image(@Nullable String url)

Sets the Image of the embed.

Parameters:

url - the url of the image of the embed

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setImage(String)

author

public Embed author(@Nullable String name)

Sets the Author of the embed.

Parameters:

name - the name of the author of the embed. If this is not set, the author will not appear in the embed

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setAuthor(String)

author

public Embed author(@Nullable String name,
 @Nullable String url)

Sets the Author of the embed.

Parameters:

name - the name of the author of the embed. If this is not set, the author will not appear in the embed

url - the url of the author of the embed

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setAuthor(String, String)

author

public Embed author(@Nullable String name,
 @Nullable String url,
 @Nullable String iconUrl)

Sets the Author of the embed.

Parameters:

name - the name of the author of the embed. If this is not set, the author will not appear in the embed

url - the url of the author of the embed

iconUrl - the url of the icon of the embed

Returns:

this instance for fluent interface

See Also:

• EmbedBuilder.setAuthor(String, String, String)

fields

public Embed.Fields fields()

Used to modify the fields of this embed.

Returns:

this instance for fluent interface

addField

public Embed addField(String name,
 String value)

Adds a Field to the embed that isn't inlined.

Parameters:

name - the name of the Field, displayed in bold above the value.

value - the contents of the field.

Returns:

this instance for fluent interface

placeholders

public Embed placeholders(Map<String,Object> placeholders)

Adds all the provided placeholders to this embed instance. The values will be replaced when build() is called.

Existing entries with the same keys will be overwritten.

Internally this uses the localization system, thus placeholders are limited by the used Localizer implementation

Parameters:

placeholders - a map of placeholder names to their corresponding values

Returns:

this instance for fluent interface

placeholders

public Embed placeholders(I18n.Entry... placeholders)

Adds all the provided placeholders to this embed instance. The values will be replaced when build() is called.

Existing entries with the same keys will be overwritten.

Internally this uses the localization system, thus placeholders are limited by the used Localizer implementation

Parameters:

placeholders - the entries to add

Returns:

this instance for fluent interface

build

public MessageEmbed build()

Returns a MessageEmbed just like EmbedBuilder.build(), but will also localize this embed based on the locale(Locale) and placeholders provided.

Overrides:

build in class EmbedBuilder

Returns:

the built, sendable MessageEmbed

toMessageCreateData

public MessageCreateData toMessageCreateData()

Transforms this embed into MessageCreateData.

Returns:

the transformed MessageCreateData

toMessageEditData

public MessageEditData toMessageEditData()

Transforms this embed into MessageEditData.

Returns:

the transformed MessageEditData