discord-net/Discord.Net 2.3.0

v2.3.0

on GitHub

This release contains a lot of new features of the Discord API, general library fixes, and uses the new discord.com domain.

Thanks to the following for their contributions in this release:

• @NeKzor
• @Chris-Johnston
• @Joe4evr
• @moiph
• @BramEsendam
• @orchidalloy
• @MattTheDev

Upgrade Path

This is a minor release, and is compatible when recompiling from v2.2.0

It might break backward compatibility with older packages since a few methods got new parameters:

• Include role identifiers in PruneUsersAsync (a80e5ff)
• Add AllowedMentions to webhook SendMessageAsync and SendFileAsync (bd4516b)
• Add AllowedMentions to SendFileAsync in IMessageChannel types (ab32607)
• Add MessageReference to SendMessageAsync and SendFileAsync (e3850e1)

Added

• INVITE_CREATE and INVITE_DELETE events (1ab670b)
• Support reading multiple activities (421a0c1)
• Allow for inherited commands in modules (a51cdf6)
• Direction.Around to GetMessagesAsync (f2130f8)
• Gateway ratelimiter (ec673e1)
• MESSAGE_REACTION_REMOVE_EMOJI event and RemoveAllReactionsForEmoteAsync (a89f076)
• GetUsersAsync to SocketGuild (30b5a83)
• Gateway Intents (d5d10d3)
• Missing properties to IGuild and deprecate GuildEmbed (ec212b1)
• includeRoleIds parameter to PruneUsersAsync (a80e5ff)
• GetStreams to IAudioClient (1e012ac)
• Missing channel properties when creating new channels (2d80037)
• Missing application properties (including Teams) (10fcde0)
• "View Guild Insights" to GuildPermission (2592264)
• Inline replies (e3850e1)
• Send presence on Identify payload (25d5d36)
• Role tags (6a62c47)
• User public flags (c683b29)
• MessageFlags and AllowedMentions to message modify (225550d)
• IsPending property to IGuildUser (8b25c9b)
• Max bitrate value to SocketGuild (aacfea0)
• SearchUsersAsync to IGuild (57880de)
• Implement discord buckets to the ratelimiter (2f6c017)

Fixed

• Missing AddReactions permission for DM channels. (e40ca4a)
• Exception caused by missing SlowModeInterval property (468f826)
• Fixed AllowedMentions and AllowedMentionTypes (3325031)
• Missing AllowedMentions to SendFileAsync (ab32607)
• GuildEmbed.ChannelId as nullable per API documentation (971d519)
• Incomplete Ready, DownloadUsersAsync, and optimize AlwaysDownloadUsers (dc8c959)
• InvalidOperationException at MESSAGE_CREATE (bd4672a)
• Sending 2 requests instead of 1 to create a Guild role. (5430cc8)
• Not using the new domain name. (df8a0f7)
• Trim token before passing it to the authorization header (42ba372)
• Stop TaskCanceledException from bubbling up (b8fa464)
• Invite audit log without inviter (b95b95b)
• Missing AllowedMentions to webhooks (bd4516b)
• Cancel reconnection when 4014 (f396cd9)
• Voice overwrites and CategoryId remarks (43c8fc0)
• Check error 404 and return null for GetBanAsync (ae9fff6)
• Parse mentions from message payload (366ca9a)
• Do not update overwrite cache locally (3860da0)
• Invoke UserUpdated from GuildMemberUpdated if needed (3085e88)
• Handle null PreferredLocale in rare cases (c1d04b4)
• Update Invite and InviteMetadata properties (dd2e524)
• Missing OverwritePermissions (4b389f3)
• Limit amount of guilds for DownloadUsersAsync (084db25)
• Audio stream dispose (a2af985)
• Crosspost throwing InvalidOperationException (9134443)
• Emoji url encode (04389a4)
• SocketGuild.HasAllMembers is false if a user left a guild (47f571e)
• Possible NullReferenceException when receiving InvalidSession (5213916)
• Possible NullReferenceException when creating a SocketUserMessage (5ed01a3)
• Update webhook regex to support discord.com (7585789)
• CultureInvariant RegexOption to WebhookUrlRegex (e3925a7)

Misc

• MutualGuilds optimization (323a677)
• Updating comments for privileged intents (c42bfa6)
• Change ratelimit messages (47ed806)
• Update summary of SocketVoiceChannel.Users (e385c40)
• Changed VoiceRegions and related(5934c79)
• Remove redundant CreateGuildRoleParams (3df0539)
• Add minor tweaks to DiscordSocketConfig docs strings (2cd1880)
• Fix MaxWaitBetweenGuildAvailablesBeforeReady docs string (e31cdc7)
• Missing summary tag for GatewayIntents (3a10018)
• IMessage.Embeds docs remarks (a4d32d3)
• Resolve inheritdocs for IAttachment (9ea3291)
• Cleanup GatewayReconnectException docs (833ee42)
• Move bulk deletes remarks from <summary> to <remarks> (62539f0)