v3.12.0

[3.12.0] - 2023-08-10

This release brings ease-of-life changes, bug fixes, and new methods for interacting with the Discord API.

Interaction changes

When deferring modals, if the model was a response to a slash command, the modal will be deferred with DeferredChannelMessageWithSource ; opposed to DeferredUpdateMessage which now allows proper deferration of modals (im making that a term now :D).

Added

• #2644 Added ComponentBuilder component removal methods. (d5d7378)
• #2668 Added a method for sending silent audio frames on OpusEncodeStream. (59094d2)
• #2675 Added missing remove property to MemberRoleAudit. (5fb9152)
• #2720 Added role & attachment flags (a421715)
• #2723 Added missing properties to webhook implementation (2b8584d)
• #2729 Added new onboarding methods/properties (8cd4c1c)
• #2730 Added new ModifyCurrentApplication features (166d40f)
• #2749 Added support for setting custom status (b2820d5)

Fixed

• #2711 Fixed modifying guild resets preferred locale (12c50f2)
• #2713 Fixed some ReplyAsync methods missing MessageFlags parameter. (56769cb)
• #2714 Fixed disconnecting socket client not sending close code. (6bb3777)
• #2722 Fixed modal's DeferAsync implementation (5f580f6)
• #2726 Fixed global name not being passed to UserUpdated event (9dfd4d7)
• #2742 Fixed ModifyAsync attachments #2236 (0c12079)
• #2745 Fixed GetMessagesAsync with Direction.After not working as expected (c922497)

v3.11.0

[3.11.0] - 2023-6-27

This release adds the new username system support to Discord.Net, along with fixes and other minor changes.

Notes:

• InviteGuild was renamed to PartialGuild (#2619)

Added

• #2616 Added guild Onboarding support (3a8f76c)
• #2627 Added Audit Log Created gateway event support (dff6a57)
• #2645 Added Message property and UpdateAsync() to IModalInteraction (83dfa0c)
• #2648 Added MaxStageVideoChannelUsers property to IGuild (bdd755b)
• #2665 Added voice messages support (f171684)
• #2619 Added get current bot application information (9ef5a76)
• #2649 Added SafetyAlertsChannelId to IGuild (2112e1f)
• #2696 Added support for the new username system (df717e6)
• #2620 Added support for filtering audit log entries by after id (529fe3d)
• #2622 Added default thread ratelimit in guild text channels (f9c8530)

Fixed

• #2628 Allow creating stickers with no description (c950106)
• #2682 Fixed missing JsonProperty attributes in params for modifying automod rules (9df4438)
• #2702 Fixed TypingStartedEvent model to support Clyde (547bc92)
• #2652 Fixed streams being incorrectly disposed in DefaultRestClient (84431de)
• #2708 Fixed threads not getting removed from cache on THREAD_DELETE (fe4130d)
• #2688 Fixed some internal classes being public (9ddd922)
• #2687 Allow more than 1 action to be registered per automod rule (200bed7)
• #2683 Fixed mention limit, regex patterns & allowlist for automod rules (a41fa62)
• #2663 Fixed T3 file upload size to be 25MiB (98f974d)
• #2662 Fixed duplicate SlashCommandExecuted event on failed result (fe9657a)
• #2651 Fixed name translations (NameLocalizations) for ChoiceAttribute (75ae488)
• #2647 Fixed ChannelPermissions.All() exception on forums (6265dd5)
• #2642 Enforce rate limits on 429s (69cce5b)

Misc

• #2601 Add missing json error (a8ae1e9)
• #2609 Refactor SendMessageAsync & SendFile(s)Async methods & modify webhook message attachments (898ee56)
• #2646 Create forum channels with default layout (0720049)
• #2666 Switch channel to channel_id in interactions (d5ba7d2)
• #2670 Disable FEC in OPUS (2be9b00)

Thanks to the following contributors for this release

@Misha-133
@gehongyan
@CollinHerber
@kaskii
@TrustNoOneElse
@Cenngo
@cjbonn
@ben-reilly
@KubaZ2
@bsdayo
@AnalogFeelings
@ThePheggHerself
@MichaelMcCarthy117

v3.10.0

[3.10.0] - 2023-03-17

This release adds AutoMod support, support for webhooks in forums, text-in-stage support, and much more. Notably, this release also fixes issues with voice related to the changes to Discords voice API.

Added

• #2507 Added selects v2 support (48fb1b5)
• #2509 Added SendFileAsync to UserExtensions (25cfb88)
• #2510 Added missing invite guild properties & welcome screen support (7c535b9)
• #2520 Added ClientDisconnect event for audio client. (4cad546)
• #2521 Added OwnerId to IThreadChannel and RestThreadChannel
• #2521 Added ActiveDeveloper to UserProperies
• #2523 Added emojis from Emoji 13.0, Emoji 13.1 and Emoji 14.0 (23b2822)
• #2528 Added wildcard length quantifiers and TreatAsRegex property
• #2530 Added application Role Connections Metadata support (37d868f)
• #2531 Added age restricted (NSFW) application commands support (56b1a93)
• #2537 Added RemoveModulesFromGuildAsync (7acbcfd)
• #2560 Added app Command channel target permission (2616d35)
• #2562 Added new message types & error codes (a3ee855)
• #2564 Added RespondWithModal() which accepts an IModal instance as template (e7bda0f)
• #2571 Added guild member flags (7d8d6ec)
• #2573 Added missing VoiceChannel properties (1e21a6e)
• #2574 Added GetCurrentUser method to DiscordRestClient (e3da96f)
• #2574 Added GetCurrentUserGuildMemberAsync method to DiscordRestClient and RestGuild (e3da96f)
• #2574 Added GuildFeatures property to IUserGuild (e3da96f)
• #2575 Added Thread property to RestMessage (91e2084)
• #2578 Added AutoMod support (673b02d)
• #2579 Added Thread property to IUserMessage (0998285)
• #2580 Added thread user member & thread members pagination (b085621)
• #2582 Added IIntegrationChannel (75f3c91)
• #2582 Added support for creating webhooks in forums (75f3c91)
• #2590 Added FollowAnnouncementChannelAsync to INewsChannel (bb056df)
• #2591 Added support for silent mentions (2ea8af1)
• #2599 Added AddModalCommand to ModalBuilder with option to specify callback (50e0e59)
• #2605 Added GuildFeatures to GuildProperties (177df2c)
• #2603 Added support for creating forum posts with DiscordWebhookClient (e69e27a)
• #2610 Added Text-In-Stage support & missing IVoiceChannel properties (76bb901)
• #2613 Added AutoMod custom block message (709364a)
• #2615 Added missing invite properties (abfa8d1)

Fixed

• #2483 Fixed an NRE when event was changed from in channel to external or vice versa (493f604)
• #2526 Fixed GetActiveThreadsAsync & add it to ITextChannel (bd2f719)
• #2528 Fixed catastrophic backtracking (3b107c2)
• #2532 Fixed permissions on deleteMissing=false (274be5d)
• #2540 Fixed reason not being included in audit logs when calling AddBanAsync and BanAsync (e71faf7)
• #2541 Fixed CreatePost methods for IForumChannel (a53f1df)
• #2549 Fixed NullReferenceException caused by Options being undefined. (02d3ce6)
• #2557 Fixed customId template generator to escape regex metachars used in … (1602437)
• #2577 Fixed GetEventCoverImageUrl (0af835a)
• #2600 Fixed gateway deadlock (0c27395)
• #2606 Fixed AutoMod action executed event message being null (7b321af)

Misc

• #2542 Resolve inconsistencies with components (f224eb0)
• #2546 Argument handling with thread tags(c67642a)
• #2551 Format the project with 'dotnet format' (257f246)
• #2561 Remove outdated checks (94996e7)
• #2572 Reduce DateTime Boilerplate from LogMessage (14b2901)
• #2614 Optimize Add/RemoveRolesAsync methods (11481a1)
• #2617 Update IP discovery to send 74 bytes (66e6329)

v3.9.0

[3.9.0] - 2022-12-23

This release properly implements all forum features and fixes a major issue with socket connections. Additionally, TimestampTag has received a functionality revision, which may be cause for minor refactor when compiling against the new version.

Thanks to the following contributors for this release

• @Rozen4334
• @Misha-133
• @Quahu
• @MihaZupan
• @gehongyan
• @Trosclair
• @Cenngo
• @F0903
• @1NieR
• @Halbritter

Added

• #2469 Add missing properties in forum & thread channels (01ae904)
• #2501 Add new discord stuff (ed38635)
• #2521 Add missing property & new stuff (82b772a)
• #2520 Implemented ClientDisconnect event for audio client. (4cad546)
• #2509 Add SendFiles to UserExtensions ( 4cad546)
• #2528 Implement wildcard lenght quantifiers, TreatAsRegex property and solve catastrpohic backtracking (25cfb88)
• #2531 Add Age restricted (NSFW) application commands support (60956c7)

Fixed

• #2500 Fix duplicated members of DiscordErrorCode (6712ef4)
• #2468 Fix TimestampTag being sadge (bc89d3c)
• #2497 Avoid throwing on missing Application (7077c44)
• #2485 Fixed an oversight clearing session data upon any disconnect. (c7ac59d)
• #2526 Fix GetActiveThreadsAsync & add it to ITextChannel (bd2f719)
• #2535 Fix deploy.yml (20d8fdf)

Misc

• #2471 Update samples to use MessageContent intent & update v2 => v3 guide (a4d34f6)
• #2505 Update events.cs (ea039b8)
• #2467 Update license and icon nuspec props (11ed0ff)
• #2306 Command execution code rework & TypeConverters auto-scope fix (6869817)
• #2534 Fully qualify SlashCommandBuilder namespace ( 3b107c2)

v3.8.1

[3.8.1] - 2022-09-12

This release introduces bug fixes mainly targeting the ones related to App Command localizations. This release additionally changes the target API version of the library.

Thanks to the following contributers for this release

• @KubaZ2
• @Polybroo
• @Cenngo
• @Rozen4334
• @D-Kay6
• @akaJuliaan
• @SaculRennorb
• @d4n3436
• @Hampo
• @quinchs
• @essoperagma
• @Hampo

Added

• #2437 Added scheduled event types to AuditLog ActionTypes (fca9c6b)
• #2423 Added support for resume gateway url (d4c533a)

Fixed

• #2443 Fixed typos of word length (adf012d)
• #2438 Fixed http query symbol in ModifyWebhookMessageAsync (0aa381d)
• #2444 Fixed BulkOverwriteCommands NRE (9feb703)
• #2417 Fixed CommandService RemoveModuleMethod not removing modules (fca9c6b)
• #2345 Fixed EmbedBuilder.Length NRE (11ece4b)
• #2453 Fixed NRE on SlashCommandBuilder.Build method (5073afa)
• #2457 Fixed typo in SlashCommandBuilder.AddNameLocalizationMethod (1b01fed)

Misc

• #2462 Add additional checks for gateway event warnings (b45b152)
• #2448 Bump to Discord API V10 (fbc5ad4)
• #2451 Return a list instead of an array in GetModulePath and GetChoicePath methods (370bdfa)
• #2453 Update app commands regex and fix localization on app context commands (3dec99f)
• #2333 Update package logo (2b86a79)

v3.8.0

[3.8.0] - 2022-08-27

Upgrade Path

This version changes the method signature of every Get*ApplicationCommandsAsync method to feature two new parameters (withLocalizations, locale), see commit 39bbd29.
Additionally, the method signature of every Send* method of IRestClient now accepts a new requestHeaders parameter, custom implementations of IRestClient need to be updated.

Thanks to the following contributers for this release

• @wberdowski
• @Misha-133
• @Cenngo
• @IvMisticos
• @Rozen4334
• @CottageDwellingCat
• @zaanposni
• @SKProCH
• @Pusheon
• @LXGaming
• @d4n3436
• @gutyina70
• @BobVul
• @1NieR
• @KubaZ2
• @cpurules
• @gehongyan

Added

• #2384 Added support for the WEBHOOKS_UPDATED event (010e8e8)
• #2370 Add async callbacks for IModuleBase (503fa75)
• #2367 Added DeleteMessagesAsync for TIV and added remaining rate limit in client log (f178660)
• #2379 Added Max/Min length fields for ApplicationCommandOption (e551431)
• #2369 Added support for using RespondWithModalAsync<IModal>() without prior IModal declaration (500e7b4)
• #2347 Added Embed field comparison operators (89a8ea1)
• #2359 Added support for creating lottie stickers (32b03c8)
• #2395 Added App Command localization support and ILocalizationManager to IF (39bbd29)

Fixed

• #2425 Fix missing Fact attribute in ColorTests (92215b1)
• #2424 Fix IGuild.GetBansAsync() (b7b7964)
• #2416 Fix role icon & emoji assignment (b6b5e95)
• #2414 Fix NRE on RestCommandBase Data (02bc3b7)
• #2421 Fix placeholder length being hardcoded (8dfe19f)
• #2352 Fix issues related to the absence of bot scope (1eb42c6)
• #2346 Fix IGuild.DisconnectAsync(IUser) not disconnecting users (ba02416)
• #2404 Fix range of issues presented by 3rd party analyzer (902326d)
• #2409 Removes GroupContext from requirecontext (b0b8167)

Misc

• #2366 Fixed typo in ChannelUpdatedEvent's documentation (cfd2662)
• #2408 Fix sharding sample throwing at appcommand registration (519deda)
• #2420 Fix broken code snippet in dependency injection docs (ddcf68a)
• #2430 Add a note about DontAutoRegisterAttribute (917118d)
• #2418 Update xmldocs to reflect the ConnectedUsers split (65b98f8)
• #2415 Adds missing DI entries in TOC (c49d483)
• #2407 Introduces high quality dependency injection documentation (6fdcf98)
• #2348 Added RequiredInput attribute to example in int.framework intro (ee6e0ad)
• #2385 Add ServerStarter.Host to deployment.md (06ed995)
• #2405 Add a note about IgnoreGroupNames to IF docs (cf25acd)
• #2356 Makes voice section about precompiled binaries more visible (e0d68d4 )
• #2405 IF intro docs improvements (246282d)
• #2406 Labs deprecation & readme/docs edits (bf493ea)

v3.7.2

[3.7.2] - 2022-06-02

Added

• #2328 Add method overloads to InteractionService (0fad3e8)
• #2336 Add support for attachments on interaction response type 7 (35db22e)
• #2338 AddOptions no longer has an uneeded restriction, added AddOptions to SlashCommandOptionBuilder (3a37f89)

Fixed

• #2342 Disable TIV restrictions for rollout of TIV (7adf516)

v3.7.1

[3.7.1] - 2022-5-27

This release fixes bugs with voice channel permissions and an NRE in GuildMemberUpdated

Added

• #2325 Add missing interaction properties (d3a693a)
• #2330 Add better call control in ParseHttpInteraction (a890de9)

Fixed

• #2329 Voice perms not retaining text perms. (712a4ae)
• #2331 NRE with Cacheable.DownloadAsync() (e1f9b76)

v3.7.0

[3.7.0] - 2022-05-24

This release brings with it Text-In-Voice channel support and Forum channel support as well as bug fixes.

Upgrade Path

Users has been changed to ConnectedUsers within voice channels. The Users property now gets all users who can view the channel rather than the connected users.

Thanks to the following contributors for this release

• @Almighty-Shogun
• @Cenngo
• @Misha-133
• @MJHeijster
• @moiph
• @nkpetko
• @openmilk
• @Rozen4334
• @sabihoshi
• @serkanyazicioglu
• @ShineSyndrome
• @SubZero0
• @Tripletri

Added

• #2269 Text-In-Voice (23656e8)
• #2281 Optional API calling to RestInteraction (a24dde4)
• #2283 Support FailIfNotExists on MessageReference (0ec8938)
• #2284 Add Parse & TryParse to EmbedBuilder & Add ToJsonString extension (cea59b5)
• #2289 Add UpdateAsync to SocketModal (b333de2)
• #2291 Webhook support for threads (b0a3b65)
• #2295 Add DefaultArchiveDuration to ITextChannel (1f01881)
• #2296 Add .With methods to ActionRowBuilder (13ccc7c)
• #2307 Add Nullable ComponentTypeConverter and TypeReader (6fbd396)
• #2316 Forum channels (7a07fd6)

Fixed

• #2290 Possible NRE in Sanitize (20ffa64)
• #2293 Application commands are disabled to everyone except admins by default (b465d60)
• #2299 Close-stage bucketId being null (725d255)
• #2313 Upload file size limit being incorrectly calculated (54a5af7)
• #2319 Use IDiscordClient.GetUserAsync impl in DiscordSocketClient (f47f319)
• #2320 NRE with bot scope and user parameters (88f6168)

v3.6.1

[3.6.1] - 2022-04-30

This release fixes a json Invalid Operation Exception when using the new permissions v2 system.

Added

• #2272 add 50080 Error code (503e720)

Fixed

• #2267 Permissions v2 Invalid Operation Exception (a8f6075)
• #2271 null user on interaction without bot scope (f2bb55e)
• #2274 Implement fix for Custom Id Segments NRE (0d74c5c)

Misc

• 3.6.0 (27226f0)