This issue tracks all changes during the development of v3.3.0 and links to appropriate resources collecting migration notes with API and behavior changes.

There is also a public project here that keeps track of everything related to v3.3.0 without the migration notes.

Documentation

• What's new in v3.3
• Migration notes

API changes

After 3.3.0-M1

• After Add support of stage channels and stage instance #1021 if you use custom Stores, you need to implement these when migrating to 3.3.0
  • Added to GatewayDataUpdater: onStageInstanceCreate, onStageInstanceUpdate, onStageInstanceDelete
  • Added to DataAccessor: getStageInstanceByChannelId
• Replace TextChannel with MessageChannel in MessageBulkDeleteEvent Replace TextChannel with MessageChannel in MessageBulkDeleteEvent #1089

After 3.3.0-M2

• Remove "internal" method modifyOwnNickname (GuildService, RestGuild)
  • Use modifyCurrentMember instead, returning an updated MemberData object
• ChannelService::suppressEmbeds was removed, it's no longer a Discord endpoint
• Upgrade to new Reactor Retry API
  • Migrate ResponseFunction.retryWhen(retryFactory) to ResponseFunction.retryWhen(Retry.withThrowable(retryFactory))
• Remove ClientException#isRetryContextStatusCode, no available replacement

After 3.3.0-RC1

• ThreadChannel#getParent methods now returns a Mono<TopLevelGuildChannel> object in order to support ForumChannel as a parent channel. Consider filtering or using Mono#ofType method to keep using TopLevelGuildMessageChannel if you ignore forum channels.

Behavior changes

• HTTP 500 errors max retries is now 10 (previously unlimited)

Development progress

3.3.0-M1

Pre-release including forward-merged changes from: v3.2.1 v3.2.2 v3.2.3 v3.2.4

As well as changes between b058afe...62b2abf (14 commits)

Full branch diff up to this point (3.2.x vs 3.3.x): 1cbcf41...62b2abf (107 commits)

Notable changes:

• Make breaking channel hierarchy changes #960
• Improved stage channel support (and stage instances) #954
• Threads Tracker #958
• Generalize init methods methods in list's encodings discord-json#128

3.3.0-M2

• Add OAuth2 module #1083
• Implement guild scheduled events #1134