Add support for Role Tags

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

@@ -19,6 +19,7 @@
 import net.dv8tion.jda.api.managers.RoleManager;
 import net.dv8tion.jda.api.requests.restaction.AuditableRestAction;
 import net.dv8tion.jda.api.requests.restaction.RoleAction;
+import net.dv8tion.jda.api.utils.data.DataObject;
 
 import javax.annotation.CheckReturnValue;
 import javax.annotation.Nonnull;
@@ -77,7 +78,10 @@ public interface Role extends IMentionable, IPermissionHolder, Comparable<Role>
 
     /**
      * Whether this {@link net.dv8tion.jda.api.entities.Role Role} is managed by an integration
+     * This is any role where the "This role is managed by an integration..." appears in the role list.
+     * Integration can be: Bot role, Booster role, or a connected partner account role.
      *
+     * @see Role#getRoleType()
      * @return True, if this {@link net.dv8tion.jda.api.entities.Role Role} is managed.
      */
     boolean isManaged();
@@ -97,6 +101,14 @@ public interface Role extends IMentionable, IPermissionHolder, Comparable<Role>
      */
     boolean isMentionable();
 
+    /**
+     * Return the type of role this is
+     * Typically used for finding what kind of managed/integration role this is.
+     *
+     * @return this role's type
+     */
+    RoleType getRoleType();
+
     /**
      * The {@code long} representation of the literal permissions that this {@link net.dv8tion.jda.api.entities.Role Role} has.
      * <br><b>NOTE:</b> these do not necessarily represent the permissions this role will have in a {@link GuildChannel GuildChannel}.
@@ -271,4 +283,51 @@ default RoleAction createCopy()
      */
     @Nonnull
     JDA getJDA();
+
+
+    /**
+     * Enum used to differentiate between the different types of Guild Roles.
+     */
+    enum RoleType
+    {
+        /**
+         * A basic, user-created role.
+         */
+        NORMAL,
+        /**
+         * A role created from a bot on join.
+         */
+        BOT,
+        /**
+         * A role created from a YouTube Member or Twitch Subscriber integration..\
+         */
+        INTEGRATION,
+        /**
+         * The Server Booster role.
+         */
+        BOOSTER,
+        /**
+         * Unknown RoleType.
+         */
+        UNKNOWN;
+
+        public static RoleType fromTags(DataObject tags) {
+            if(tags.hasKey("premium_subscriber"))
+            {
+                return RoleType.BOOSTER;
+            }
+            else if(tags.hasKey("bot_id"))
+            {
+                return RoleType.BOT;
+            }
+            else if(tags.hasKey("integration_id"))
+            {
+                return RoleType.INTEGRATION;
+            } else
+            {
+                return RoleType.UNKNOWN;
+            }
+        }
+    }
+
 }

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

@@ -1059,6 +1059,14 @@ public Role createRole(GuildImpl guild, DataObject roleJson, long guildId)
             .setHoisted(roleJson.getBoolean("hoist"))
             .setColor(color == 0 ? Role.DEFAULT_COLOR_RAW : color)
             .setMentionable(roleJson.getBoolean("mentionable"));
+        if(roleJson.hasKey("tags"))
+        {
+            role.setType(Role.RoleType.fromTags(roleJson.getObject("tags")));
+        }
+        else
+        {
+            role.setType(Role.RoleType.NORMAL);
+        }
         if (playbackCache)
             getJDA().getEventCache().playbackCache(EventCache.Type.ROLE, id);
         return role;

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

@@ -56,6 +56,7 @@ public class RoleImpl implements Role
     private boolean managed;
     private boolean hoisted;
     private boolean mentionable;
+    private RoleType roleType;
     private long rawPermissions;
     private int color;
     private int rawPosition;
@@ -116,6 +117,12 @@ public boolean isMentionable()
         return mentionable;
     }
 
+    @Override
+    public RoleType getRoleType()
+    {
+        return roleType;
+    }
+
     @Override
     public long getPermissionsRaw()
     {
@@ -368,6 +375,12 @@ public RoleImpl setMentionable(boolean mentionable)
         return this;
     }
 
+    public RoleImpl setType(RoleType roleType)
+    {
+        this.roleType = roleType;
+        return this;
+    }
+
     public RoleImpl setRawPermissions(long rawPermissions)
     {
         this.rawPermissions = rawPermissions;