Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update dependency net.dv8tion:JDA to v5.0.0 #199

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update dependency net.dv8tion:JDA to v5.0.0 #199

wants to merge 1 commit into from

Conversation

renovate[bot]
Copy link
Contributor

@renovate renovate bot commented Oct 23, 2022 •
edited
Loading

Mend Renovate

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
net.dv8tion:JDA 5.0.0-alpha.17 -> 5.0.0 age adoption passing confidence

Warning

Some dependencies could not be looked up. Check the Dependency Dashboard for more information.

Release Notes

discord-jda/JDA (net.dv8tion:JDA)

v5.0.0: | End of beta phase

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 becomes SlashCommandInteractionEvent
  • ButtonClickEvent becomes ButtonInteractionEvent

Similarly, we've renamed component types slightly:

  • SelectionMenu is now StringSelectMenu, while adding a new EntitySelectMenu
  • 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.

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:

As well as more specific features or attributes of channels:

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:

MessageChannelUnion channel = event.getChannel();
channel.sendMessage("hello").queue();
if (channel.getType() == TEXT) {
  channel.asTextChannel().getManager().setTopic("test topic").queue();
}

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.

GuildMessageChannel channel = guild.getChannelById(GuildMessageChannel.class, 125227483518861312L);
channel.sendMessage("Hello general chat!").queue();

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, 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:

channel.sendMessage("Hello World")
  .setComponents(ActionRow.of(button1, button2))
  .setEmbeds(embed1, embed2)
  .setFiles(files)
  .queue();

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.

FileUpload file = FileUpload.fromData(new File("myFile.png"), "image.png")
  .setDescription("this is my alt text for screenreaders, allowing to make accessible images in your messages!");
channel.sendFiles(file).queue();

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:

These new emoji types replace the duplication of ReactionEmote and Activity.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 types
  • StickerItem, stickers found in messages
  • RichSticker, stickers with more information that is usually omitted for messages (sticker items)
  • StandardSticker, rich stickers provided by nitro instead of guilds
  • GuildSticker, rich stickers provided in guilds
  • StickerUnion, adding type casting

Learn 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

repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0")
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0</version> 
</dependency>

Changelog (5.0.0-beta.24 -> 5.0.0)

The changes since the latest beta release to this release.

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

Breaking Changes

Breaking changes since 4.4.0

Other Changes

Other noteworthy changes since 4.4.0

Bug Fixes

Bugs fixed since 4.4.0

v5.0.0-beta.24: | Bug fixes and entitlement types

Overview

This is a small bugfix release, including some missing features for premium app entitlements.

Additional Entitlement Features (#​2667)

This release adds support for test entitlements and consumed entitlements.

An entitlement can be consumed, marking it as already used. This can be useful for one-time entitlements, which are consumed on use.

public boolean hasEntitlement(long skuId, List<Entitlement> entitlements) {
  return entitlements.stream().anyMatch(e -> e.getSkuIdLong() == skuId && !e.isConsumed());
}
public void consumeEntitlement(long skuId, List<Entitlement> entitlements) {
  entitlements.stream()
    .filter(e -> e.getSkuIdLong() == skuId && !e.isConsumed())
    .findFirst()
    .ifPresent(entitlement -> entitlement.consume().queue());
}
New Features
Changes
Bug Fixes

Full Changelog: discord-jda/JDA@v5.0.0-beta.23...v5.0.0-beta.24

Installation
Gradle
repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0-beta.24")
}
Maven
<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0-beta.24</version> 
</dependency>

v5.0.0-beta.23: | Message Polls

Overview

This release includes an updated README, please let us know if you spot any issues with it!

Polls (#​2649)

Discord has recently released a new feature on their platform to start and vote in polls. These polls can now be sent in messages:

channel.sendMessage("Hello guys! Check my poll:")
  .setPoll(
    MessagePollData.builder("Which programming language is better?")
      .addAnswer("Java", Emoji.fromFormatted("<:java:1006323566314274856>"))
      .addAnswer("Kotlin", Emoji.fromFormatted("<:kotlin:295940257797636096>"))
      .build())
  .queue()

The poll automatically expires after a set duration, configurable in the MessagePollBuilder using setDuration. A poll can also be ended manually using endPoll or endPollById.

You can check the poll votes on a message using the new Message#getPoll:

MessagePoll poll = message.getPoll();
for (MessagePoll.Answer answer : poll.getAnswers()) {
  System.out.printf("Poll Answer %s has %d votes\n", answer.getText(), answer.getVotes());
}

[!NOTE]
The votes for polls are eventually consistent and need to be recounted after the poll ends. You can check whether the votes are validated using MessagePoll#isFinalizedVotes.

New Features
Changes
Bugs Fixes

Full Changelog: discord-jda/JDA@v5.0.0-beta.22...v5.0.0-beta.23

Installation
Gradle
repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0-beta.23")
}
Maven
<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0-beta.23</version> 
</dependency>

v5.0.0-beta.22: | Bulk ban, premium apps, bug fixes

Overview

This release adds some newer API features, like premium app subscriptions, bot banners, and bulk banning users.

Besides new features, this release also includes improved errors and bug fixes.

Premium App Subscriptions (#​2583)

If your bot is eligible for monetization, you can now use JDA to handle entitlements in interactions to restrict features. With event.replyWithPremiumRequired(), you can upsell a premium subscription to a user:

b306d1ccc7205d2291f4535f912a790e

Read more about entitlements and premium app subscriptions in the Discord Developer Docs.

Bulk Ban (#​2630)

You can now ban up to 200 users in one request using guild.ban(users, messageDeleteTimeframe).

This endpoint has a few quirks to keep in mind:

  • The BulkBanResponse includes failed users and banned users
  • If a user was already banned, they are in the failed users
  • If you don't have permissions to ban a user (higher role / owner), they also appear in failed users
  • The self user also appears in failed users
  • If all users "failed" you get an error response instead
New Features
Changes
Bug Fixes

Full Changelog: discord-jda/JDA@v5.0.0-beta.21...v5.0.0-beta.22

Installation
Gradle
repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0-beta.22")
}
Maven
<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0-beta.22</version> 
</dependency>

v5.0.0-beta.21: | Bug fixes and enforced nonce on messages

Overview

This release fixes a few bugs but also implements a new behavior on message sending.

With the new enforce nonce behavior, messages will no longer be duplicated due to timeouts or discord outages. This means, any message request will now send an automatically generated nonce. You can still set a custom nonce using setNonce, but you should make sure that this nonce is unique. If you previously relied on this setter, ensure that you are not sending duplicated nonce values.

New Features
Changes
Bug Fixes

Full Changelog: discord-jda/JDA@v5.0.0-beta.20...v5.0.0-beta.21

Installation
Gradle
repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0-beta.21")
}
Maven
<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0-beta.21</version> 
</dependency>

v5.0.0-beta.20: | Bug fixes and internal refactoring

Overview

With this release, we reworked a lot of internals related to how we cache channels. Ideally, you should not notice any difference.

New Features
Changes
Bug Fixes

Full Changelog: discord-jda/JDA@v5.0.0-beta.19...v5.0.0-beta.20

Installation
Gradle
repositories {
    mavenCentral()
}
dependencies {
    implementation("net.dv8tion:JDA:5.0.0-beta.20")
}
Maven
<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0-beta.20</version> 
</dependency>

v5.0.0-beta.19: | Bug fixes and voice channel status

Overview

Smaller release with some bug fixes and added support for voice channel status feature.

Voice Channel Status (#​2532)

Bots can now configure the voice channel status, shown when opening a voice channel in full screen mode. This works similarly to a channel topic, but can be configured by everyone who is currently connected to the channel.

The new VOICE_SET_STATUS permission indicates whether a user can change the channel status while they are connected. When a user is not connected to the channel, the MANAGE_CHANNEL permission is required instead (similar to topics).

Note that this feature might be replaced by a new "hang status" in the future, which would instead show on the user rather than the channel.

New Features
Changes

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

  • If you want to rebase/retry this PR, check this box

This PR has been generated by Mend Renovate. View repository job log here.

@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from c1ed193 to 6b91e6a Compare November 27, 2022 21:08
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-alpha.22 Update dependency net.dv8tion:JDA to v5.0.0-beta.1 Nov 27, 2022
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 6b91e6a to 58d3262 Compare December 8, 2022 16:57
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.1 Update dependency net.dv8tion:JDA to v5.0.0-beta.2 Dec 8, 2022
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 58d3262 to 8d34691 Compare March 16, 2023 21:58
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.2 Update dependency net.dv8tion:JDA to v5.0.0-beta.5 Mar 16, 2023
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.5 Update dependency net.dv8tion:JDA to v5.0.0-beta.6 Mar 22, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 8d34691 to 094a221 Compare March 22, 2023 23:29
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.6 Update dependency net.dv8tion:JDA to v5.0.0-beta.8 Apr 17, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 094a221 to 4f111ac Compare April 17, 2023 12:10
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 4f111ac to 4c8e0a9 Compare May 28, 2023 11:44
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.8 Update dependency net.dv8tion:JDA to v5.0.0-beta.9 May 28, 2023
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.9 Update dependency net.dv8tion:JDA to v5.0.0-beta.10 Jun 4, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 4c8e0a9 to b1d60b1 Compare June 4, 2023 16:33
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from b1d60b1 to 49cb23d Compare June 19, 2023 19:51
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.10 Update dependency net.dv8tion:JDA to v5.0.0-beta.11 Jun 19, 2023
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.11 Update dependency net.dv8tion:JDA to v5.0.0-beta.12 Jul 1, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 49cb23d to fbafb0a Compare July 1, 2023 18:47
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from fbafb0a to 89541c7 Compare August 6, 2023 16:07
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.12 Update dependency net.dv8tion:JDA to v5.0.0-beta.13 Aug 6, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 89541c7 to cab06b0 Compare September 29, 2023 16:52
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.13 Update dependency net.dv8tion:JDA to v5.0.0-beta.14 Sep 29, 2023
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.14 Update dependency net.dv8tion:JDA to v5.0.0-beta.15 Sep 30, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from cab06b0 to 318533d Compare September 30, 2023 18:31
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 318533d to d952341 Compare October 22, 2023 18:45
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.15 Update dependency net.dv8tion:JDA to v5.0.0-beta.16 Oct 22, 2023
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.16 Update dependency net.dv8tion:JDA to v5.0.0-beta.17 Oct 29, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from d952341 to 5031563 Compare October 29, 2023 16:03
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.17 Update dependency net.dv8tion:JDA to v5.0.0-beta.18 Nov 19, 2023
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 5031563 to 7d7f87f Compare November 19, 2023 12:59
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 7d7f87f to 7a275b3 Compare January 1, 2024 15:35
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.18 Update dependency net.dv8tion:JDA to v5.0.0-beta.19 Jan 1, 2024
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 7a275b3 to bec5d72 Compare January 21, 2024 13:21
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.19 Update dependency net.dv8tion:JDA to v5.0.0-beta.20 Jan 21, 2024
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from bec5d72 to 15ebee2 Compare March 10, 2024 19:49
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.20 Update dependency net.dv8tion:JDA to v5.0.0-beta.21 Mar 10, 2024
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 15ebee2 to 59b74b6 Compare April 6, 2024 23:03
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.21 Update dependency net.dv8tion:JDA to v5.0.0-beta.22 Apr 6, 2024
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 59b74b6 to b111841 Compare April 21, 2024 10:49
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.22 Update dependency net.dv8tion:JDA to v5.0.0-beta.23 Apr 21, 2024
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from b111841 to 3d6dfa2 Compare May 12, 2024 21:41
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.23 Update dependency net.dv8tion:JDA to v5.0.0-beta.24 May 12, 2024
@renovate renovate bot force-pushed the renovate/net.dv8tion-jda-5.x branch from 3d6dfa2 to 9f3688f Compare July 7, 2024 21:29
@renovate renovate bot changed the title Update dependency net.dv8tion:JDA to v5.0.0-beta.24 Update dependency net.dv8tion:JDA to v5.0.0 Jul 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

None yet
0 participants