Implement user banner & banner color

src/main/java/net/dv8tion/jda/api/entities/User.java

@@ -28,6 +28,7 @@
 import javax.annotation.CheckReturnValue;
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
+import java.awt.*;
 import java.util.Collection;
 import java.util.EnumSet;
 import java.util.List;
@@ -84,6 +85,11 @@ public interface User extends IMentionable
     String AVATAR_URL = "https://cdn.discordapp.com/avatars/%s/%s.%s";
     /** Template for {@link #getDefaultAvatarUrl()} */
     String DEFAULT_AVATAR_URL = "https://cdn.discordapp.com/embed/avatars/%s.png";
+    /** Template for {@link #getBannerUrl()} */
+    String BANNER_URL = "https://cdn.discordapp.com/banners/%s/%s.%s";
+
+    /** Used to keep consistency between color values used in the API */
+    int DEFAULT_ACCENT_COLOR_RAW = 0x1FFFFFFF; // java.awt.Color fills the MSB with FF, we just use 1F to provide better consistency
 
     /**
      * Creates a User instance which only wraps an ID.
@@ -220,6 +226,60 @@ default String getEffectiveAvatarUrl()
         return avatarUrl == null ? getDefaultAvatarUrl() : avatarUrl;
     }
 
+    /**
+     * The Discord Id for this user's banner image.
+     * If the user has not set a banner, this will return null.
+     * If the user has not been retrieved using {@link JDA#retrieveUserById(long)}, this will return null.
+     *
+     * @throws UnsupportedOperationException
+     *         If this User was created with {@link #fromId(long)}
+     *
+     * @return Possibly-null String containing the {@link net.dv8tion.jda.api.entities.User User} banner id.
+     */
+    @Nullable
+    String getBannerId();
+
+    /**
+     * The URL for the user's banner image.
+     * If the user has not set a banner, this will return null.
+     * If the user has not been retrieved using {@link JDA#retrieveUserById(long)}, this will return null.
+     *
+     * @throws UnsupportedOperationException
+     *         If this User was created with {@link #fromId(long)}
+     *
+     * @return Possibly-null String containing the {@link net.dv8tion.jda.api.entities.User User} banner url.
+     *
+     * @see User#BANNER_URL
+     */
+    @Nullable
+    default String getBannerUrl()
+    {
+        String bannerId = getBannerId();
+        return bannerId == null ? null : String.format(BANNER_URL, getId(), bannerId, bannerId.startsWith("a_") ? "gif" : "png");
+    }
+
+    /**
+     * The user's accent color.
+     * If the user has not set an accent color, this will return null. The automatically calculated color is not returned.
+     * The accent color is not shown in the client if the user has set a banner.
+     * Unless the user has been retrieved using {@link JDA#retrieveUserById(long)}, the accent color will be null.
+     *
+     * @throws UnsupportedOperationException
+     *         If this User was created with {@link #fromId(long)}
+     *
+     * @return Possibly-null {@link java.awt.Color} containing the {@link net.dv8tion.jda.api.entities.User User} accent color.
+     */
+    @Nullable
+    Color getAccentColor();
+
+    /**
+     * The raw RGB value of this user's accent color.
+     * <br>Defaults to {@link #DEFAULT_ACCENT_COLOR_RAW} if this user's banner color is not available.
+     *
+     * @return The raw RGB color value or default
+     */
+    int getAccentColorRaw();
+
     /**
      * The "tag" for this user
      * <p>This is the equivalent of calling {@link java.lang.String#format(String, Object...) String.format}("%#s", user)

src/main/java/net/dv8tion/jda/internal/entities/EntityBuilder.java

@@ -40,10 +40,7 @@
 import net.dv8tion.jda.api.events.guild.member.update.GuildMemberUpdateBoostTimeEvent;
 import net.dv8tion.jda.api.events.guild.member.update.GuildMemberUpdateNicknameEvent;
 import net.dv8tion.jda.api.events.guild.member.update.GuildMemberUpdatePendingEvent;
-import net.dv8tion.jda.api.events.user.update.UserUpdateAvatarEvent;
-import net.dv8tion.jda.api.events.user.update.UserUpdateDiscriminatorEvent;
-import net.dv8tion.jda.api.events.user.update.UserUpdateFlagsEvent;
-import net.dv8tion.jda.api.events.user.update.UserUpdateNameEvent;
+import net.dv8tion.jda.api.events.user.update.*;
 import net.dv8tion.jda.api.interactions.components.ActionRow;
 import net.dv8tion.jda.api.utils.cache.CacheFlag;
 import net.dv8tion.jda.api.utils.cache.CacheView;
@@ -60,11 +57,13 @@
 import org.slf4j.Logger;
 
 import javax.annotation.Nullable;
+import java.awt.*;
 import java.time.Instant;
 import java.time.OffsetDateTime;
 import java.time.format.DateTimeFormatter;
 import java.time.temporal.TemporalAccessor;
 import java.util.*;
+import java.util.List;
 import java.util.function.Function;
 import java.util.function.ToLongFunction;
 import java.util.function.UnaryOperator;
@@ -128,6 +127,8 @@ public SelfUser createSelfUser(DataObject self)
                 .setName(self.getString("username"))
                 .setDiscriminator(self.getString("discriminator"))
                 .setAvatarId(self.getString("avatar", null))
+                .setBannerId(self.getString("banner", null))
+                .setAccentColor(self.getInt("accent_color", User.DEFAULT_ACCENT_COLOR_RAW))
                 .setBot(self.getBoolean("bot"))
                 .setSystem(false);
 
@@ -337,6 +338,8 @@ public UserImpl createUser(DataObject user)
             userObj.setName(user.getString("username"))
                    .setDiscriminator(user.get("discriminator").toString())
                    .setAvatarId(user.getString("avatar", null))
+                   .setBannerId(user.getString("banner", null))
+                   .setAccentColor(user.getInt("accent_color", User.DEFAULT_ACCENT_COLOR_RAW))
                    .setBot(user.getBoolean("bot"))
                    .setSystem(user.getBoolean("system"))
                    .setFlags(user.getInt("public_flags", 0));
@@ -358,6 +361,11 @@ public void updateUser(UserImpl userObj, DataObject user)
         String newDiscriminator = user.get("discriminator").toString();
         String oldAvatar = userObj.getAvatarId();
         String newAvatar = user.getString("avatar", null);
+        String oldBanner = userObj.getBannerId();
+        String newBanner = user.hasKey("banner") ? user.getString("banner", null) : "";
+        // User.DEFAULT_ACCENT_COLOR_RAW = unset, -1 = unknown
+        int oldAccentColor = userObj.getAccentColorRaw();
+        int newAccentColor = user.hasKey("accent_color") ? user.getInt("accent_color", User.DEFAULT_ACCENT_COLOR_RAW) : -1;
         int oldFlags = userObj.getFlagsRaw();
         int newFlags = user.getInt("public_flags", 0);
 
@@ -390,13 +398,18 @@ public void updateUser(UserImpl userObj, DataObject user)
                     userObj, oldAvatar));
         }
 
+        if (!Objects.equals(oldBanner, newBanner) && !Objects.equals(newBanner, ""))
+        {
+            userObj.setBannerId(newBanner);
+        }
+        if (oldAccentColor != newAccentColor && newAccentColor != -1)
+        {
+            userObj.setAccentColor(newAccentColor);
+        }
+
         if (oldFlags != newFlags)
         {
             userObj.setFlags(newFlags);
-            jda.handleEvent(
-                    new UserUpdateFlagsEvent(
-                        jda, responseNumber,
-                        userObj, User.UserFlag.getFlags(oldFlags)));
         }
     }
 

src/main/java/net/dv8tion/jda/internal/entities/UserById.java

@@ -25,6 +25,7 @@
 
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
+import java.awt.*;
 import java.util.EnumSet;
 import java.util.List;
 
@@ -102,6 +103,29 @@ public String getAvatarId()
         return null;
     }
 
+    @Nullable
+    @Override
+    public String getBannerId()
+    {
+        unsupported();
+        return null;
+    }
+
+    @Nullable
+    @Override
+    public Color getAccentColor()
+    {
+        unsupported();
+        return null;
+    }
+
+    @Override
+    public int getAccentColorRaw()
+    {
+        unsupported();
+        return 0;
+    }
+
     @Nonnull
     @Override
     public String getDefaultAvatarId()

src/main/java/net/dv8tion/jda/internal/entities/UserImpl.java

@@ -29,6 +29,8 @@
 import net.dv8tion.jda.internal.utils.Helpers;
 
 import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
+import java.awt.*;
 import java.util.EnumSet;
 import java.util.FormattableFlags;
 import java.util.Formatter;
@@ -41,6 +43,8 @@ public class UserImpl extends UserById implements User
     protected short discriminator;
     protected String name;
     protected String avatarId;
+    protected String bannerId;
+    protected int accentColor;
     protected long privateChannel = 0L;
     protected boolean bot;
     protected boolean system;
@@ -73,6 +77,26 @@ public String getAvatarId()
         return avatarId;
     }
 
+    @Nullable
+    @Override
+    public String getBannerId()
+    {
+        return bannerId;
+    }
+
+    @Nullable
+    @Override
+    public Color getAccentColor()
+    {
+        return accentColor == User.DEFAULT_ACCENT_COLOR_RAW ? null : new Color(accentColor);
+    }
+
+    @Override
+    public int getAccentColorRaw()
+    {
+        return accentColor;
+    }
+
     @Nonnull
     @Override
     public String getDefaultAvatarId()
@@ -182,6 +206,18 @@ public UserImpl setAvatarId(String avatarId)
         return this;
     }
 
+    public UserImpl setBannerId(String bannerId)
+    {
+        this.bannerId = bannerId;
+        return this;
+    }
+
+    public UserImpl setAccentColor(int accentColor)
+    {
+        this.accentColor = accentColor;
+        return this;
+    }
+
     public UserImpl setPrivateChannel(PrivateChannel privateChannel)
     {
         if (privateChannel != null)