v3.17.1

[3.17.1] - 2025-01-19

This minor release addresses the dependency issue brought in 3.17.0, fixes some bugs and features a few neat little additions.

Added

• #3056 Add IAutomodRule.MentionRaidProtectionEnabled (0e9caf3)
• #3052 Added Header and Subtext to the Format class (0174745)

Fixed

• #3057 Use 8.0.x dependencies for net6 support (50aa278)
• #3049 Task.Delay(0) => Task.CompletedTask (b5f5df0)
• #3014 An AddSlashCommand overload should be AddAutocompleteCommand in ModuleBuilder (35e8122)
• #3053 DiscordSocketClient.GetEntitlementsAsync requiring unused BaseDiscordClient parameter (d828cd8)

Misc

• #3046 Refactor & update member search v2 (36439b6)

New Contributors

• @BlyZeDev made their first contribution in #3052

Full Changelog: 3.17.0...3.17.1

v3.17.0

[3.17.0] - 2024-12-20

This release comes with added .NET9 target (and .NET8 for that matter).
And also fixed a number of issues and brings some new features aswell.

Important notice

This is probably going to be the last Discord.Net release coming out before a limited set of breaking changes gets introduced.
Due to Discord making breaking changes on their end, it's not always possible/sensible to hide or make workarounds for those; join our server to discuss this if you haven't already.

Added

• #3025 Build with .NET 9 SDK (164a289)

• #3032 Add net8.0 and net9.0 (d780d6c)

• #3033 Add net8.0 and net9.0 to the metapackage (93229f6)

• #3005 Add StickerId to REST and WebSocket Sticker audit log data classes (8a2ea4b)

• #3023 Scheduled event recurrence rule (b7208d4)

• #3024 Support sending voice messages (5904ecd)

• #3036 Support for multiple subscription tiers (79fade6)

• #3017 Add support for keyed services. (3017f6b)

Fixed

• #2974 rest client add webporxy config, keep the processing logic with WebSocketProvider (292f8c4)
• #3008 fix webhook ctor (433bdc2)
• #3015 Fixes incorrect cast of parameters in CommandBuilder (aaa8df9)
• #3028 Create a new scope when building interaction service modules if AutoServiceScopes = true (a1e50c4)
• #3035 NRE in message commands in user app contexts (c78296f)
• #3034 Entitlements starts_at is nullable (d5879c8)
• #3031 Interaction Service failing to create scopes with some DI providers (a884ad1)
• #3030 NRE on thread member creation without a guild user in the payload (96a8327)

Misc

• #3021 Expose channel type property on IChannel (8b92969)
• #3006 Add missing permissions (6b92cc2)
• #3007 Allow setting SuppressNotification in webhook client (682d87e)
• #3027 Eliminate the waste of checking arguments under the same conditions. (f644e68)
• #3037 add missing overwrite perms (d2d8d73)
• #3038 Clamp cache size (438e31e)

New Contributors

• @Spider570 made their first contribution in #3005
• @trueai-org made their first contribution in #2974
• @xin9le made their first contribution in #3027

Full Changelog: 3.16.0...3.17.0

v3.16.0

[3.16.0] - 2024-09-14

This release brings support for a number of API features and adds a few nice utilities :3

Added

• #2918 Message Forwards (c4d90cd)
• #2976 New interactions precondition attribute that supports app commands (1f252a3)
• #2978 Add Application Approximate User Install Count (47f98bc)
• #2987 Add guild profile banners (57eb906)
• #3002 Add subscriptions support (88ea2ed)
• #2994 Add more member flags (9b8c7b1)
• #2989 Add GetRoleAsync (466b491)
• #2986 Add StickFormat gif and animated guild icon (2aaa0fd)

Fixed

• #3001 StackOverflow in sharded clients (c53aac3)

Misc

• #2979 Create a (Discord)Color using a string (bc84b94)
• #2991 Minor optimization + make sure top level components are action rows (623a457)
• #2995 Use interaction method in InteractionModuleBase.DeleteOriginalResponse (f65d3ad)
• #2999 Option to dump gw payloads on errors (b87ec6e)

New Contributors

• @AHollowedHunter made their first contribution in #2978
• @Adrigorithm (mr.Wires) made their first contribution in #2979

Full Changelog: 3.15.3...3.16.0

v3.15.3

[3.15.3] - 2024-07-21

This release brings support for application owned custom emojis and fixes a number of bugs within the library.

Added

• #2963 Application Emojis (26bb789)
• [EXPERIMENTAL] #2931 Member search v2 (e18915a)
• #2952 add IsAvailable to GuildEmote (cb79f04)
• #2965 Add team member Role property (6e531a2)

Fixed

• #2958 crash when poll is null in RestMessageComponent (24c7605)
• #2962 incomplete validation when ChannelFlags.RequireTag is true (f5fdfb2)
• #2948 Fix IndexOf bug in CreateBucketId (ec0ba49)
• #2959 Fix automod related events in the sharded client (8b6be64)
• #2966 Fix CustomSticker.DeleteAsync() (359f6db)

Misc

• #2951 Update for the breaking change discord has made + v3 is cringe (8afea2c)
• #2953 longer polls (ae49794)
• #2956 Add missing role tags (6b691b1)
• #2957 Longer MaxCustomBlockMessageLength (bae7861)

New Contributors

• @TineTheUnc made their first contribution in #2948
• @itsCristianPro7 made their first contribution in #2962
• @Zaratusa made their first contribution in #2958
• @ForceFK made their first contribution in #2957

Full Changelog: 3.15.2...3.15.3

3.15.2

[3.15.2] - 2024-06-18

Fixed

• readded back empty AutocompleteAttribute ctor
• removed validation in Emote ctor

Full Changelog: 3.15.1...3.15.2

v3.15.1

[3.15.1] - 2024-06-18

This release brings some minor but useful additions and QoL changes. "It aint much but it's honest work"

Added

• #2942 Add purchase notification (9d92435)
• #2934 Add MessageCallData (21195a8)
• #2932 Config Bypass for CanSendResponse (9030a5b)
• #2933 Premium Buttons (531b5eb)
• #2941 Add UseExternalApps permission (f7f29d5)

Fixed

• #2927 Add missing PollProperties (a59f4ba)

Misc

• #2936 Public constructor for Emote (3be72a8)
• #2935 Generic autocomplete (35b102a)
• #2929 Enable nuget debug symbols. (aa424f6)

New Contributors

• @SquirrelKiev made their first contribution in #2929
• @WhyNot180 made their first contribution in #2932

Full Changelog: 3.15.0...3.15.1

v3.15.0

[3.15.0] - 2024-05-12

This release brings support for polls & related gateway events, new store features and a bunch of utility attributes for interaction & text command frameworks.

Important notes:

• We have deprecated MyGet feed. You can get nightly pacakges from our self-hosted feed or github packages.
• Our docs website moved to docs.discordnet.dev (from discordnet.dev)

Known Issues

• services.AddSingleton<InteractionService>(); may fail on this version, we are working on a fix. As a temporary solution do the following:

services.AddSingleton<IRestClientProvider>(x => x.GetRequiredService<DiscordSocketClient>());

replace DiscordSocketClient with DiscordShardedClient if you use one.

Added

• #2902 Polls (476ec06)
• #2898 Guild bans with seconds prune period (d1da2a0)
• #2903 Create RequireTeamAttribute (753724d)
• #2906 Create DoHierarchyCheckAttribute (1a5cba8)
• #2923 Create RequireRoleAttribute (5dadcb2)
• #2919 More store stuff (f9086d3)
• #2920 Add SocketInteraction.InteractionChannel (3054505)

Fixed

• #2910 RestDMChannel relies on recipient (13ea566)
• #2911 Don't rely on Guild for id (397a887)
• #2912 Don't depend on WebSocket for Interaction service (a2f624e)
• #2922 NRE with rest interactions & no api call (again) (83fdc89)
• #2924 Fix null error when using a SelectMenuBuilder constructor (93cb71a)

Misc

• #2905 Remove analyzer project & resolve some build warnings (7aab366)
• #2913 Replace generic exceptions. (54d2fe5)
• #2908 Support options in Rest's AddRoleAsync (b70e21b)
• #2914 .Distinct() roles(ids) in IGuildUser.ModifyAsync (27a0785)
• #2915 Improve bulk bans (f85bf9a)

New Contributors

• @Liege72 made their first contribution in #2894
• @ImNoOSRS made their first contribution in #2923

Full Changelog: 3.14.1...3.15.0

v3.14.0-v3.14.1

[3.14.1] - 2024-03-19

• Fix Discord.Net assembly version

[3.14.0] - 2024-03-19

This release brings a bunch of new Discord feature as well as some fixes.
This release also brings initial support for User Apps.
Interaction framework example for user app commands is available on our docs.

Deprecation notes

Due to deprecation of these properties in the API the following parts of the library were marked as Obsolete:

• IsEnabledInDm properties of application commands & their corresponding builders
• • ContextTypes should be used instead.
• EnabledInDmAttribute
• • CommandContextTypesAttribute should be used instead.
• IMessage.Interaction
• • IUserMessage.InteractionMetadata should be used istead.

Added

• #2849 Allow setting channel topic to null when creating channels (7c96844)
• #2832 Add Icon size parameter to GetGuildIconUrl CDN method (eb5678a)
• #2883 Initial user apps support (24a6978)
• #2881 Bulk ban support (03402cd)
• #2880 More banner support (4efe3be)
• #2858 Allow setting custom status with SetGameAsync (ee386b1)
• #2870 SentRequest event (fc2fc87)
• #2873 Voice reconnection and resuming (09680c5)
• #2879 Support setting banner on bot profiles (d0c0a56)

Fixed

• #2866 Allow switching voice channels without disconnecting (external clients only) (5a62ba1)
• #2857 Receiving voice packets (use system-assigned port) (1a16f4d)
• #2850 NRE in automod audit logs (1eb7a53)
• #2862 Fixed a bug when creating a SelectMenuBuilder from a SelectMenuComponent incorrectly set the CustomId (6870ac5)
• Incorrect ConnectionState of a DiscordSocketClient casted to IDiscordClient/BaseSocketClient (955fae0)
• #2867 InteractionService.AddModulesXAsync command duplication (2787db3)

Misc

• #2806 Update library dependencies (bfc8dc2)
• #2847 Remove some redundant notes & small updates (d0e9c8b)
• #2854 Refactor MaxBitrate and UploadLimit in GuildHelper (6256de4)
• #2869 Fix optional param being non-optional (fa51f0a)

v3.13.1

[3.13.1] - 2024-02-11

This release fixes a couple of bugs within the library and adds some new features.

Added

• #2804 Add Incident actions message types (178ff58)
• #2805 Add AppliedTags to DiscordWebhookClient.SendXAsync (d382e5c)
• #2700 Optional Aliasses, Summary and Remarks Properties to CommandAttribute (5a8582c)
• #2584 Log InteractionCommand execution exceptions in Wrapped Exception (0f0f3f7)
• #2827 44 (Add message type 44) (541571c)
• #2837 Allow creating announcement channels (f1777de)

Fixed

• #2801 Add null check in SelectMenuBuilder (b18cc31)
• #2813 Incorrect json model for Guild Scheduled Events (de4b6b9)
• #2800 Warning about missing intents not being logged (8227d70)
• #2818 GetEventCoverImageUrl throwing NRE in case event cover image is null (138e18c)

Misc

• #2807 Incorrect xmldoc (d234db7)
• #2823 Update sample projects & samples in docs (e2e8c0f)
• #2819 [2024] Very important changes (update licence & docs) (ff9b9b4)
• #2831 Add checks for whitespace-only strings in button builder (89efe0f)
• #2835 Additional select menu option validations (4d7e384)

v3.13.0

[3.13.0] - 2023-11-18

This release adds a bunch of new Discord features into the library, as well as fixes some bugs.

Added

• #2707 Added Super reactions support (9fd5c6c)
• #2725 Added Media channel support (e3cd340)
• #2753 Added additional Update/Modify Async Attachment's (ae275ab)
• #2769 Added missing parameters to RespondWithModalAsync methods and implement missing overloads (4e78aec)
• #2773 Added useful utility methods to ModalBuilder (8591de7)
• #2776 Added Select menu default values (ac274d4)
• #2777 Added Voice channel status support (8060dcf)
• #2781 Added premium subscriptions support (7723f61)
• #2782 Added Avatar decorations support (f64d9d6)
• #2784 Added App subscriptions additional support (a9a8da4)
• #2783 Added Guild incident actions (9b36df3)
• #2787 Added Embed ToJsonString & (Try)Parse (7b5c40a)
• #2791 Added Automod member profile moderation, new application fields, use clyde ai & guild invenory settings (699554a)
• #2792 Added create roles with icons (b45b774)
• #2796 Added clips support (poggers) (89bebc3)

Fixed

• #2758 Fixed Slash Command Localizations lost after AddCommandsToGuildAsync and deleteMissing = false (8d5022a)
• #2759 Fixed missing null checks in RoleConnectionProperties (ab3b30d)
• #2766 Fixed UpdateAsync Remove Attachment Bug (a668757)
• #2763 Fixed SocketKickAuditLogData User never having value (5cfec05)
• #2770 Fixed URL encode timestamps sent as query parameters (589c58a)
• #2774 Fixed some IDiscordClient methods are not properly implemented in clients (8baf913)
• #2789 Fixed multiline values in short TextInputs (33e8340)

Misc

• #2739 Remove some unnecessary async/await (86655a8)
• #2754 Replace Moq with NSubstitute for Mocking in GuildHelperTests (b988a18)
• #2765 Use Discord heartbeat interval in audio. (9cedfbc)
• #2771 Extract GetDisplayAvatarUrl in IUser (b1787d8)