You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
After almost 3 years of refactoring and polishing, the stabilization of JDA 5.0.0 is here. If you have been following along, not much has changed since the latest beta release.
If you have somehow avoided updating to a beta release since 2021, here is a list of the most noteworthy additions, changes, and bug fixes since 4.4.0.
You can also use our Migration Guide to help you update to the latest version of JDA 5. This guide also includes the most important changes you need to consider.
Interactions / Application Features
Discord has further improved the capabilities of applications with new types of interactions. This major release of JDA adds support for these features, coming with some restructuring to properly accomodate the new types.
We've renamed interaction events to a more consistent naming scheme:
What was previously called Component has now been renamed to ActionComponent and ItemComponent, allowing us to introduce Component as an abstraction over both Button and ActionRow (which is now a LayoutComponent). The new Component interface is now an abstraction over both ItemComponent and LayoutComponent.
We've refactored the channel types and usages in JDA to be more maintainable. Each type of channel now directly maps to a specific channel interface, unlike before where VoiceChannel was used for both stage and voice type channels.
Instead there are now concrete interfaces for each type, such as NewsChannel, StageChannel, ForumChannel, etc.
The channel type hierarchy has been further refined, by introducing higher level abstractions to represent the features of multiple channel types:
To properly maintain these many different channel types and make them easy to use, we've also introduced new union types to encompass multiple channels into a simple common union type. This replaces the old getTextChannel()/getVoiceChannel() getters on events with getChannel().asTextChannel(). However, you can also use the standard features of the unions directly. For instance, a MessageChannelUnion allows to send messages and these specialization methods:
Cache access has also seen some improvement, by introducing a new getChannelById(Class, long) method, allowing to just get a MessageChannel without worrying about the concrete type.
GuildMessageChannelchannel = guild.getChannelById(GuildMessageChannel.class, 125227483518861312L);
channel.sendMessage("Hello general chat!").queue();
We've refactored our message sending interfaces to be more consistent, by abstracting MessageAction, MessageBuilder, and ReplyAction into shared interfaces MessageCreateRequest and MessageEditRequest. This makes all message sending code consistent. We recommend to simply chain your builder-like code directly on send messages:
However, if you need to use builders, we've introduced MessageEditBuilder and MessageCreateBuilder to replace the old MessageBuilder utility. You can also now use SplitUtil to easily divide message content into multiple messages.
To support file descriptions and reduce the number of sendFile overloads, we've also introduced a new FileUpload type that unifies all attachments into a single type.
FileUploadfile = FileUpload.fromData(newFile("myFile.png"), "image.png")
.setDescription("this is my alt text for screenreaders, allowing to make accessible images in your messages!");
channel.sendFiles(file).queue();
Note that this changelog is a linear history of changes. This means some earlier changes have already been superseded or refined in more recent changes. This changelog is slightly compressed to remove unimportant changes, you can see the full list of commits here.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
The Long Awaited Stabilization
After almost 3 years of refactoring and polishing, the stabilization of JDA 5.0.0 is here. If you have been following along, not much has changed since the latest beta release.
If you have somehow avoided updating to a beta release since 2021, here is a list of the most noteworthy additions, changes, and bug fixes since 4.4.0.
You can also use our Migration Guide to help you update to the latest version of JDA 5. This guide also includes the most important changes you need to consider.
Interactions / Application Features
Discord has further improved the capabilities of applications with new types of interactions. This major release of JDA adds support for these features, coming with some restructuring to properly accomodate the new types.
We've renamed interaction events to a more consistent naming scheme:
SlashCommandEvent
becomesSlashCommandInteractionEvent
ButtonClickEvent
becomesButtonInteractionEvent
Similarly, we've renamed component types slightly:
SelectionMenu
is nowStringSelectMenu
, while adding a newEntitySelectMenu
Component
has now been renamed toActionComponent
andItemComponent
, allowing us to introduceComponent
as an abstraction over bothButton
andActionRow
(which is now aLayoutComponent
). The newComponent
interface is now an abstraction over bothItemComponent
andLayoutComponent
.To learn more about interactions in JDA 5, take a look at our Interactions Wiki Guide.
Channel Type Rework
We've refactored the channel types and usages in JDA to be more maintainable. Each type of channel now directly maps to a specific channel interface, unlike before where
VoiceChannel
was used for both stage and voice type channels.Instead there are now concrete interfaces for each type, such as
NewsChannel
,StageChannel
,ForumChannel
, etc.The channel type hierarchy has been further refined, by introducing higher level abstractions to represent the features of multiple channel types:
Channel
GuildChannel
MessageChannel
andGuildMessageChannel
AudioChannel
As well as more specific features or attributes of channels:
IPermissionContainer
IPositionableChannel
IThreadContainer
IWebhookContainer
To properly maintain these many different channel types and make them easy to use, we've also introduced new union types to encompass multiple channels into a simple common union type. This replaces the old
getTextChannel()
/getVoiceChannel()
getters on events withgetChannel().asTextChannel()
. However, you can also use the standard features of the unions directly. For instance, aMessageChannelUnion
allows to send messages and these specialization methods:Cache access has also seen some improvement, by introducing a new
getChannelById(Class, long)
method, allowing to just get aMessageChannel
without worrying about the concrete type.Learn more about the channel rework in Channel Rework.
Message Features
We've refactored our message sending interfaces to be more consistent, by abstracting
MessageAction
,MessageBuilder
, andReplyAction
into shared interfacesMessageCreateRequest
andMessageEditRequest
. This makes all message sending code consistent. We recommend to simply chain your builder-like code directly on send messages:However, if you need to use builders, we've introduced MessageEditBuilder and MessageCreateBuilder to replace the old
MessageBuilder
utility. You can also now useSplitUtil
to easily divide message content into multiple messages.To support file descriptions and reduce the number of sendFile overloads, we've also introduced a new
FileUpload
type that unifies all attachments into a single type.Learn more about the changes to message sending in Message Send/Edit Rework.
Emojis and Stickers
In JDA 5, we have decided to unify all emoji types into a consistent type structure:
Emoji
, a top-level interface representing all emoji as well as a type discriminator withEmoji#getType
UnicodeEmoji
, standard unicode emoji such as 🤔CustomEmoji
, custom emoji found in messages, like<:minn:245267426227388416>
RichCustomEmoji
, emoji with more information such as owner, accessible through the guild settings.EmojiUnion
, adding type casting for things likeMessageReaction#getEmoji
These new emoji types replace the duplication of
ReactionEmote
andActivity.Emoji
.Stickers have also been refactored in a similar way, making a clear distinction between stickers found in messages and guild settings:
Sticker
, a top-level abstraction of all sticker typesStickerItem
, stickers found in messagesRichSticker
, stickers with more information that is usually omitted for messages (sticker items)StandardSticker
, rich stickers provided by nitro instead of guildsGuildSticker
, rich stickers provided in guildsStickerUnion
, adding type castingLearn more about the changes to emojis and stickers in Sticker and Emoji Rework.
Installation
All future JDA releases will be distributed through maven central. You no longer need to use
jcenter()
in your dependency manager.Gradle
Maven
Changelog (5.0.0-beta.24 -> 5.0.0)
The changes since the latest beta release to this release.
UserSnowflake
subtypes in bulk ban methods #2689)Changelog (4.4.0 -> 5.0.0)
Note that this changelog is a linear history of changes. This means some earlier changes have already been superseded or refined in more recent changes. This changelog is slightly compressed to remove unimportant changes, you can see the full list of commits here.
Thank you all for contributing!
New Features
New feature additions since 4.4.0
SUPPRESS_NOTIFICATIONS
flag for message by @Mysterious-Dev in AddSUPPRESS_NOTIFICATIONS
flag for message #2393Breaking Changes
Breaking changes since 4.4.0
Other Changes
Other noteworthy changes since 4.4.0
toString
methods by @freya022 in ImprovetoString
methods #2273Bug Fixes
Bugs fixed since 4.4.0
This discussion was created from the release v5.0.0 | End of beta phase.
Beta Was this translation helpful? Give feedback.
All reactions