From e5dec95698d08b887f82463bc7b123e408051520 Mon Sep 17 00:00:00 2001
From: freya02 <41875020+freya022@users.noreply.github.com>
Date: Sun, 19 Oct 2025 10:57:42 +0200
Subject: [PATCH] Add note about default CV2 flag affecting utilities

---
 .../net/dv8tion/jda/api/utils/messages/MessageRequest.java   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/main/java/net/dv8tion/jda/api/utils/messages/MessageRequest.java b/src/main/java/net/dv8tion/jda/api/utils/messages/MessageRequest.java
index 4407902eac..36fefb5ed9 100644
--- a/src/main/java/net/dv8tion/jda/api/utils/messages/MessageRequest.java
+++ b/src/main/java/net/dv8tion/jda/api/utils/messages/MessageRequest.java
@@ -106,6 +106,11 @@ static void setDefaultMentionRepliedUser(boolean mention)
      *
      * <p>This can be overwritten with {@link #useComponentsV2(boolean)} on each builder instance.
      *
+     * <p><b>NOTE:</b> When enabled, be aware that messages which were built for "V1" content
+     * will cause errors if they don't explicitly disable their V2 flag.
+     * You should check if the helpers you use do set their flag appropriately,
+     * this includes your own utilities/replies as well as 3rd party libraries you may use.
+     *
      * @param  use
      *         {@code true} to enable V2 components by default, {@code false} to disabled them by default.
      */