Add Hierarchy to RestGuildUser

src/Discord.Net.Core/Discord.Net.Core.xml

@@ -10056,6 +10056,11 @@
                 Whether the user has passed the guild's Membership Screening requirements.
             </summary>
         </member>
+        <member name="P:Discord.IGuildUser.Hierarchy">
+            <summary>
+                Gets the users position within the role hierarchy.
+            </summary>
+        </member>
         <member name="M:Discord.IGuildUser.GetPermissions(Discord.IGuildChannel)">
             <summary>
                 Gets the level permissions granted to this user to a given channel.

src/Discord.Net.Core/Entities/Users/IGuildUser.cs

@@ -73,6 +73,11 @@ namespace Discord
         /// </summary>
         bool? IsPending { get; }
 
+        /// <summary>
+        ///     Gets the users position within the role hierarchy.
+        /// </summary>
+        int Hierarchy { get; }
+
         /// <summary>
         ///     Gets the level permissions granted to this user to a given channel.
         /// </summary>

src/Discord.Net.Rest/Discord.Net.Rest.xml

@@ -4711,6 +4711,9 @@
         <member name="P:Discord.Rest.RestGuildUser.IsPending">
             <inheritdoc />
         </member>
+        <member name="P:Discord.Rest.RestGuildUser.Hierarchy">
+            <inheritdoc />
+        </member>
         <member name="P:Discord.Rest.RestGuildUser.GuildPermissions">
             <inheritdoc />
             <exception cref="T:System.InvalidOperationException" accessor="get">Resolving permissions requires the parent guild to be downloaded.</exception>
@@ -4954,6 +4957,9 @@
         <member name="P:Discord.Rest.RestWebhookUser.Discord#IGuildUser#IsPending">
             <inheritdoc />
         </member>
+        <member name="P:Discord.Rest.RestWebhookUser.Discord#IGuildUser#Hierarchy">
+            <inheritdoc />
+        </member>
         <member name="P:Discord.Rest.RestWebhookUser.Discord#IGuildUser#GuildPermissions">
             <inheritdoc />
         </member>

src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs

@@ -31,6 +31,18 @@ namespace Discord.Rest
         public ulong GuildId => Guild.Id;
         /// <inheritdoc />
         public bool? IsPending { get; private set; }
+        /// <inheritdoc />
+        public int Hierarchy
+        {
+            get
+            {
+                if (Guild.OwnerId == Id)
+                    return int.MaxValue;
+
+                var orderedRoles = Guild.Roles.OrderByDescending(x => x.Position);
+                return orderedRoles.Where(x => RoleIds.Contains(x.Id)).Max(x => x.Position);
+            }
+        }
 
         /// <inheritdoc />
         /// <exception cref="InvalidOperationException" accessor="get">Resolving permissions requires the parent guild to be downloaded.</exception>

src/Discord.Net.Rest/Entities/Users/RestWebhookUser.cs

@@ -54,6 +54,8 @@ namespace Discord.Rest
         /// <inheritdoc />
         bool? IGuildUser.IsPending => null;
         /// <inheritdoc />
+        int IGuildUser.Hierarchy => 0;
+        /// <inheritdoc />
         GuildPermissions IGuildUser.GuildPermissions => GuildPermissions.Webhook;
 
         /// <inheritdoc />