From 01afa91065f3ebce9ed47184a161377b85a2cd53 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Tue, 8 Jun 2021 18:34:54 +0200
Subject: [PATCH 01/10] Support multi-embeds in MessageAction

---
 .../jda/api/entities/MessageChannel.java      | 300 ++++++++++++++++++
 .../requests/restaction/MessageAction.java    |  53 ++++
 .../internal/entities/TextChannelImpl.java    |  11 +
 .../restaction/MessageActionImpl.java         |  39 ++-
 4 files changed, 395 insertions(+), 8 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
index 56e041af38..9ba520aaa7 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
@@ -15,6 +15,9 @@
  */
 package net.dv8tion.jda.api.entities;
 
+import net.dv8tion.jda.annotations.DeprecatedSince;
+import net.dv8tion.jda.annotations.ForRemoval;
+import net.dv8tion.jda.annotations.ReplaceWith;
 import net.dv8tion.jda.api.AccountType;
 import net.dv8tion.jda.api.exceptions.AccountTypeException;
 import net.dv8tion.jda.api.requests.RestAction;
@@ -400,9 +403,15 @@ default MessageAction sendMessageFormat(@Nonnull String format, @Nonnull Object.
      *
      * @see    net.dv8tion.jda.api.MessageBuilder
      * @see    net.dv8tion.jda.api.EmbedBuilder
+     * 
+     * @deprecated This is deprecated in favor of {@link #sendMessageEmbeds(MessageEmbed...)}
      */
     @Nonnull
     @CheckReturnValue
+    @Deprecated
+    @ForRemoval(deadline="5.0.0")
+    @ReplaceWith("sendMessageEmbeds(embed)")
+    @DeprecatedSince("4.4.0")
     default MessageAction sendMessage(@Nonnull MessageEmbed embed)
     {
         Checks.notNull(embed, "Provided embed");
@@ -411,6 +420,93 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
         return new MessageActionImpl(getJDA(), route, this).embed(embed);
     }
 
+    /**
+     * Sends up to 10 specified {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} as a {@link net.dv8tion.jda.api.entities.Message Message}
+     * to this channel.
+     * <br>This will fail if this channel is an instance of {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and
+     * the currently logged in account does not have permissions to send a message to this channel.
+     * <br>To determine if you are able to send a message in a {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} use
+     * {@link net.dv8tion.jda.api.entities.Member#hasPermission(GuildChannel, net.dv8tion.jda.api.Permission...)
+     *  guild.getSelfMember().hasPermission(channel, Permission.MESSAGE_WRITE)}.
+     *
+     * <p>For {@link net.dv8tion.jda.api.requests.ErrorResponse} information, refer to {@link #sendMessage(Message)}.
+     *
+     * @param  embeds
+     *         the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to send
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If this is a {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and the logged in account does
+     *         not have
+     *         <ul>
+     *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}</li>
+     *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE}</li>
+     *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_EMBED_LINKS Permission.MESSAGE_EMBED_LINKS}</li>
+     *         </ul>
+     * @throws java.lang.IllegalArgumentException
+     *         If any of the provided embeds is {@code null} or if the provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
+     *         is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}
+     * @throws java.lang.UnsupportedOperationException
+     *         If this is a {@link net.dv8tion.jda.api.entities.PrivateChannel PrivateChannel}
+     *         and both the currently logged in account and the target user are bots.
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The newly created Message after it has been sent to Discord.
+     *
+     * @see    net.dv8tion.jda.api.MessageBuilder
+     * @see    net.dv8tion.jda.api.EmbedBuilder
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction sendMessageEmbeds(@Nonnull MessageEmbed... embeds)
+    {
+        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
+        return new MessageActionImpl(getJDA(), route, this).setEmbeds(embeds);
+    }
+
+    /**
+     * Sends up to 10 specified {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} as a {@link net.dv8tion.jda.api.entities.Message Message}
+     * to this channel.
+     * <br>This will fail if this channel is an instance of {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and
+     * the currently logged in account does not have permissions to send a message to this channel.
+     * <br>To determine if you are able to send a message in a {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} use
+     * {@link net.dv8tion.jda.api.entities.Member#hasPermission(GuildChannel, net.dv8tion.jda.api.Permission...)
+     *  guild.getSelfMember().hasPermission(channel, Permission.MESSAGE_WRITE)}.
+     *
+     * <p>For {@link net.dv8tion.jda.api.requests.ErrorResponse} information, refer to {@link #sendMessage(Message)}.
+     *
+     * @param  embeds
+     *         the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to send
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If this is a {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and the logged in account does
+     *         not have
+     *         <ul>
+     *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}</li>
+     *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE}</li>
+     *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_EMBED_LINKS Permission.MESSAGE_EMBED_LINKS}</li>
+     *         </ul>
+     * @throws java.lang.IllegalArgumentException
+     *         If any of the provided embeds is {@code null} or if the provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
+     *         is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}
+     * @throws java.lang.UnsupportedOperationException
+     *         If this is a {@link net.dv8tion.jda.api.entities.PrivateChannel PrivateChannel}
+     *         and both the currently logged in account and the target user are bots.
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The newly created Message after it has been sent to Discord.
+     *
+     * @see    net.dv8tion.jda.api.MessageBuilder
+     * @see    net.dv8tion.jda.api.EmbedBuilder
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction sendMessageEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
+    {
+        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
+        return new MessageActionImpl(getJDA(), route, this).setEmbeds(embeds);
+    }
+
+
     /**
      * Sends a specified {@link net.dv8tion.jda.api.entities.Message Message} to this channel.
      * <br>This will fail if this channel is an instance of {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and
@@ -2956,6 +3052,10 @@ default MessageAction editMessageFormatById(long messageId, @Nonnull String form
      */
     @Nonnull
     @CheckReturnValue
+    @Deprecated
+    @ForRemoval(deadline = "5.0.0")
+    @ReplaceWith("editMessageEmbedsById(messageId, newEmbed)")
+    @DeprecatedSince("4.4.0")
     default MessageAction editMessageById(@Nonnull String messageId, @Nonnull MessageEmbed newEmbed)
     {
         Checks.isSnowflake(messageId, "Message ID");
@@ -3010,11 +3110,211 @@ default MessageAction editMessageById(@Nonnull String messageId, @Nonnull Messag
      */
     @Nonnull
     @CheckReturnValue
+    @Deprecated
+    @ForRemoval(deadline = "5.0.0")
+    @ReplaceWith("editMessageEmbedsById(messageId, newEmbed)")
+    @DeprecatedSince("4.4.0")
     default MessageAction editMessageById(long messageId, @Nonnull MessageEmbed newEmbed)
     {
         return editMessageById(Long.toUnsignedString(messageId), newEmbed);
     }
 
+    /**
+     * Attempts to edit a message by its id in this MessageChannel.
+     *
+     * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#INVALID_AUTHOR_EDIT INVALID_AUTHOR_EDIT}
+     *     <br>Attempted to edit a message that was not sent by the currently logged in account.
+     *         Discord does not allow editing of other users' Messages!</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The request was attempted after the account lost access to the {@link net.dv8tion.jda.api.entities.Guild Guild}
+     *         typically due to being kicked or removed, or after {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         was revoked in the {@link net.dv8tion.jda.api.entities.TextChannel TextChannel}</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_MESSAGE UNKNOWN_MESSAGE}
+     *     <br>The provided {@code messageId} is unknown in this MessageChannel, either due to the id being invalid, or
+     *         the message it referred to has already been deleted.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_CHANNEL UNKNOWN_CHANNEL}
+     *     <br>The request was attempted after the channel was deleted.</li>
+     * </ul>
+     *
+     * @param  messageId
+     *         The id referencing the Message that should be edited
+     * @param  newEmbeds
+     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *
+     * @throws IllegalArgumentException
+     *         <ul>
+     *             <li>If provided {@code messageId} is {@code null} or empty.</li>
+     *             <li>If provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
+     *                 is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}</li>
+     *         </ul>
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If this is a TextChannel and this account does not have
+     *         {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         or {@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE}
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The modified Message after it has been sent to discord
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction editMessageEmbedsById(@Nonnull String messageId, @Nonnull MessageEmbed... newEmbeds)
+    {
+        Checks.noneNull(newEmbeds, "MessageEmbeds");
+        return editMessageEmbedsById(messageId, Arrays.asList(newEmbeds));
+    }
+
+    /**
+     * Attempts to edit a message by its id in this MessageChannel.
+     *
+     * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#INVALID_AUTHOR_EDIT INVALID_AUTHOR_EDIT}
+     *     <br>Attempted to edit a message that was not sent by the currently logged in account.
+     *         Discord does not allow editing of other users' Messages!</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The request was attempted after the account lost access to the {@link net.dv8tion.jda.api.entities.Guild Guild}
+     *         typically due to being kicked or removed, or after {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         was revoked in the {@link net.dv8tion.jda.api.entities.TextChannel TextChannel}</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_MESSAGE UNKNOWN_MESSAGE}
+     *     <br>The provided {@code messageId} is unknown in this MessageChannel, either due to the id being invalid, or
+     *         the message it referred to has already been deleted.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_CHANNEL UNKNOWN_CHANNEL}
+     *     <br>The request was attempted after the channel was deleted.</li>
+     * </ul>
+     *
+     * @param  messageId
+     *         The id referencing the Message that should be edited
+     * @param  newEmbeds
+     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *
+     * @throws IllegalArgumentException
+     *         <ul>
+     *             <li>If provided {@code messageId} is {@code null} or empty.</li>
+     *             <li>If provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
+     *                 is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}</li>
+     *         </ul>
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If this is a TextChannel and this account does not have
+     *         {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         or {@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE}
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The modified Message after it has been sent to discord
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction editMessageEmbedsById(long messageId, @Nonnull MessageEmbed... newEmbeds)
+    {
+        return editMessageEmbedsById(Long.toUnsignedString(messageId), newEmbeds);
+    }
+
+    /**
+     * Attempts to edit a message by its id in this MessageChannel.
+     *
+     * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#INVALID_AUTHOR_EDIT INVALID_AUTHOR_EDIT}
+     *     <br>Attempted to edit a message that was not sent by the currently logged in account.
+     *         Discord does not allow editing of other users' Messages!</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The request was attempted after the account lost access to the {@link net.dv8tion.jda.api.entities.Guild Guild}
+     *         typically due to being kicked or removed, or after {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         was revoked in the {@link net.dv8tion.jda.api.entities.TextChannel TextChannel}</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_MESSAGE UNKNOWN_MESSAGE}
+     *     <br>The provided {@code messageId} is unknown in this MessageChannel, either due to the id being invalid, or
+     *         the message it referred to has already been deleted.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_CHANNEL UNKNOWN_CHANNEL}
+     *     <br>The request was attempted after the channel was deleted.</li>
+     * </ul>
+     *
+     * @param  messageId
+     *         The id referencing the Message that should be edited
+     * @param  newEmbeds
+     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *
+     * @throws IllegalArgumentException
+     *         <ul>
+     *             <li>If provided {@code messageId} is {@code null} or empty.</li>
+     *             <li>If provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
+     *                 is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}</li>
+     *         </ul>
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If this is a TextChannel and this account does not have
+     *         {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         or {@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE}
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The modified Message after it has been sent to discord
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction editMessageEmbedsById(@Nonnull String messageId, @Nonnull Collection<? extends MessageEmbed> newEmbeds)
+    {
+        Checks.isSnowflake(messageId, "Message ID");
+        Route.CompiledRoute route = Route.Messages.EDIT_MESSAGE.compile(getId(), messageId);
+        return new MessageActionImpl(getJDA(), route, this).setEmbeds(newEmbeds);
+    }
+
+    /**
+     * Attempts to edit a message by its id in this MessageChannel.
+     *
+     * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#INVALID_AUTHOR_EDIT INVALID_AUTHOR_EDIT}
+     *     <br>Attempted to edit a message that was not sent by the currently logged in account.
+     *         Discord does not allow editing of other users' Messages!</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The request was attempted after the account lost access to the {@link net.dv8tion.jda.api.entities.Guild Guild}
+     *         typically due to being kicked or removed, or after {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         was revoked in the {@link net.dv8tion.jda.api.entities.TextChannel TextChannel}</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_MESSAGE UNKNOWN_MESSAGE}
+     *     <br>The provided {@code messageId} is unknown in this MessageChannel, either due to the id being invalid, or
+     *         the message it referred to has already been deleted.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_CHANNEL UNKNOWN_CHANNEL}
+     *     <br>The request was attempted after the channel was deleted.</li>
+     * </ul>
+     *
+     * @param  messageId
+     *         The id referencing the Message that should be edited
+     * @param  newEmbeds
+     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *
+     * @throws IllegalArgumentException
+     *         <ul>
+     *             <li>If provided {@code messageId} is {@code null} or empty.</li>
+     *             <li>If provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
+     *                 is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}</li>
+     *         </ul>
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If this is a TextChannel and this account does not have
+     *         {@link net.dv8tion.jda.api.Permission#MESSAGE_READ Permission.MESSAGE_READ}
+     *         or {@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE}
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The modified Message after it has been sent to discord
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction editMessageEmbedsById(long messageId, @Nonnull Collection<? extends MessageEmbed> newEmbeds)
+    {
+        return editMessageEmbedsById(Long.toUnsignedString(messageId), newEmbeds);
+    }
+
+
     @Override
     default void formatTo(Formatter formatter, int flags, int width, int precision)
     {
diff --git a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
index 94a7c695c6..dc480cab23 100644
--- a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
+++ b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
@@ -16,6 +16,9 @@
 
 package net.dv8tion.jda.api.requests.restaction;
 
+import net.dv8tion.jda.annotations.DeprecatedSince;
+import net.dv8tion.jda.annotations.ForRemoval;
+import net.dv8tion.jda.annotations.ReplaceWith;
 import net.dv8tion.jda.api.MessageBuilder;
 import net.dv8tion.jda.api.entities.Message;
 import net.dv8tion.jda.api.entities.MessageChannel;
@@ -437,11 +440,61 @@ default MessageAction reference(@Nonnull Message message)
      *         If the provided MessageEmbed is an unknown implementation this operation will fail as we are unable to deserialize it.
      *
      * @return Updated MessageAction for chaining convenience
+     *
+     * @deprecated This is deprecated in favor of {@link #setEmbeds(MessageEmbed...)}
      */
     @Nonnull
     @CheckReturnValue
+    @Deprecated
+    @ForRemoval(deadline="5.0.0")
+    @ReplaceWith("setEmbeds(embed)")
+    @DeprecatedSince("4.4.0")
     MessageAction embed(@Nullable final MessageEmbed embed);
 
+    /**
+     * Sets the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}
+     * that should be used for this Message.
+     * Refer to {@link net.dv8tion.jda.api.EmbedBuilder EmbedBuilder} for more information.
+     *
+     * @param  embeds
+     *         The {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} that should
+     *         be attached to this message, {@code Collections.emptyList()} to use no embed.
+     *
+     * @throws java.lang.IllegalArgumentException
+     *         If any of the provided MessageEmbeds is not sendable according to
+     *         {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
+     *         If the provided MessageEmbed is an unknown implementation this operation will fail as we are unable to deserialize it.
+     *
+     * @return Updated MessageAction for chaining convenience
+     */
+    @Nonnull
+    @CheckReturnValue
+    MessageAction setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds);
+
+    /**
+     * Sets the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}
+     * that should be used for this Message.
+     * Refer to {@link net.dv8tion.jda.api.EmbedBuilder EmbedBuilder} for more information.
+     *
+     * @param  embeds
+     *         The {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} that should
+     *         be attached to this message, {@code Collections.emptyList()} to use no embed.
+     *
+     * @throws java.lang.IllegalArgumentException
+     *         If any of the provided MessageEmbeds is not sendable according to
+     *         {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
+     *         If the provided MessageEmbed is an unknown implementation this operation will fail as we are unable to deserialize it.
+     *
+     * @return Updated MessageAction for chaining convenience
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction setEmbeds(@Nonnull MessageEmbed... embeds)
+    {
+        Checks.noneNull(embeds, "MessageEmbeds");
+        return setEmbeds(Arrays.asList(embeds));
+    }
+
     /**
      * {@inheritDoc}
      * @throws java.lang.IllegalArgumentException
diff --git a/src/main/java/net/dv8tion/jda/internal/entities/TextChannelImpl.java b/src/main/java/net/dv8tion/jda/internal/entities/TextChannelImpl.java
index d52ca87edb..e45f783955 100644
--- a/src/main/java/net/dv8tion/jda/internal/entities/TextChannelImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/entities/TextChannelImpl.java
@@ -585,6 +585,7 @@ public MessageAction editMessageById(@Nonnull String messageId, @Nonnull CharSeq
 
     @Nonnull
     @Override
+    @Deprecated
     public MessageAction editMessageById(@Nonnull String messageId, @Nonnull MessageEmbed newEmbed)
     {
         checkPermission(Permission.MESSAGE_READ);
@@ -593,6 +594,16 @@ public MessageAction editMessageById(@Nonnull String messageId, @Nonnull Message
         return TextChannel.super.editMessageById(messageId, newEmbed);
     }
 
+    @Nonnull
+    @Override
+    public MessageAction editMessageEmbedsById(@Nonnull String messageId, @Nonnull Collection<? extends MessageEmbed> newEmbeds)
+    {
+        checkPermission(Permission.MESSAGE_READ);
+        checkPermission(Permission.MESSAGE_WRITE);
+        checkPermission(Permission.MESSAGE_EMBED_LINKS);
+        return TextChannel.super.editMessageEmbedsById(messageId, newEmbeds);
+    }
+
     @Nonnull
     @Override
     public MessageAction editMessageById(@Nonnull String id, @Nonnull Message newContent)
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
index b7b93d474e..f7c71b99e8 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
@@ -61,7 +61,7 @@ public class MessageActionImpl extends RestActionImpl<Message> implements Messag
     protected final AllowedMentionsImpl allowedMentions = new AllowedMentionsImpl();
     protected List<ActionRow> components;
     protected List<String> retainedAttachments;
-    protected MessageEmbed embed = null;
+    protected List<MessageEmbed> embeds = null;
     protected String nonce = null;
     protected boolean tts = false, override = false;
     protected boolean failOnInvalidReply = defaultFailOnInvalidReply;
@@ -125,7 +125,7 @@ public MessageChannel getChannel()
     public boolean isEmpty()
     {
         return Helpers.isBlank(content)
-            && (embed == null || embed.isEmpty() || !hasPermission(Permission.MESSAGE_EMBED_LINKS));
+            && (embeds == null || embeds.isEmpty() || !hasPermission(Permission.MESSAGE_EMBED_LINKS));
     }
 
     @Override
@@ -220,8 +220,31 @@ public MessageActionImpl embed(final MessageEmbed embed)
             Checks.check(embed.isSendable(),
                "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
                MessageEmbed.EMBED_MAX_LENGTH_BOT);
+            if (this.embeds == null)
+                this.embeds = new ArrayList<>();
+            this.embeds.add(embed);
         }
-        this.embed = embed;
+        else
+        {
+            this.embeds = null;
+        }
+        return this;
+    }
+
+    @Nonnull
+    @Override
+    public MessageAction setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
+    {
+        Checks.noneNull(embeds, "MessageEmbeds");
+        embeds.forEach(embed ->
+            Checks.check(embed.isSendable(),
+                "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
+                MessageEmbed.EMBED_MAX_LENGTH_BOT)
+        );
+        if (this.embeds == null)
+            this.embeds = new ArrayList<>();
+        this.embeds.clear();
+        this.embeds.addAll(embeds);
         return this;
     }
 
@@ -467,10 +490,10 @@ protected DataObject getJSON()
         final DataObject obj = DataObject.empty();
         if (override)
         {
-            if (embed == null)
-                obj.putNull("embed");
+            if (embeds == null)
+                obj.putNull("embeds");
             else
-                obj.put("embed", embed);
+                obj.put("embeds", DataArray.fromCollection(embeds));
             if (content.length() == 0)
                 obj.putNull("content");
             else
@@ -493,8 +516,8 @@ protected DataObject getJSON()
         }
         else
         {
-            if (embed != null)
-                obj.put("embed", embed);
+            if (embeds != null)
+                obj.put("embeds", DataArray.fromCollection(embeds));
             if (content.length() > 0)
                 obj.put("content", content.toString());
             if (nonce != null)

From 919b1298b9f4902485c58c45c1d8471dafb23194 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Tue, 8 Jun 2021 20:14:26 +0200
Subject: [PATCH 02/10] Add check for embed count

---
 .../java/net/dv8tion/jda/api/entities/MessageChannel.java | 8 ++++----
 .../jda/api/requests/restaction/MessageAction.java        | 4 ++--
 .../internal/requests/restaction/MessageActionImpl.java   | 1 +
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
index 9ba520aaa7..50ae69af86 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
@@ -3144,7 +3144,7 @@ default MessageAction editMessageById(long messageId, @Nonnull MessageEmbed newE
      * @param  messageId
      *         The id referencing the Message that should be edited
      * @param  newEmbeds
-     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *         Up to 10 new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
      *
      * @throws IllegalArgumentException
      *         <ul>
@@ -3193,7 +3193,7 @@ default MessageAction editMessageEmbedsById(@Nonnull String messageId, @Nonnull
      * @param  messageId
      *         The id referencing the Message that should be edited
      * @param  newEmbeds
-     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *         Up to 10 new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
      *
      * @throws IllegalArgumentException
      *         <ul>
@@ -3241,7 +3241,7 @@ default MessageAction editMessageEmbedsById(long messageId, @Nonnull MessageEmbe
      * @param  messageId
      *         The id referencing the Message that should be edited
      * @param  newEmbeds
-     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *         Up to 10 new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
      *
      * @throws IllegalArgumentException
      *         <ul>
@@ -3291,7 +3291,7 @@ default MessageAction editMessageEmbedsById(@Nonnull String messageId, @Nonnull
      * @param  messageId
      *         The id referencing the Message that should be edited
      * @param  newEmbeds
-     *         The new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
+     *         Up to 10 new {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} for the edited message
      *
      * @throws IllegalArgumentException
      *         <ul>
diff --git a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
index dc480cab23..a8bfce9499 100644
--- a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
+++ b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
@@ -452,7 +452,7 @@ default MessageAction reference(@Nonnull Message message)
     MessageAction embed(@Nullable final MessageEmbed embed);
 
     /**
-     * Sets the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}
+     * Sets up to 10 {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}
      * that should be used for this Message.
      * Refer to {@link net.dv8tion.jda.api.EmbedBuilder EmbedBuilder} for more information.
      *
@@ -472,7 +472,7 @@ default MessageAction reference(@Nonnull Message message)
     MessageAction setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds);
 
     /**
-     * Sets the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}
+     * Sets up to 10 {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}
      * that should be used for this Message.
      * Refer to {@link net.dv8tion.jda.api.EmbedBuilder EmbedBuilder} for more information.
      *
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
index f7c71b99e8..31e87a581b 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
@@ -241,6 +241,7 @@ public MessageAction setEmbeds(@Nonnull Collection<? extends MessageEmbed> embed
                 "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
                 MessageEmbed.EMBED_MAX_LENGTH_BOT)
         );
+        Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
         if (this.embeds == null)
             this.embeds = new ArrayList<>();
         this.embeds.clear();

From 985f06a6d1f5a2cb0b66d216a1481913766a7d17 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Wed, 9 Jun 2021 17:33:57 +0200
Subject: [PATCH 03/10] Improve length checks for embeds

---
 .../net/dv8tion/jda/api/entities/MessageEmbed.java     | 10 +++++-----
 .../requests/restaction/MessageActionImpl.java         |  1 +
 .../requests/restaction/WebhookMessageActionImpl.java  |  9 ++++++++-
 .../restaction/WebhookMessageUpdateActionImpl.java     |  8 +++++++-
 4 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageEmbed.java b/src/main/java/net/dv8tion/jda/api/entities/MessageEmbed.java
index c7508d5ad8..3381fa2125 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageEmbed.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageEmbed.java
@@ -356,17 +356,17 @@ public int getLength()
             length = 0;
 
             if (title != null)
-                length += title.length();
+                length += Helpers.codePointLength(title);
             if (description != null)
-                length += description.length();
+                length += Helpers.codePointLength(description);
             if (author != null)
-                length += author.getName().length();
+                length += Helpers.codePointLength(author.getName());
             if (footer != null)
-                length += footer.getText().length();
+                length += Helpers.codePointLength(footer.getText());
             if (fields != null)
             {
                 for (Field f : fields)
-                    length += f.getName().length() + f.getValue().length();
+                    length += Helpers.codePointLength(f.getName()) + Helpers.codePointLength(f.getValue());
             }
 
             return length;
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
index 31e87a581b..8078f6d8f7 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
@@ -242,6 +242,7 @@ public MessageAction setEmbeds(@Nonnull Collection<? extends MessageEmbed> embed
                 MessageEmbed.EMBED_MAX_LENGTH_BOT)
         );
         Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
+        Checks.check(embeds.stream().mapToInt(MessageEmbed::getLength).sum() <= MessageEmbed.EMBED_MAX_LENGTH_BOT, "The sum of all MessageEmbeds may not exceed %d!", MessageEmbed.EMBED_MAX_LENGTH_BOT);
         if (this.embeds == null)
             this.embeds = new ArrayList<>();
         this.embeds.clear();
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageActionImpl.java
index 2e86ba3664..e14863edfc 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageActionImpl.java
@@ -41,6 +41,7 @@
 import java.io.InputStream;
 import java.util.*;
 import java.util.function.Function;
+import java.util.stream.Stream;
 
 public class WebhookMessageActionImpl<T>
     extends TriggerRestAction<T>
@@ -128,8 +129,14 @@ public WebhookMessageActionImpl<T> setTTS(boolean tts)
     @Override
     public WebhookMessageActionImpl<T> addEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
-        Checks.noneNull(embeds, "Message Embeds");
+        Checks.noneNull(embeds, "MessageEmbeds");
+        embeds.forEach(embed ->
+            Checks.check(embed.isSendable(),
+                "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
+                MessageEmbed.EMBED_MAX_LENGTH_BOT)
+        );
         Checks.check(this.embeds.size() + embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
+        Checks.check(Stream.concat(embeds.stream(), this.embeds.stream()).mapToInt(MessageEmbed::getLength).sum() <= MessageEmbed.EMBED_MAX_LENGTH_BOT, "The sum of all MessageEmbeds may not exceed %d!", MessageEmbed.EMBED_MAX_LENGTH_BOT);
         this.embeds.addAll(embeds);
         return this;
     }
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageUpdateActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageUpdateActionImpl.java
index 1e9d592d57..c6eb8d193a 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageUpdateActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/WebhookMessageUpdateActionImpl.java
@@ -80,7 +80,13 @@ public WebhookMessageUpdateAction<T> setContent(@Nullable String content)
     public WebhookMessageUpdateAction<T> setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
         Checks.noneNull(embeds, "MessageEmbeds");
-        Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in one message!");
+        embeds.forEach(embed ->
+            Checks.check(embed.isSendable(),
+                "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
+                MessageEmbed.EMBED_MAX_LENGTH_BOT)
+        );
+        Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
+        Checks.check(embeds.stream().mapToInt(MessageEmbed::getLength).sum() <= MessageEmbed.EMBED_MAX_LENGTH_BOT, "The sum of all MessageEmbeds may not exceed %d!", MessageEmbed.EMBED_MAX_LENGTH_BOT);
         this.embeds.clear();
         this.embeds.addAll(embeds);
         set |= EMBEDS;

From 6e811b5a62c8cfa552d942973f6b72a357b13af2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Thu, 10 Jun 2021 10:14:28 +0200
Subject: [PATCH 04/10] Update documentation

---
 .../net/dv8tion/jda/api/EmbedBuilder.java     | 10 +-
 .../net/dv8tion/jda/api/MessageBuilder.java   |  2 +-
 .../net/dv8tion/jda/api/entities/Message.java | 94 ++++++++++++++++++-
 .../jda/api/entities/MessageChannel.java      | 12 +--
 .../requests/restaction/MessageAction.java    |  8 +-
 .../internal/entities/ReceivedMessage.java    |  4 +-
 .../restaction/MessageActionImpl.java         |  9 +-
 7 files changed, 115 insertions(+), 24 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java b/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java
index 28dea90c92..074ecf4345 100644
--- a/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java
+++ b/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java
@@ -59,7 +59,7 @@ public class EmbedBuilder
 
     /**
      * Constructs a new EmbedBuilder instance, which can be used to create {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}.
-     * These can then be sent to a channel using {@link net.dv8tion.jda.api.entities.MessageChannel#sendMessage(MessageEmbed)}.
+     * These can then be sent to a channel using {@link net.dv8tion.jda.api.entities.MessageChannel#sendMessageEmbeds(MessageEmbed...)}.
      * <br>Every part of an embed can be removed or cleared by providing {@code null} to the setter method.
      */
     public EmbedBuilder() { }
@@ -480,7 +480,7 @@ public EmbedBuilder setColor(int color)
      * InputStream file = new URL("https://http.cat/500").openStream();
      * embed.setThumbnail("attachment://cat.png") // we specify this in sendFile as "cat.png"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.png").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.png").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * @param  url
@@ -526,7 +526,7 @@ public EmbedBuilder setThumbnail(@Nullable String url)
      * InputStream file = new URL("https://http.cat/500").openStream();
      * embed.setImage("attachment://cat.png") // we specify this in sendFile as "cat.png"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.png").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.png").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * @param  url
@@ -623,7 +623,7 @@ public EmbedBuilder setAuthor(@Nullable String name, @Nullable String url)
      * InputStream file = new URL("https://http.cat/500").openStream();
      * embed.setAuthor("Minn", null, "attachment://cat.png") // we specify this in sendFile as "cat.png"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.png").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.png").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * @param  name
@@ -699,7 +699,7 @@ public EmbedBuilder setFooter(@Nullable String text)
      * InputStream file = new URL("https://http.cat/500").openStream();
      * embed.setFooter("Cool footer!", "attachment://cat.png") // we specify this in sendFile as "cat.png"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.png").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.png").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * @param  text
diff --git a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
index 17dd60211f..d5aa346227 100644
--- a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
+++ b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
@@ -1212,7 +1212,7 @@ public MessageAction sendTo(@Nonnull MessageChannel channel)
         }
         final Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(channel.getId());
         final MessageActionImpl action = new MessageActionImpl(channel.getJDA(), route, channel, builder);
-        return action.tts(isTTS).embed(embed).nonce(nonce);
+        return action.tts(isTTS).setEmbeds(embed).nonce(nonce);
     }
 
     /**
diff --git a/src/main/java/net/dv8tion/jda/api/entities/Message.java b/src/main/java/net/dv8tion/jda/api/entities/Message.java
index ad7c54ca4f..807df829c4 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/Message.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/Message.java
@@ -15,6 +15,9 @@
  */
 package net.dv8tion.jda.api.entities;
 
+import net.dv8tion.jda.annotations.DeprecatedSince;
+import net.dv8tion.jda.annotations.ForRemoval;
+import net.dv8tion.jda.annotations.ReplaceWith;
 import net.dv8tion.jda.api.JDA;
 import net.dv8tion.jda.api.Permission;
 import net.dv8tion.jda.api.exceptions.HttpException;
@@ -1002,10 +1005,97 @@ default List<Button> getButtonsByLabel(@Nonnull String label, boolean ignoreCase
      *
      * @return {@link MessageAction MessageAction}
      *         <br>The {@link net.dv8tion.jda.api.entities.Message Message} with the updated content
+     *
+     * @deprecated Use {@link #editMessageEmbeds(MessageEmbed...)} instead
+     */
+    @Nonnull
+    @CheckReturnValue
+    @Deprecated
+    @ForRemoval(deadline = "5.0.0")
+    @ReplaceWith("editMessageEmbeds(newEmbed)")
+    @DeprecatedSince("4.4.0")
+    default MessageAction editMessage(@Nonnull MessageEmbed newContent)
+    {
+        return editMessageEmbeds(newContent);
+    }
+
+    /**
+     * Edits this Message's content to the provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}.
+     * <br><b>Messages can only be edited by the account that sent them!</b>.
+     *
+     * <p>This message instance will not be updated by this operation, please use the response message instead.
+     *
+     * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The edit was attempted after the account lost access to the {@link net.dv8tion.jda.api.entities.Guild Guild}
+     *         typically due to being kicked or removed.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The edit was attempted after the account lost {@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE} in
+     *         the {@link net.dv8tion.jda.api.entities.TextChannel TextChannel}.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_MESSAGE UNKNOWN_MESSAGE}
+     *     <br>The edit was attempted after the Message had been deleted.</li>
+     * </ul>
+     *
+     * @param  embeds
+     *         the new embeds of the Message (up to 10)
+     *
+     * @throws java.lang.UnsupportedOperationException
+     *         If this is not a Received Message from {@link net.dv8tion.jda.api.entities.MessageType#DEFAULT MessageType.DEFAULT}
+     * @throws java.lang.IllegalStateException
+     *         If the message attempting to be edited was not created by the currently logged in account, or
+     *         if any of the passed-in embeds is {@code null}
+     *         or not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}.
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The {@link net.dv8tion.jda.api.entities.Message Message} with the updated content
      */
     @Nonnull
     @CheckReturnValue
-    MessageAction editMessage(@Nonnull MessageEmbed newContent);
+    MessageAction editMessageEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds);
+
+    /**
+     * Edits this Message's content to the provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}.
+     * <br><b>Messages can only be edited by the account that sent them!</b>.
+     *
+     * <p>This message instance will not be updated by this operation, please use the response message instead.
+     *
+     * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_ACCESS MISSING_ACCESS}
+     *     <br>The edit was attempted after the account lost access to the {@link net.dv8tion.jda.api.entities.Guild Guild}
+     *         typically due to being kicked or removed.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The edit was attempted after the account lost {@link net.dv8tion.jda.api.Permission#MESSAGE_WRITE Permission.MESSAGE_WRITE} in
+     *         the {@link net.dv8tion.jda.api.entities.TextChannel TextChannel}.</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#UNKNOWN_MESSAGE UNKNOWN_MESSAGE}
+     *     <br>The edit was attempted after the Message had been deleted.</li>
+     * </ul>
+     *
+     * @param  embeds
+     *         the new embeds of the Message (up to 10)
+     *
+     * @throws java.lang.UnsupportedOperationException
+     *         If this is not a Received Message from {@link net.dv8tion.jda.api.entities.MessageType#DEFAULT MessageType.DEFAULT}
+     * @throws java.lang.IllegalStateException
+     *         If the message attempting to be edited was not created by the currently logged in account, or
+     *         if any of the passed-in embeds is {@code null}
+     *         or not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}.
+     *
+     * @return {@link MessageAction MessageAction}
+     *         <br>The {@link net.dv8tion.jda.api.entities.Message Message} with the updated content
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction editMessageEmbeds(@Nonnull MessageEmbed... embeds)
+    {
+        Checks.noneNull(embeds, "MessageEmbeds");
+        return editMessageEmbeds(Arrays.asList(embeds));
+    }
 
     /**
      * Edits this Message's content to the provided format.
@@ -1125,7 +1215,7 @@ default MessageAction reply(@Nonnull CharSequence content)
      * <br>By default there won't be any error thrown if the referenced message does not exist.
      * This behavior can be changed with {@link MessageAction#failOnInvalidReply(boolean)}.
      *
-     * <p>For further info, see {@link MessageChannel#sendMessage(MessageEmbed)} and {@link MessageAction#reference(Message)}.
+     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
      *
      * @param  content
      *         The content of the reply message
diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
index 50ae69af86..417b83c4f3 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
@@ -417,7 +417,7 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
         Checks.notNull(embed, "Provided embed");
 
         Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
-        return new MessageActionImpl(getJDA(), route, this).embed(embed);
+        return new MessageActionImpl(getJDA(), route, this).setEmbeds(embed);
     }
 
     /**
@@ -587,7 +587,7 @@ default MessageAction sendMessage(@Nonnull Message msg)
      * File file = new File("cat.gif");
      * embed.setImage("attachment://cat.gif")
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file).embed(embed.build()).queue();
+     * channel.sendFile(file).setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * <p>For {@link net.dv8tion.jda.api.requests.ErrorResponse} information, refer to the documentation for {@link #sendFile(java.io.File, String, AttachmentOption...)}.
@@ -655,7 +655,7 @@ default MessageAction sendFile(@Nonnull File file, @Nonnull AttachmentOption...
      * File file = new File("cat_01.gif");
      * embed.setImage("attachment://cat.gif") // we specify this in sendFile as "cat.gif"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.gif").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.gif").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * <p>The following {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} are possible:
@@ -744,7 +744,7 @@ default MessageAction sendFile(@Nonnull File file, @Nonnull String fileName, @No
      * InputStream file = new URL("https://http.cat/500").openStream();
      * embed.setImage("attachment://cat.png") // we specify this in sendFile as "cat.png"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.png").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.png").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * @param  data
@@ -802,7 +802,7 @@ default MessageAction sendFile(@Nonnull InputStream data, @Nonnull String fileNa
      * byte[] file = IOUtil.readFully(new URL("https://http.cat/500").openStream());
      * embed.setImage("attachment://cat.png") // we specify this in sendFile as "cat.png"
      *      .setDescription("This is a cute cat :3");
-     * channel.sendFile(file, "cat.png").embed(embed.build()).queue();
+     * channel.sendFile(file, "cat.png").setEmbeds(embed.build()).queue();
      * </code></pre>
      *
      * @param  data
@@ -3062,7 +3062,7 @@ default MessageAction editMessageById(@Nonnull String messageId, @Nonnull Messag
         Checks.notNull(newEmbed, "MessageEmbed");
 
         Route.CompiledRoute route = Route.Messages.EDIT_MESSAGE.compile(getId(), messageId);
-        return new MessageActionImpl(getJDA(), route, this).embed(newEmbed);
+        return new MessageActionImpl(getJDA(), route, this).setEmbeds(newEmbed);
     }
 
     /**
diff --git a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
index a8bfce9499..270272a840 100644
--- a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
+++ b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
@@ -72,7 +72,7 @@
  *      MessageChannel channel = event.getChannel();
  *      channel.sendMessage("This has an embed with an image!")
  *             .addFile(new File("dog.png"))
- *             .embed(new EmbedBuilder()
+ *             .setEmbeds(new EmbedBuilder()
  *                 .setImage("attachment://dog.png")
  *                 .build())
  *             .queue(); // this actually sends the information to discord
@@ -83,11 +83,11 @@
  *
  * @see    Message#editMessage(Message)
  * @see    Message#editMessage(CharSequence)
- * @see    Message#editMessage(MessageEmbed)
+ * @see    Message#editMessageEmbeds(MessageEmbed...)
  * @see    Message#editMessageFormat(String, Object...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessage(Message)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessage(CharSequence)
- * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessage(MessageEmbed)
+ * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessageEmbeds(MessageEmbed...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessageFormat(String, Object...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendFile(File, AttachmentOption...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendFile(File, String, AttachmentOption...)
@@ -381,7 +381,7 @@ default MessageAction reference(@Nonnull Message message)
      * <br>{@link #isEmpty()} will result in {@code true} after this has been performed!
      *
      * <p>Convenience over using
-     * {@code content(null).nonce(null).embed(null).tts(false).override(false).clearFiles()}
+     * {@code content(null).nonce(null).setEmbeds(emptyList()).tts(false).override(false).clearFiles()}
      *
      * @return Updated MessageAction for chaining convenience
      */
diff --git a/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java b/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java
index d9bd5cf4c0..53312a050b 100644
--- a/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java
+++ b/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java
@@ -803,10 +803,10 @@ public MessageAction editMessage(@Nonnull CharSequence newContent)
 
     @Nonnull
     @Override
-    public MessageAction editMessage(@Nonnull MessageEmbed newContent)
+    public MessageAction editMessageEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
         checkUser();
-        return channel.editMessageById(getId(), newContent);
+        return channel.editMessageEmbedsById(getId(), embeds);
     }
 
     @Nonnull
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
index 4b216a430e..6b26861dc7 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
@@ -144,8 +144,8 @@ public MessageActionImpl apply(final Message message)
         if (message == null || message.getType().isSystem())
             return this;
         final List<MessageEmbed> embeds = message.getEmbeds();
-        if (embeds != null && !embeds.isEmpty() && embeds.get(0).getType() == EmbedType.RICH)
-            embed(embeds.get(0));
+        if (embeds != null && !embeds.isEmpty())
+            setEmbeds(embeds.stream().filter(e -> e.getType() == EmbedType.RICH).collect(Collectors.toList()));
         files.clear();
 
         components = new ArrayList<>();
@@ -185,7 +185,7 @@ public MessageActionImpl tts(final boolean isTTS)
     @CheckReturnValue
     public MessageActionImpl reset()
     {
-        return content(null).nonce(null).embed(null).tts(false).override(false).clearFiles();
+        return content(null).nonce(null).setEmbeds(Collections.emptyList()).tts(false).override(false).clearFiles();
     }
 
     @Nonnull
@@ -213,6 +213,7 @@ else if (content.length() <= Message.MAX_CONTENT_LENGTH)
 
     @Nonnull
     @Override
+    @Deprecated
     @CheckReturnValue
     public MessageActionImpl embed(final MessageEmbed embed)
     {
@@ -234,7 +235,7 @@ public MessageActionImpl embed(final MessageEmbed embed)
 
     @Nonnull
     @Override
-    public MessageAction setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
+    public MessageActionImpl setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
         Checks.noneNull(embeds, "MessageEmbeds");
         embeds.forEach(embed ->

From 83fe8cfb414c4cf4107340d5755c8cd0b79af964 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Thu, 10 Jun 2021 10:24:21 +0200
Subject: [PATCH 05/10] Update MessageBuilder

---
 .../net/dv8tion/jda/api/MessageBuilder.java   | 86 ++++++++++++++++---
 .../internal/entities/AbstractMessage.java    |  7 +-
 .../jda/internal/entities/DataMessage.java    | 18 ++--
 3 files changed, 83 insertions(+), 28 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
index d5aa346227..40f7836ce2 100644
--- a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
+++ b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
@@ -49,9 +49,9 @@ public class MessageBuilder implements Appendable
 {
     protected final StringBuilder builder = new StringBuilder();
 
+    protected final List<MessageEmbed> embeds = new ArrayList<>();
     protected boolean isTTS = false;
     protected String nonce;
-    protected MessageEmbed embed;
     protected List<ComponentLayout> components = new ArrayList<>();
     protected EnumSet<Message.MentionType> allowedMentions = null;
     protected Set<String> mentionedUsers = new HashSet<>();
@@ -72,8 +72,8 @@ public MessageBuilder(@Nullable Message message)
             isTTS = message.isTTS();
             builder.append(message.getContentRaw());
             List<MessageEmbed> embeds = message.getEmbeds();
-            if (embeds != null && !embeds.isEmpty() && embeds.get(0).getType() == EmbedType.RICH)
-                embed = embeds.get(0);
+            if (embeds != null)
+                embeds.stream().filter(it -> it.getType() == EmbedType.RICH).forEach(this.embeds::add);
             components.addAll(message.getActionRows());
             if (message instanceof DataMessage)
             {
@@ -93,7 +93,7 @@ public MessageBuilder(@Nullable MessageBuilder builder)
             this.isTTS = builder.isTTS;
             this.builder.append(builder.builder);
             this.nonce = builder.nonce;
-            this.embed = builder.embed;
+            this.embeds.addAll(builder.embeds);
             this.components.addAll(builder.components);
             if (builder.allowedMentions != null)
                 this.allowedMentions = Helpers.copyEnumSet(Message.MentionType.class, builder.allowedMentions);
@@ -105,12 +105,12 @@ public MessageBuilder(@Nullable MessageBuilder builder)
     public MessageBuilder(@Nullable EmbedBuilder builder)
     {
         if (builder != null)
-            this.embed = builder.build();
+            this.embeds.add(builder.build());
     }
 
     public MessageBuilder(@Nullable MessageEmbed embed)
     {
-        this.embed = embed;
+        this.embeds.add(embed);
     }
 
     /**
@@ -129,7 +129,7 @@ public MessageBuilder setTTS(boolean tts)
         this.isTTS = tts;
         return this;
     }
-    
+
     /**
      * Adds a {@link net.dv8tion.jda.api.entities.MessageEmbed} to the Message. Embeds can be built using
      * the {@link net.dv8tion.jda.api.EmbedBuilder} and offer specialized formatting.
@@ -138,11 +138,69 @@ public MessageBuilder setTTS(boolean tts)
      *         the embed to add, or null to remove
      *
      * @return The MessageBuilder instance. Useful for chaining.
+     *
+     * @deprecated Use {@link #setEmbeds(MessageEmbed...)} instead
      */
     @Nonnull
+    @Deprecated
+    @ForRemoval(deadline = "5.0.0")
+    @ReplaceWith("setEmbeds(embed)")
+    @DeprecatedSince("4.4.0")
     public MessageBuilder setEmbed(@Nullable MessageEmbed embed)
     {
-        this.embed = embed;
+        return setEmbeds(embed);
+    }
+
+    /**
+     * Adds up to 10 {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to the Message. Embeds can be built using
+     * the {@link net.dv8tion.jda.api.EmbedBuilder} and offer specialized formatting.
+     *
+     * @param  embeds
+     *         the embeds to add, or null to remove
+     *
+     * @throws java.lang.IllegalArgumentException
+     *         If any of the provided MessageEmbeds is not sendable according to {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
+     *         The sum of all {@link MessageEmbed#getLength()} must not be greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}!
+     *
+     * @return The MessageBuilder instance. Useful for chaining.
+     */
+    @Nonnull
+    public MessageBuilder setEmbeds(@Nullable MessageEmbed... embeds)
+    {
+        Checks.noneNull(embeds, "MessageEmbeds");
+        return setEmbeds(Arrays.asList(embeds));
+    }
+    
+    /**
+     * Adds up to 10 {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to the Message. Embeds can be built using
+     * the {@link net.dv8tion.jda.api.EmbedBuilder} and offer specialized formatting.
+     *
+     * @param  embeds
+     *         the embeds to add, or null to remove
+     *
+     * @throws java.lang.IllegalArgumentException
+     *         If any of the provided MessageEmbeds is not sendable according to {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
+     *         The sum of all {@link MessageEmbed#getLength()} must not be greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}!
+     *
+     * @return The MessageBuilder instance. Useful for chaining.
+     */
+    @Nonnull
+    public MessageBuilder setEmbeds(@Nullable Collection<? extends MessageEmbed> embeds)
+    {
+
+        this.embeds.clear();
+        if (embeds != null)
+        {
+            Checks.noneNull(embeds, "MessageEmbeds");
+            embeds.forEach(embed ->
+                Checks.check(embed.isSendable(),
+                    "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
+                    MessageEmbed.EMBED_MAX_LENGTH_BOT)
+            );
+            Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
+            Checks.check(embeds.stream().mapToInt(MessageEmbed::getLength).sum() <= MessageEmbed.EMBED_MAX_LENGTH_BOT, "The sum of all MessageEmbeds may not exceed %d!", MessageEmbed.EMBED_MAX_LENGTH_BOT);
+            this.embeds.addAll(embeds);
+        }
         return this;
     }
 
@@ -460,7 +518,7 @@ public int length()
      * @return whether the message contains content
      */
     public boolean isEmpty() {
-        return builder.length() == 0 && embed == null;
+        return builder.length() == 0 && embeds.isEmpty();
     }
 
     /**
@@ -1023,7 +1081,7 @@ public StringBuilder getStringBuilder()
     @Nonnull
     public MessageBuilder clear() {
         this.builder.setLength(0);
-        this.embed = null;
+        this.embeds.clear();
         this.isTTS = false;
         return this;
     }
@@ -1212,7 +1270,7 @@ public MessageAction sendTo(@Nonnull MessageChannel channel)
         }
         final Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(channel.getId());
         final MessageActionImpl action = new MessageActionImpl(channel.getJDA(), route, channel, builder);
-        return action.tts(isTTS).setEmbeds(embed).nonce(nonce);
+        return action.tts(isTTS).setEmbeds(embeds).nonce(nonce);
     }
 
     /**
@@ -1241,7 +1299,7 @@ public Message build()
             throw new IllegalStateException("Cannot build a Message with more than 2000 characters. Please limit your input.");
 
         String[] ids = new String[0];
-        return new DataMessage(isTTS, message, nonce, embed,
+        return new DataMessage(isTTS, message, nonce, embeds,
                 allowedMentions, mentionedUsers.toArray(ids), mentionedRoles.toArray(ids), components.toArray(new ComponentLayout[0]));
     }
 
@@ -1302,9 +1360,9 @@ public Queue<Message> buildAll(@Nullable SplitPolicy... policy)
             messages.add(build(currentBeginIndex, builder.length() - 1));
         }
 
-        if (this.embed != null)
+        if (this.embeds != null)
         {
-            ((DataMessage) messages.get(messages.size() - 1)).setEmbed(embed);
+            ((DataMessage) messages.get(messages.size() - 1)).setEmbeds(embeds);
         }
 
         return messages;
diff --git a/src/main/java/net/dv8tion/jda/internal/entities/AbstractMessage.java b/src/main/java/net/dv8tion/jda/internal/entities/AbstractMessage.java
index 744649e974..c64947c953 100644
--- a/src/main/java/net/dv8tion/jda/internal/entities/AbstractMessage.java
+++ b/src/main/java/net/dv8tion/jda/internal/entities/AbstractMessage.java
@@ -30,10 +30,7 @@
 import java.io.IOException;
 import java.io.UncheckedIOException;
 import java.time.OffsetDateTime;
-import java.util.EnumSet;
-import java.util.FormattableFlags;
-import java.util.Formatter;
-import java.util.List;
+import java.util.*;
 
 public abstract class AbstractMessage implements Message
 {
@@ -387,7 +384,7 @@ public MessageAction editMessage(@Nonnull CharSequence newContent)
 
     @Nonnull
     @Override
-    public MessageAction editMessage(@Nonnull MessageEmbed newContent)
+    public MessageAction editMessageEmbeds(@Nonnull Collection<? extends MessageEmbed> newContent)
     {
         unsupported();
         return null;
diff --git a/src/main/java/net/dv8tion/jda/internal/entities/DataMessage.java b/src/main/java/net/dv8tion/jda/internal/entities/DataMessage.java
index d5c3dfc17d..1147f48d7c 100644
--- a/src/main/java/net/dv8tion/jda/internal/entities/DataMessage.java
+++ b/src/main/java/net/dv8tion/jda/internal/entities/DataMessage.java
@@ -33,22 +33,22 @@ public class DataMessage extends AbstractMessage
     private final String[] mentionedRoles;
     private final String[] mentionedUsers;
     private final ComponentLayout[] components;
-    private MessageEmbed embed;
+    private Collection<? extends MessageEmbed> embeds;
 
-    public DataMessage(boolean tts, String content, String nonce, MessageEmbed embed,
+    public DataMessage(boolean tts, String content, String nonce, Collection<? extends MessageEmbed> embeds,
                        EnumSet<MentionType> allowedMentions, String[] mentionedUsers, String[] mentionedRoles, ComponentLayout[] components)
     {
         super(content, nonce, tts);
-        this.embed = embed;
+        this.embeds = embeds;
         this.allowedMentions = allowedMentions;
         this.mentionedUsers = mentionedUsers;
         this.mentionedRoles = mentionedRoles;
         this.components = components;
     }
 
-    public DataMessage(boolean tts, String content, String nonce, MessageEmbed embed)
+    public DataMessage(boolean tts, String content, String nonce, Collection<? extends MessageEmbed> embeds)
     {
-        this(tts, content, nonce, embed, null, new String[0], new String[0], new ComponentLayout[0]);
+        this(tts, content, nonce, embeds, null, new String[0], new String[0], new ComponentLayout[0]);
     }
 
     public EnumSet<MentionType> getAllowedMentions()
@@ -84,7 +84,7 @@ public boolean equals(Object o)
         return isTTS == other.isTTS
             && other.content.equals(content)
             && Objects.equals(other.nonce, nonce)
-            && Objects.equals(other.embed, embed);
+            && Objects.equals(other.embeds, embeds);
     }
 
     @Override
@@ -99,9 +99,9 @@ public String toString()
         return String.format("DataMessage(%.30s)", getContentRaw());
     }
 
-    public DataMessage setEmbed(MessageEmbed embed)
+    public DataMessage setEmbeds(Collection<? extends MessageEmbed> embeds)
     {
-        this.embed = embed;
+        this.embeds = embeds;
         return this;
     }
 
@@ -109,7 +109,7 @@ public DataMessage setEmbed(MessageEmbed embed)
     @Override
     public List<MessageEmbed> getEmbeds()
     {
-        return embed == null ? Collections.emptyList() : Collections.singletonList(embed);
+        return new ArrayList<>(embeds);
     }
 
     @Nonnull

From 842b57ee5d00d967e4c72c6d2e3ef02981fd0a33 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Thu, 10 Jun 2021 15:52:51 +0200
Subject: [PATCH 06/10] Add Message#replyEmbeds

---
 .../net/dv8tion/jda/api/entities/Message.java | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/src/main/java/net/dv8tion/jda/api/entities/Message.java b/src/main/java/net/dv8tion/jda/api/entities/Message.java
index 807df829c4..532a3b0483 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/Message.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/Message.java
@@ -1223,14 +1223,62 @@ default MessageAction reply(@Nonnull CharSequence content)
      * @return {@link MessageAction} Providing the {@link Message} created from this upload.
      *
      * @since  4.2.1
+     *
+     * @deprecated Use {@link #replyEmbeds(MessageEmbed...)} instead
      */
     @Nonnull
     @CheckReturnValue
+    @Deprecated
+    @ForRemoval(deadline = "5.0.0")
+    @ReplaceWith("replyEmbeds(content)")
+    @DeprecatedSince("4.4.0")
     default MessageAction reply(@Nonnull MessageEmbed content)
     {
         return getChannel().sendMessage(content).reference(this);
     }
 
+    /**
+     * Replies and references this message.
+     * <br>This is identical to {@code message.getChannel().sendMessageEmbeds(embeds).reference(message)}.
+     * You can use {@link MessageAction#mentionRepliedUser(boolean) mentionRepliedUser(false)} to not mention the author of the message.
+     * <br>By default there won't be any error thrown if the referenced message does not exist.
+     * This behavior can be changed with {@link MessageAction#failOnInvalidReply(boolean)}.
+     *
+     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
+     *
+     * @param  embeds
+     *         The content of the reply message
+     *
+     * @return {@link MessageAction} Providing the {@link Message} created from this upload.
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction replyEmbeds(@Nonnull MessageEmbed... embeds)
+    {
+        return getChannel().sendMessageEmbeds(embeds).reference(this);
+    }
+
+    /**
+     * Replies and references this message.
+     * <br>This is identical to {@code message.getChannel().sendMessageEmbeds(embeds).reference(message)}.
+     * You can use {@link MessageAction#mentionRepliedUser(boolean) mentionRepliedUser(false)} to not mention the author of the message.
+     * <br>By default there won't be any error thrown if the referenced message does not exist.
+     * This behavior can be changed with {@link MessageAction#failOnInvalidReply(boolean)}.
+     *
+     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
+     *
+     * @param  embeds
+     *         The content of the reply message
+     *
+     * @return {@link MessageAction} Providing the {@link Message} created from this upload.
+     */
+    @Nonnull
+    @CheckReturnValue
+    default MessageAction replyEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
+    {
+        return getChannel().sendMessageEmbeds(embeds).reference(this);
+    }
+
     /**
      * Replies and references this message.
      * <br>This is identical to {@code message.getChannel().sendMessage(content).reference(message)}.

From 95b2f5fd171010b1b54803dbf4675ee69e2a3165 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Thu, 10 Jun 2021 16:23:27 +0200
Subject: [PATCH 07/10] Use interaction endpoints in MessageAction when
 appropriate

---
 .../net/dv8tion/jda/api/MessageBuilder.java   |  2 +-
 .../net/dv8tion/jda/api/entities/Message.java |  3 +-
 .../jda/api/entities/MessageChannel.java      | 40 +++++---------
 .../jda/api/interactions/InteractionHook.java | 11 ++++
 .../jda/internal/entities/EntityBuilder.java  |  6 +--
 .../internal/entities/ReceivedMessage.java    | 18 +++++--
 .../interactions/InteractionHookImpl.java     |  4 +-
 .../restaction/MessageActionImpl.java         | 52 ++++++++++++++-----
 8 files changed, 84 insertions(+), 52 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
index 40f7836ce2..d88e1e964a 100644
--- a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
+++ b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
@@ -1269,7 +1269,7 @@ public MessageAction sendTo(@Nonnull MessageChannel channel)
                     throw new UnsupportedOperationException("Cannot send a private message between bots.");
         }
         final Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(channel.getId());
-        final MessageActionImpl action = new MessageActionImpl(channel.getJDA(), route, channel, builder);
+        final MessageActionImpl action = new MessageActionImpl(channel.getJDA(), null, channel, builder);
         return action.tts(isTTS).setEmbeds(embeds).nonce(nonce);
     }
 
diff --git a/src/main/java/net/dv8tion/jda/api/entities/Message.java b/src/main/java/net/dv8tion/jda/api/entities/Message.java
index 532a3b0483..927c331516 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/Message.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/Message.java
@@ -1255,7 +1255,8 @@ default MessageAction reply(@Nonnull MessageEmbed content)
     @CheckReturnValue
     default MessageAction replyEmbeds(@Nonnull MessageEmbed... embeds)
     {
-        return getChannel().sendMessageEmbeds(embeds).reference(this);
+        Checks.noneNull(embeds, "MessageEmbeds");
+        return replyEmbeds(Arrays.asList(embeds));
     }
 
     /**
diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
index 417b83c4f3..385783a3dc 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
@@ -315,11 +315,10 @@ default MessageAction sendMessage(@Nonnull CharSequence text)
         Checks.notEmpty(text, "Provided text for message");
         Checks.check(text.length() <= 2000, "Provided text for message must be less than 2000 characters in length");
 
-        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
         if (text instanceof StringBuilder)
-            return new MessageActionImpl(getJDA(), route, this, (StringBuilder) text);
+            return new MessageActionImpl(getJDA(), null, this, (StringBuilder) text);
         else
-            return new MessageActionImpl(getJDA(), route, this).append(text);
+            return new MessageActionImpl(getJDA(), null, this).append(text);
     }
 
     /**
@@ -416,8 +415,7 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
     {
         Checks.notNull(embed, "Provided embed");
 
-        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
-        return new MessageActionImpl(getJDA(), route, this).setEmbeds(embed);
+        return new MessageActionImpl(getJDA(), null, this).setEmbeds(embed);
     }
 
     /**
@@ -459,8 +457,7 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
     @CheckReturnValue
     default MessageAction sendMessageEmbeds(@Nonnull MessageEmbed... embeds)
     {
-        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
-        return new MessageActionImpl(getJDA(), route, this).setEmbeds(embeds);
+        return new MessageActionImpl(getJDA(), null, this).setEmbeds(embeds);
     }
 
     /**
@@ -502,8 +499,7 @@ default MessageAction sendMessageEmbeds(@Nonnull MessageEmbed... embeds)
     @CheckReturnValue
     default MessageAction sendMessageEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
-        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
-        return new MessageActionImpl(getJDA(), route, this).setEmbeds(embeds);
+        return new MessageActionImpl(getJDA(), null, this).setEmbeds(embeds);
     }
 
 
@@ -563,9 +559,7 @@ default MessageAction sendMessageEmbeds(@Nonnull Collection<? extends MessageEmb
     default MessageAction sendMessage(@Nonnull Message msg)
     {
         Checks.notNull(msg, "Message");
-
-        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
-        return new MessageActionImpl(getJDA(), route, this).apply(msg);
+        return new MessageActionImpl(getJDA(), null, this).apply(msg);
     }
 
     /**
@@ -623,7 +617,6 @@ default MessageAction sendMessage(@Nonnull Message msg)
     default MessageAction sendFile(@Nonnull File file, @Nonnull AttachmentOption... options)
     {
         Checks.notNull(file, "file");
-
         return sendFile(file, file.getName(), options);
     }
 
@@ -777,9 +770,7 @@ default MessageAction sendFile(@Nonnull InputStream data, @Nonnull String fileNa
     {
         Checks.notNull(data, "data InputStream");
         Checks.notNull(fileName, "fileName");
-
-        Route.CompiledRoute route = Route.Messages.SEND_MESSAGE.compile(getId());
-        return new MessageActionImpl(getJDA(), route, this).addFile(data, fileName, options);
+        return new MessageActionImpl(getJDA(), null, this).addFile(data, fileName, options);
     }
 
     /**
@@ -2731,12 +2722,10 @@ default MessageAction editMessageById(@Nonnull String messageId, @Nonnull CharSe
         Checks.isSnowflake(messageId, "Message ID");
         Checks.notEmpty(newContent, "Provided message content");
         Checks.check(newContent.length() <= 2000, "Provided newContent length must be 2000 or less characters.");
-
-        Route.CompiledRoute route = Route.Messages.EDIT_MESSAGE.compile(getId(), messageId);
         if (newContent instanceof StringBuilder)
-            return new MessageActionImpl(getJDA(), route, this, (StringBuilder) newContent);
+            return new MessageActionImpl(getJDA(), messageId, this, (StringBuilder) newContent);
         else
-            return new MessageActionImpl(getJDA(), route, this).append(newContent);
+            return new MessageActionImpl(getJDA(), messageId, this).append(newContent);
     }
 
     /**
@@ -2835,9 +2824,7 @@ default MessageAction editMessageById(@Nonnull String messageId, @Nonnull Messag
     {
         Checks.isSnowflake(messageId, "Message ID");
         Checks.notNull(newContent, "message");
-
-        Route.CompiledRoute route = Route.Messages.EDIT_MESSAGE.compile(getId(), messageId);
-        return new MessageActionImpl(getJDA(), route, this).apply(newContent);
+        return new MessageActionImpl(getJDA(), messageId, this).apply(newContent);
     }
 
     /**
@@ -3060,9 +3047,7 @@ default MessageAction editMessageById(@Nonnull String messageId, @Nonnull Messag
     {
         Checks.isSnowflake(messageId, "Message ID");
         Checks.notNull(newEmbed, "MessageEmbed");
-
-        Route.CompiledRoute route = Route.Messages.EDIT_MESSAGE.compile(getId(), messageId);
-        return new MessageActionImpl(getJDA(), route, this).setEmbeds(newEmbed);
+        return new MessageActionImpl(getJDA(), messageId, this).setEmbeds(newEmbed);
     }
 
     /**
@@ -3262,8 +3247,7 @@ default MessageAction editMessageEmbedsById(long messageId, @Nonnull MessageEmbe
     default MessageAction editMessageEmbedsById(@Nonnull String messageId, @Nonnull Collection<? extends MessageEmbed> newEmbeds)
     {
         Checks.isSnowflake(messageId, "Message ID");
-        Route.CompiledRoute route = Route.Messages.EDIT_MESSAGE.compile(getId(), messageId);
-        return new MessageActionImpl(getJDA(), route, this).setEmbeds(newEmbeds);
+        return new MessageActionImpl(getJDA(), messageId, this).setEmbeds(newEmbeds);
     }
 
     /**
diff --git a/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java b/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
index 815d403860..c053c2385a 100644
--- a/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
+++ b/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
@@ -32,6 +32,7 @@
 import javax.annotation.Nonnull;
 import java.io.File;
 import java.io.InputStream;
+import java.time.temporal.ChronoUnit;
 import java.util.Collection;
 
 /**
@@ -64,6 +65,16 @@ public interface InteractionHook extends WebhookClient<Message>
     @Nonnull
     Interaction getInteraction();
 
+    default long getExpirationTimestamp()
+    {
+        return getInteraction().getTimeCreated().plus(15, ChronoUnit.MINUTES).toEpochSecond() * 1000;
+    }
+
+    default boolean isExpired()
+    {
+        return System.currentTimeMillis() > getExpirationTimestamp();
+    }
+
     /**
      * Whether messages sent from this interaction hook should be ephemeral by default.
      * <br>This does not affect message updates, including deferred replies sent with {@link #sendMessage(String) sendMessage(...)} methods.
diff --git a/src/main/java/net/dv8tion/jda/internal/entities/EntityBuilder.java b/src/main/java/net/dv8tion/jda/internal/entities/EntityBuilder.java
index 6ed4677078..24d2766adc 100644
--- a/src/main/java/net/dv8tion/jda/internal/entities/EntityBuilder.java
+++ b/src/main/java/net/dv8tion/jda/internal/entities/EntityBuilder.java
@@ -26,10 +26,10 @@
 import net.dv8tion.jda.api.audit.AuditLogChange;
 import net.dv8tion.jda.api.audit.AuditLogEntry;
 import net.dv8tion.jda.api.entities.*;
-import net.dv8tion.jda.api.entities.Guild.VerificationLevel;
-import net.dv8tion.jda.api.entities.Guild.NotificationLevel;
 import net.dv8tion.jda.api.entities.Guild.ExplicitContentLevel;
+import net.dv8tion.jda.api.entities.Guild.NotificationLevel;
 import net.dv8tion.jda.api.entities.Guild.Timeout;
+import net.dv8tion.jda.api.entities.Guild.VerificationLevel;
 import net.dv8tion.jda.api.entities.MessageEmbed.*;
 import net.dv8tion.jda.api.entities.templates.Template;
 import net.dv8tion.jda.api.entities.templates.TemplateChannel;
@@ -1098,7 +1098,7 @@ public Message createMessage(DataObject jsonObject, boolean modifyCache)
 
         return createMessage(jsonObject, chan, modifyCache);
     }
-    public Message createMessage(DataObject jsonObject, @Nullable MessageChannel channel, boolean modifyCache)
+    public ReceivedMessage createMessage(DataObject jsonObject, @Nullable MessageChannel channel, boolean modifyCache)
     {
         long channelId = jsonObject.getUnsignedLong("channel_id");
         if (channel != null && channelId != channel.getIdLong())
diff --git a/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java b/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java
index 53312a050b..f1113abaaf 100644
--- a/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java
+++ b/src/main/java/net/dv8tion/jda/internal/entities/ReceivedMessage.java
@@ -22,6 +22,7 @@
 import net.dv8tion.jda.api.entities.*;
 import net.dv8tion.jda.api.exceptions.InsufficientPermissionException;
 import net.dv8tion.jda.api.exceptions.MissingAccessException;
+import net.dv8tion.jda.api.interactions.InteractionHook;
 import net.dv8tion.jda.api.interactions.components.ActionRow;
 import net.dv8tion.jda.api.requests.RestAction;
 import net.dv8tion.jda.api.requests.restaction.AuditableRestAction;
@@ -34,6 +35,7 @@
 import net.dv8tion.jda.internal.requests.CompletedRestAction;
 import net.dv8tion.jda.internal.requests.Route;
 import net.dv8tion.jda.internal.requests.restaction.AuditableRestActionImpl;
+import net.dv8tion.jda.internal.requests.restaction.MessageActionImpl;
 import net.dv8tion.jda.internal.utils.Checks;
 import org.apache.commons.collections4.Bag;
 import org.apache.commons.collections4.CollectionUtils;
@@ -72,6 +74,8 @@ public class ReceivedMessage extends AbstractMessage
     protected final TLongSet mentionedRoles;
     protected final int flags;
 
+    protected InteractionHook interactionHook = null; // late-init
+
     // LAZY EVALUATED
     protected String altContent = null;
     protected String strippedContent = null;
@@ -112,6 +116,12 @@ public ReceivedMessage(
         this.flags = flags;
     }
 
+    public ReceivedMessage withHook(InteractionHook hook)
+    {
+        this.interactionHook = hook;
+        return this;
+    }
+
     @Nonnull
     @Override
     public JDA getJDA()
@@ -798,7 +808,7 @@ public MessageActivity getActivity()
     public MessageAction editMessage(@Nonnull CharSequence newContent)
     {
         checkUser();
-        return channel.editMessageById(getId(), newContent);
+        return ((MessageActionImpl) channel.editMessageById(getId(), newContent)).withHook(interactionHook);
     }
 
     @Nonnull
@@ -806,7 +816,7 @@ public MessageAction editMessage(@Nonnull CharSequence newContent)
     public MessageAction editMessageEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
         checkUser();
-        return channel.editMessageEmbedsById(getId(), embeds);
+        return ((MessageActionImpl) channel.editMessageEmbedsById(getId(), embeds)).withHook(interactionHook);
     }
 
     @Nonnull
@@ -814,7 +824,7 @@ public MessageAction editMessageEmbeds(@Nonnull Collection<? extends MessageEmbe
     public MessageAction editMessageFormat(@Nonnull String format, @Nonnull Object... args)
     {
         checkUser();
-        return channel.editMessageFormatById(getId(), format, args);
+        return ((MessageActionImpl) channel.editMessageFormatById(getId(), format, args)).withHook(interactionHook);
     }
 
     @Nonnull
@@ -822,7 +832,7 @@ public MessageAction editMessageFormat(@Nonnull String format, @Nonnull Object..
     public MessageAction editMessage(@Nonnull Message newContent)
     {
         checkUser();
-        return channel.editMessageById(getIdLong(), newContent);
+        return ((MessageActionImpl) channel.editMessageById(getId(), newContent)).withHook(interactionHook);
     }
 
     private void checkUser()
diff --git a/src/main/java/net/dv8tion/jda/internal/interactions/InteractionHookImpl.java b/src/main/java/net/dv8tion/jda/internal/interactions/InteractionHookImpl.java
index bae6d255a0..6d0a2a8315 100644
--- a/src/main/java/net/dv8tion/jda/internal/interactions/InteractionHookImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/interactions/InteractionHookImpl.java
@@ -152,7 +152,7 @@ public WebhookMessageActionImpl<Message> sendRequest()
     {
         Route.CompiledRoute route = Route.Interactions.CREATE_FOLLOWUP.compile(getJDA().getSelfUser().getApplicationId(), interaction.getToken());
         route = route.withQueryParams("wait", "true");
-        Function<DataObject, Message> transform = (json) -> ((JDAImpl) api).getEntityBuilder().createMessage(json, getInteraction().getMessageChannel(), false);
+        Function<DataObject, Message> transform = (json) -> ((JDAImpl) api).getEntityBuilder().createMessage(json, getInteraction().getMessageChannel(), false).withHook(this);
         return onReady(new WebhookMessageActionImpl<>(getJDA(), interaction.getMessageChannel(), route, transform)).setEphemeral(ephemeral);
     }
 
@@ -164,7 +164,7 @@ public WebhookMessageUpdateActionImpl<Message> editRequest(String messageId)
             Checks.isSnowflake(messageId);
         Route.CompiledRoute route = Route.Interactions.EDIT_FOLLOWUP.compile(getJDA().getSelfUser().getApplicationId(), interaction.getToken(), messageId);
         route = route.withQueryParams("wait", "true");
-        Function<DataObject, Message> transform = (json) -> ((JDAImpl) api).getEntityBuilder().createMessage(json, getInteraction().getMessageChannel(), false);
+        Function<DataObject, Message> transform = (json) -> ((JDAImpl) api).getEntityBuilder().createMessage(json, getInteraction().getMessageChannel(), false).withHook(this);
         return onReady(new WebhookMessageUpdateActionImpl<>(getJDA(), route, transform));
     }
 
diff --git a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
index 6b26861dc7..4975a361d9 100644
--- a/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
+++ b/src/main/java/net/dv8tion/jda/internal/requests/restaction/MessageActionImpl.java
@@ -21,6 +21,7 @@
 import net.dv8tion.jda.api.entities.*;
 import net.dv8tion.jda.api.exceptions.InsufficientPermissionException;
 import net.dv8tion.jda.api.exceptions.MissingAccessException;
+import net.dv8tion.jda.api.interactions.InteractionHook;
 import net.dv8tion.jda.api.interactions.components.ActionRow;
 import net.dv8tion.jda.api.requests.Request;
 import net.dv8tion.jda.api.requests.Response;
@@ -28,7 +29,6 @@
 import net.dv8tion.jda.api.utils.AttachmentOption;
 import net.dv8tion.jda.api.utils.data.DataArray;
 import net.dv8tion.jda.api.utils.data.DataObject;
-import net.dv8tion.jda.internal.requests.Method;
 import net.dv8tion.jda.internal.requests.Requester;
 import net.dv8tion.jda.internal.requests.RestActionImpl;
 import net.dv8tion.jda.internal.requests.Route;
@@ -67,6 +67,9 @@ public class MessageActionImpl extends RestActionImpl<Message> implements Messag
     protected boolean failOnInvalidReply = defaultFailOnInvalidReply;
     protected long messageReference;
 
+    protected final String messageId;
+    private InteractionHook hook = null;
+
     public static void setDefaultFailOnInvalidReply(boolean fail)
     {
         defaultFailOnInvalidReply = fail;
@@ -77,20 +80,43 @@ public static boolean isDefaultFailOnInvalidReply()
         return defaultFailOnInvalidReply;
     }
 
-    public MessageActionImpl(JDA api, Route.CompiledRoute route, MessageChannel channel)
+    public MessageActionImpl(JDA api, String messageId, MessageChannel channel)
     {
-        super(api, route);
+        super(api, messageId != null
+            ? Route.Messages.EDIT_MESSAGE.compile(channel.getId(), messageId)
+            : Route.Messages.SEND_MESSAGE.compile(channel.getId()));
         this.content = new StringBuilder();
         this.channel = channel;
+        this.messageId = messageId;
     }
 
-    public MessageActionImpl(JDA api, Route.CompiledRoute route, MessageChannel channel, StringBuilder contentBuilder)
+    public MessageActionImpl(JDA api, String messageId, MessageChannel channel, StringBuilder contentBuilder)
     {
-        super(api, route);
+        super(api, messageId != null
+            ? Route.Messages.EDIT_MESSAGE.compile(channel.getId(), messageId)
+            : Route.Messages.SEND_MESSAGE.compile(channel.getId()));
         Checks.check(contentBuilder.length() <= Message.MAX_CONTENT_LENGTH,
             "Cannot build a Message with more than %d characters. Please limit your input.", Message.MAX_CONTENT_LENGTH);
         this.content = contentBuilder;
         this.channel = channel;
+        this.messageId = messageId;
+    }
+
+    public MessageActionImpl withHook(InteractionHook hook)
+    {
+        this.hook = hook;
+        return this;
+    }
+
+    @Override
+    protected Route.CompiledRoute finalizeRoute()
+    {
+        if (hook == null || hook.isExpired())
+            return super.finalizeRoute(); // Try as a normal bot message
+        if (isEdit()) // Try with interaction hook if its not expired, these have different rate limits and scale better
+            return Route.Interactions.EDIT_FOLLOWUP.compile(api.getSelfUser().getApplicationId(), hook.getInteraction().getToken(), messageId);
+        else
+            return Route.Interactions.CREATE_FOLLOWUP.compile(api.getSelfUser().getApplicationId(), hook.getInteraction().getToken());
     }
 
     @Nonnull
@@ -132,7 +158,7 @@ public boolean isEmpty()
     @Override
     public boolean isEdit()
     {
-        return finalizeRoute().getMethod() == Method.PATCH;
+        return messageId != null;
     }
 
     @Nonnull
@@ -165,7 +191,7 @@ public MessageActionImpl referenceById(long messageId)
 
     @Nonnull
     @Override
-    public MessageAction failOnInvalidReply(boolean fail)
+    public MessageActionImpl failOnInvalidReply(boolean fail)
     {
         failOnInvalidReply = fail;
         return this;
@@ -355,7 +381,7 @@ public MessageActionImpl clearFiles(@Nonnull Consumer<InputStream> finalizer)
 
     @Nonnull
     @Override
-    public MessageAction retainFilesById(@Nonnull Collection<String> ids)
+    public MessageActionImpl retainFilesById(@Nonnull Collection<String> ids)
     {
         if (!isEdit()) return this; // You can't retain files for messages that don't exist lol
         if (this.retainedAttachments == null)
@@ -389,7 +415,7 @@ public MessageActionImpl override(final boolean bool)
     @Nonnull
     @Override
     @SuppressWarnings("ResultOfMethodCallIgnored")
-    public MessageAction mentionRepliedUser(boolean mention)
+    public MessageActionImpl mentionRepliedUser(boolean mention)
     {
         allowedMentions.mentionRepliedUser(mention);
         return this;
@@ -398,7 +424,7 @@ public MessageAction mentionRepliedUser(boolean mention)
     @Nonnull
     @Override
     @SuppressWarnings("ResultOfMethodCallIgnored")
-    public MessageAction allowedMentions(@Nullable Collection<Message.MentionType> allowedMentions)
+    public MessageActionImpl allowedMentions(@Nullable Collection<Message.MentionType> allowedMentions)
     {
         this.allowedMentions.allowedMentions(allowedMentions);
         return this;
@@ -407,7 +433,7 @@ public MessageAction allowedMentions(@Nullable Collection<Message.MentionType> a
     @Nonnull
     @Override
     @SuppressWarnings("ResultOfMethodCallIgnored")
-    public MessageAction mention(@Nonnull IMentionable... mentions)
+    public MessageActionImpl mention(@Nonnull IMentionable... mentions)
     {
         this.allowedMentions.mention(mentions);
         return this;
@@ -416,7 +442,7 @@ public MessageAction mention(@Nonnull IMentionable... mentions)
     @Nonnull
     @Override
     @SuppressWarnings("ResultOfMethodCallIgnored")
-    public MessageAction mentionUsers(@Nonnull String... userIds)
+    public MessageActionImpl mentionUsers(@Nonnull String... userIds)
     {
         this.allowedMentions.mentionUsers(userIds);
         return this;
@@ -425,7 +451,7 @@ public MessageAction mentionUsers(@Nonnull String... userIds)
     @Nonnull
     @Override
     @SuppressWarnings("ResultOfMethodCallIgnored")
-    public MessageAction mentionRoles(@Nonnull String... roleIds)
+    public MessageActionImpl mentionRoles(@Nonnull String... roleIds)
     {
         this.allowedMentions.mentionRoles(roleIds);
         return this;

From 6d479f3a5cb3ad67d8f54711b50b164bb2688bf9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Tue, 15 Jun 2021 12:16:09 +0200
Subject: [PATCH 08/10] Add missing docs

---
 .../jda/api/interactions/InteractionHook.java   | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java b/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
index c053c2385a..1baa27c466 100644
--- a/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
+++ b/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
@@ -65,11 +65,28 @@ public interface InteractionHook extends WebhookClient<Message>
     @Nonnull
     Interaction getInteraction();
 
+    /**
+     * The unix millisecond timestamp for the expiration of this interaction hook.
+     * <br>An interaction hook expires after 15 minutes of its creation.
+     *
+     * @return The timestamp in millisecond precision
+     *
+     * @see    System#currentTimeMillis()
+     * @see    #isExpired()
+     */
     default long getExpirationTimestamp()
     {
         return getInteraction().getTimeCreated().plus(15, ChronoUnit.MINUTES).toEpochSecond() * 1000;
     }
 
+    /**
+     * Whether this interaction has expired.
+     * <br>An interaction hook is only valid for 15 minutes.
+     *
+     * @return True, if this interaction hook has expired
+     *
+     * @see    #getExpirationTimestamp()
+     */
     default boolean isExpired()
     {
         return System.currentTimeMillis() > getExpirationTimestamp();

From cf363cb8e3a878ffbb99ce9a33680581d1a30150 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Tue, 15 Jun 2021 12:41:15 +0200
Subject: [PATCH 09/10] Enforce one embed for send methods

---
 .../net/dv8tion/jda/api/MessageBuilder.java   | 33 +++++++++----------
 .../net/dv8tion/jda/api/entities/Message.java | 26 +++++++++++----
 .../jda/api/entities/MessageChannel.java      | 19 +++++++----
 3 files changed, 48 insertions(+), 30 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
index d88e1e964a..4af0855abe 100644
--- a/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
+++ b/src/main/java/net/dv8tion/jda/api/MessageBuilder.java
@@ -156,16 +156,16 @@ public MessageBuilder setEmbed(@Nullable MessageEmbed embed)
      * the {@link net.dv8tion.jda.api.EmbedBuilder} and offer specialized formatting.
      *
      * @param  embeds
-     *         the embeds to add, or null to remove
+     *         the embeds to add, or empty array to remove
      *
      * @throws java.lang.IllegalArgumentException
-     *         If any of the provided MessageEmbeds is not sendable according to {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
+     *         If any of the provided MessageEmbeds is null or not sendable according to {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
      *         The sum of all {@link MessageEmbed#getLength()} must not be greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}!
      *
      * @return The MessageBuilder instance. Useful for chaining.
      */
     @Nonnull
-    public MessageBuilder setEmbeds(@Nullable MessageEmbed... embeds)
+    public MessageBuilder setEmbeds(@Nonnull MessageEmbed... embeds)
     {
         Checks.noneNull(embeds, "MessageEmbeds");
         return setEmbeds(Arrays.asList(embeds));
@@ -176,31 +176,28 @@ public MessageBuilder setEmbeds(@Nullable MessageEmbed... embeds)
      * the {@link net.dv8tion.jda.api.EmbedBuilder} and offer specialized formatting.
      *
      * @param  embeds
-     *         the embeds to add, or null to remove
+     *         the embeds to add, or empty list to remove
      *
      * @throws java.lang.IllegalArgumentException
-     *         If any of the provided MessageEmbeds is not sendable according to {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
+     *         If any of the provided MessageEmbeds is null or not sendable according to {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() MessageEmbed.isSendable()}!
      *         The sum of all {@link MessageEmbed#getLength()} must not be greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}!
      *
      * @return The MessageBuilder instance. Useful for chaining.
      */
     @Nonnull
-    public MessageBuilder setEmbeds(@Nullable Collection<? extends MessageEmbed> embeds)
+    public MessageBuilder setEmbeds(@Nonnull Collection<? extends MessageEmbed> embeds)
     {
 
+        Checks.noneNull(embeds, "MessageEmbeds");
+        embeds.forEach(embed ->
+            Checks.check(embed.isSendable(),
+                "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
+                MessageEmbed.EMBED_MAX_LENGTH_BOT)
+        );
+        Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
+        Checks.check(embeds.stream().mapToInt(MessageEmbed::getLength).sum() <= MessageEmbed.EMBED_MAX_LENGTH_BOT, "The sum of all MessageEmbeds may not exceed %d!", MessageEmbed.EMBED_MAX_LENGTH_BOT);
         this.embeds.clear();
-        if (embeds != null)
-        {
-            Checks.noneNull(embeds, "MessageEmbeds");
-            embeds.forEach(embed ->
-                Checks.check(embed.isSendable(),
-                    "Provided Message contains an empty embed or an embed with a length greater than %d characters, which is the max for bot accounts!",
-                    MessageEmbed.EMBED_MAX_LENGTH_BOT)
-            );
-            Checks.check(embeds.size() <= 10, "Cannot have more than 10 embeds in a message!");
-            Checks.check(embeds.stream().mapToInt(MessageEmbed::getLength).sum() <= MessageEmbed.EMBED_MAX_LENGTH_BOT, "The sum of all MessageEmbeds may not exceed %d!", MessageEmbed.EMBED_MAX_LENGTH_BOT);
-            this.embeds.addAll(embeds);
-        }
+        this.embeds.addAll(embeds);
         return this;
     }
 
diff --git a/src/main/java/net/dv8tion/jda/api/entities/Message.java b/src/main/java/net/dv8tion/jda/api/entities/Message.java
index 927c331516..fa188c9589 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/Message.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/Message.java
@@ -1246,17 +1246,27 @@ default MessageAction reply(@Nonnull MessageEmbed content)
      *
      * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
      *
-     * @param  embeds
-     *         The content of the reply message
+     * @param  embed
+     *         The embed to reply with
+     * @param  other
+     *         Additional embeds to reply with
+     *
+     * @throws IllegalArgumentException
+     *         If null is provided, any of the embeds are not {@link MessageEmbed#isSendable() sendable}, more than 10 embeds are provided,
+     *         or the sum of {@link MessageEmbed#getLength()} is greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}
      *
      * @return {@link MessageAction} Providing the {@link Message} created from this upload.
      */
     @Nonnull
     @CheckReturnValue
-    default MessageAction replyEmbeds(@Nonnull MessageEmbed... embeds)
+    default MessageAction replyEmbeds(@Nonnull MessageEmbed embed, @Nonnull MessageEmbed... other)
     {
-        Checks.noneNull(embeds, "MessageEmbeds");
-        return replyEmbeds(Arrays.asList(embeds));
+        Checks.notNull(embed, "MessageEmbeds");
+        Checks.noneNull(other, "MessageEmbeds");
+        List<MessageEmbed> embeds = new ArrayList<>(1 + other.length);
+        embeds.add(embed);
+        Collections.addAll(embeds, other);
+        return replyEmbeds(embeds);
     }
 
     /**
@@ -1269,7 +1279,11 @@ default MessageAction replyEmbeds(@Nonnull MessageEmbed... embeds)
      * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
      *
      * @param  embeds
-     *         The content of the reply message
+     *         The embeds to reply with
+     *
+     * @throws IllegalArgumentException
+     *         If null is provided, any of the embeds are not {@link MessageEmbed#isSendable() sendable}, more than 10 embeds are provided,
+     *         or the sum of {@link MessageEmbed#getLength()} is greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}
      *
      * @return {@link MessageAction} Providing the {@link Message} created from this upload.
      */
diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
index 385783a3dc..9688c6a626 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
@@ -429,8 +429,10 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
      *
      * <p>For {@link net.dv8tion.jda.api.requests.ErrorResponse} information, refer to {@link #sendMessage(Message)}.
      *
-     * @param  embeds
-     *         the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to send
+     * @param  embed
+     *         The {@link MessageEmbed MessageEmbed} to send
+     * @param  other
+     *         Additional {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to send
      *
      * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
      *         If this is a {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and the logged in account does
@@ -441,8 +443,8 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
      *             <li>{@link net.dv8tion.jda.api.Permission#MESSAGE_EMBED_LINKS Permission.MESSAGE_EMBED_LINKS}</li>
      *         </ul>
      * @throws java.lang.IllegalArgumentException
-     *         If any of the provided embeds is {@code null} or if the provided {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbed}
-     *         is not {@link net.dv8tion.jda.api.entities.MessageEmbed#isSendable() sendable}
+     *         If null is provided, any of the embeds are not {@link MessageEmbed#isSendable() sendable}, more than 10 embeds are provided,
+     *         or the sum of {@link MessageEmbed#getLength()} is greater than {@link MessageEmbed#EMBED_MAX_LENGTH_BOT}
      * @throws java.lang.UnsupportedOperationException
      *         If this is a {@link net.dv8tion.jda.api.entities.PrivateChannel PrivateChannel}
      *         and both the currently logged in account and the target user are bots.
@@ -455,8 +457,13 @@ default MessageAction sendMessage(@Nonnull MessageEmbed embed)
      */
     @Nonnull
     @CheckReturnValue
-    default MessageAction sendMessageEmbeds(@Nonnull MessageEmbed... embeds)
+    default MessageAction sendMessageEmbeds(@Nonnull MessageEmbed embed, @Nonnull MessageEmbed... other)
     {
+        Checks.notNull(embed, "MessageEmbeds");
+        Checks.noneNull(other, "MessageEmbeds");
+        List<MessageEmbed> embeds = new ArrayList<>(1 + other.length);
+        embeds.add(embed);
+        Collections.addAll(embeds, other);
         return new MessageActionImpl(getJDA(), null, this).setEmbeds(embeds);
     }
 
@@ -472,7 +479,7 @@ default MessageAction sendMessageEmbeds(@Nonnull MessageEmbed... embeds)
      * <p>For {@link net.dv8tion.jda.api.requests.ErrorResponse} information, refer to {@link #sendMessage(Message)}.
      *
      * @param  embeds
-     *         the {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to send
+     *         The {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds} to send
      *
      * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
      *         If this is a {@link net.dv8tion.jda.api.entities.TextChannel TextChannel} and the logged in account does

From 97bd6cfb379287dfbd814a0c53cafa2f72a0d8b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Florian=20Spie=C3=9F?= <business@minnced.club>
Date: Tue, 15 Jun 2021 12:49:51 +0200
Subject: [PATCH 10/10] Fix javadoc errors

---
 src/main/java/net/dv8tion/jda/api/EmbedBuilder.java       | 2 +-
 src/main/java/net/dv8tion/jda/api/entities/Message.java   | 8 ++++----
 .../java/net/dv8tion/jda/api/entities/MessageChannel.java | 2 +-
 .../jda/api/requests/restaction/MessageAction.java        | 2 +-
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java b/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java
index 4f69a21bab..50aabe5ce5 100644
--- a/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java
+++ b/src/main/java/net/dv8tion/jda/api/EmbedBuilder.java
@@ -57,7 +57,7 @@ public class EmbedBuilder
 
     /**
      * Constructs a new EmbedBuilder instance, which can be used to create {@link net.dv8tion.jda.api.entities.MessageEmbed MessageEmbeds}.
-     * These can then be sent to a channel using {@link net.dv8tion.jda.api.entities.MessageChannel#sendMessageEmbeds(MessageEmbed...)}.
+     * These can then be sent to a channel using {@link net.dv8tion.jda.api.entities.MessageChannel#sendMessageEmbeds(MessageEmbed, MessageEmbed...)}.
      * <br>Every part of an embed can be removed or cleared by providing {@code null} to the setter method.
      */
     public EmbedBuilder() { }
diff --git a/src/main/java/net/dv8tion/jda/api/entities/Message.java b/src/main/java/net/dv8tion/jda/api/entities/Message.java
index fa188c9589..bec743fb14 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/Message.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/Message.java
@@ -1215,7 +1215,7 @@ default MessageAction reply(@Nonnull CharSequence content)
      * <br>By default there won't be any error thrown if the referenced message does not exist.
      * This behavior can be changed with {@link MessageAction#failOnInvalidReply(boolean)}.
      *
-     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
+     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed, MessageEmbed...)} and {@link MessageAction#reference(Message)}.
      *
      * @param  content
      *         The content of the reply message
@@ -1224,7 +1224,7 @@ default MessageAction reply(@Nonnull CharSequence content)
      *
      * @since  4.2.1
      *
-     * @deprecated Use {@link #replyEmbeds(MessageEmbed...)} instead
+     * @deprecated Use {@link #replyEmbeds(MessageEmbed, MessageEmbed...)} instead
      */
     @Nonnull
     @CheckReturnValue
@@ -1244,7 +1244,7 @@ default MessageAction reply(@Nonnull MessageEmbed content)
      * <br>By default there won't be any error thrown if the referenced message does not exist.
      * This behavior can be changed with {@link MessageAction#failOnInvalidReply(boolean)}.
      *
-     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
+     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed, MessageEmbed...)} and {@link MessageAction#reference(Message)}.
      *
      * @param  embed
      *         The embed to reply with
@@ -1276,7 +1276,7 @@ default MessageAction replyEmbeds(@Nonnull MessageEmbed embed, @Nonnull MessageE
      * <br>By default there won't be any error thrown if the referenced message does not exist.
      * This behavior can be changed with {@link MessageAction#failOnInvalidReply(boolean)}.
      *
-     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed...)} and {@link MessageAction#reference(Message)}.
+     * <p>For further info, see {@link MessageChannel#sendMessageEmbeds(MessageEmbed, MessageEmbed...)} and {@link MessageAction#reference(Message)}.
      *
      * @param  embeds
      *         The embeds to reply with
diff --git a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
index 9688c6a626..40c26775b1 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/MessageChannel.java
@@ -403,7 +403,7 @@ default MessageAction sendMessageFormat(@Nonnull String format, @Nonnull Object.
      * @see    net.dv8tion.jda.api.MessageBuilder
      * @see    net.dv8tion.jda.api.EmbedBuilder
      * 
-     * @deprecated This is deprecated in favor of {@link #sendMessageEmbeds(MessageEmbed...)}
+     * @deprecated This is deprecated in favor of {@link #sendMessageEmbeds(MessageEmbed, MessageEmbed...)}
      */
     @Nonnull
     @CheckReturnValue
diff --git a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
index bba27d248b..72b91f1626 100644
--- a/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
+++ b/src/main/java/net/dv8tion/jda/api/requests/restaction/MessageAction.java
@@ -86,7 +86,7 @@
  * @see    Message#editMessageFormat(String, Object...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessage(Message)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessage(CharSequence)
- * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessageEmbeds(MessageEmbed...)
+ * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessageEmbeds(MessageEmbed, MessageEmbed...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendMessageFormat(String, Object...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendFile(File, AttachmentOption...)
  * @see    net.dv8tion.jda.api.entities.MessageChannel#sendFile(File, String, AttachmentOption...)