fix(deps): update dependency net.dv8tion:jda to v5.0.0-alpha.17 - autoclosed

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
net.dv8tion:JDA	5.0.0-alpha.9 -> 5.0.0-alpha.17

---

Release Notes

DV8FromTheWorld/JDA

v5.0.0-alpha.17

Compare Source

Fixes some issues regarding the handling of file attachments on messages.

• Fix to properly clean up resources in MessageAction, which would otherwise cause unwanted warnings
• Fix issue with interaction replies that make use of files
• Fix issue with retainFiles on interaction message edits

Installation

Gradle

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

Maven

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

v5.0.0-alpha.16

Compare Source

This fixes an issue where IMessageEditCallback#editMessage would not properly send the request to edit the message, and instead defer the edit.

Installation

Gradle

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

Maven

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

v5.0.0-alpha.15

Compare Source

This fixes the ClassCastException when a voice channel updated.

Installation

Gradle

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

Maven

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

v5.0.0-alpha.14

Compare Source

Overview

Breaking changes and text messages in voice channels!

Text in Voice (#​2072)

This release introduces the long awaited Text in Voice feature. Now you can use all your message related features in voice channels as well! Automatically works with interactions, messages, reactions, and all other features you could want!

Command Localization (#​2090)

Using command localization, you can provide customized translations for all your commands. Check the example: LocalizationExample

API v10 (#​2165)

Since the v9 API will be discontinued at the end of 2022, we have upgraded to the newer version 10. This comes with a few breaking changes:

• All edit requests with addFile calls (such as message.editMessage(...).addFile(...)), will now remove all current attachments on the message. To retain existing attachments, you are now required to also use retainFiles(...) with the existing attachments on the message.
• The introduction of GatewayIntent.MESSAGE_CONTENT. In order to use certain user-generated content in messages, you will now be required to explicitly enable this privileged intent. This includes:
  • getContentRaw, getContentDisplay, getContentStripped, and getMentions().getCustomEmojis()
  • getActionRows, and getButtons
  • getAttachments
  • getEmbeds

You will be presented with a warning, if you try using any of those methods without having the required intent enabled.

Attempting to access message content without GatewayIntent.MESSAGE_CONTENT.
Discord now requires to explicitly enable access to this using the MESSAGE_CONTENT intent.
Useful resources to learn more:
	- https://support-dev.discord.com/hc/en-us/articles/4404772028055-Message-Content-Privileged-Intent-FAQ
	- https://jda.wiki/using-jda/gateway-intents-and-member-cache-policy/
	- https://jda.wiki/using-jda/troubleshooting/#im-getting-closecode4014-disallowed-intents
Or suppress this warning if this is intentional with Message.suppressContentIntentWarning()

Channel Unions (#​2138)

We had a lot of repeated concrete type specializations, such as getTextChannel(), all over library. To address this duplication and to make the interface more consitent, we are introducing the concept of channel unions.

These channel unions, are abstracted types, which provide the same features as their respective name would suggest, while also allowing simple specialization using conversion methods.

An example union would be MessageChannelUnion, which is used by Message.getChannel(). This type provides all the methods a normal MessageChannel would, but also allows you to convert it to a more concrete type:

public void onMessageReceived(MessageReceivedEvent event) {
  MessageChannelUnion channel = event.getChannel();
  // Use normal message channel features
  channel.sendMessage("Hello, I received your message!").queue();
  // Specialized handling on concrete types
  if (channel.getType() == ChannelType.VOICE) {
    VoiceChannel vc = channel.asVoiceChannel(); // easy type conversion, just like casting, but with clear type information
    vc.getGuild().getAudioManager().openAudioConnection(vc);
  }
}

New Features

• Add JDABuilder#setEventPassthrough by @​freya022 in https://github.com/DV8FromTheWorld/JDA/pull/2014
• Application command localization by @​freya022 in https://github.com/DV8FromTheWorld/JDA/pull/2090
• Handle text in voice channels by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2072

Changes

• Introduce Channel Unions by @​DV8FromTheWorld in https://github.com/DV8FromTheWorld/JDA/pull/2138
• Add EmojiUnion by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2167
• Update to API version 10 by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2165

Bug Fixes

• Fix handling of empty emoji names by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2176
• Return ThreadChannelAction instead of RestAction on Message#createThreadChannel by @​Mitmocc in https://github.com/DV8FromTheWorld/JDA/pull/2171
• Make MessageType#deletable return an accurate value. by @​RedDaedalus in https://github.com/DV8FromTheWorld/JDA/pull/2160

Full Changelog: discord-jda/JDA@v5.0.0-alpha.13...v5.0.0-alpha.14

Installation

Gradle

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

Maven

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

v5.0.0-alpha.13

Compare Source

Overview

In this release, we have taken some time to rework the handling of Emoji and Stickers! This comes with a lot of breaking changes.

Guild Emote Renamed (#​2117)

Previously, all custom emoji were called Emote in JDA. This has been changed to be more consistent with the API naming convention of Custom Emoji. In that sense, we renamed Emote to RichCustomEmoji and made various changes all over the API to rename all occurrences of Emote with Emoji.

This also comes with some compatibility improvements! With this change, we now have a uniform representation of all emoji in the library. Every emoji now implements the Emoji interface and can be used interchangeably as such. For instance, the reactions used to have a specific type called ReactionEmote, which is now just replaced with Emoji allowing you to use them in buttons!

public void onMessageReactionAdd(MessageReactionAddEvent event) {
  event.getChannel().sendMessage("User reacted")
    .setActionRow(Button.primary("buttonid", event.getEmoji())) // <- replacement for getReactionEmote()
    .queue();
}

Stickers (#​2104)

In addition to the changes for emoji, we now have a full support for stickers! Bots can send up to 3 guild stickers in a message (but not in interactions). However, this is limited to only stickers from the same guild, so likely not useful to most bots.

This comes with support for:

• Creating/Updating/Deleting guild stickers
• Getting and sending stickers with messages
• Access to nitro sticker packs (not sending though)
• Full sticker event support

ChunkingFilter Breaking Change (#​2053)

Previously, when you did setChunkingFilter(ChunkingFilter.ALL), we would always cache every member of the guild for the full runtime. This has been changed now, allowing you to further configure the member cache policy in addition to chunking. Now, to chunk and cache all members of a guild, you can use setChunkingFilter(ChunkingFilter.ALL).setMemberCachePolicy(MemberCachePolicy.ALL).

This is a breaking change and affects anyone using ChunkingFilter.

Command Permissions (#​2113)

Discord made breaking changes to command permissions (aka Privileges). This means you can no longer configure the privileges of a command on a guild, without using oauth. Consequently, we updated our interface with breaking changes to address this.

Instead of using setDefaultEnabled(..) on your command and configuring a whitelist/blacklist of roles and users, you now have the ability to configure allowed permissions using setDefaultPermissions(...) and you can tell discord that a command is guild only with setGuildOnly(true).

However, you cannot configure this for individual subcommands, due to the way discord designed them.

Check out the SlashBotExample for some useful examples on how this works!

New Features

• Rework stickers by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2104
• Uniform representation of emoji by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2117
• Add Support for Application-Command Permissions V2 by @​Xirado in https://github.com/DV8FromTheWorld/JDA/pull/2113

Changes

• Changed addField String name and String Value to Nonnull by @​RealYusufIsmail in https://github.com/DV8FromTheWorld/JDA/pull/2133
• Do not ignore member cache policy when chunking is enabled by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2053

Bug Fixes

• Fix Message.Attachment#getProxy() by @​Xirado in https://github.com/DV8FromTheWorld/JDA/pull/2139
• Fix missing guild id when deleting guild stickers by @​CheesyGamer77 in https://github.com/DV8FromTheWorld/JDA/pull/2144
• Fix filterHidden in GuildImpl#getChannels by @​MineKing9534 in https://github.com/DV8FromTheWorld/JDA/pull/2151

Full Changelog: discord-jda/JDA@v5.0.0-alpha.12...v5.0.0-alpha.13

Installation

Gradle

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

Maven

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

v5.0.0-alpha.12

Compare Source

Overview

This release contains a few tiny changes to improve the codebase, such as:

• FileProxy for downloading images and files from discord (replacing Message.Attachments#download)
• FileUpload for uploading images and files to discord (will be used for Message and Sticker creation)
• Message#getMentions to replace all the mention handling in message and interactions. (Such as Message#getMentionedUsers)

Example Mentions Changes

Old:

List<TextChannel> channels = message.getMentionedChannels(); // only handles TextChannel mentions
List<User> users = message.getMentionedUsers();

New:

List<GuildChannel> channels = message.getMentions().getChannels(); // handles all channel mentions
List<MessageChannel> messageChannels = message.getMentions().getChannels(MessageChannel.class); // filter by class type
List<User> users = message.getMentions().getUsers();

New Features

• Add ImageProxy & FileProxy by @​freya022 in https://github.com/DV8FromTheWorld/JDA/pull/1955
• Add new message types for automod by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2116
• Add Message#getStartedThread and ThreadChannel#retrieveParentMessage by @​Almighty-Satan in https://github.com/DV8FromTheWorld/JDA/pull/2099
• Added getJumpUrl method to GenericMessageEvent by @​mufinlive in https://github.com/DV8FromTheWorld/JDA/pull/2124
• Add FileUpload class by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2120

Changes

• Remove manager instance cache by @​duncte123 in https://github.com/DV8FromTheWorld/JDA/pull/2106
• Message interface declutter: Message#getMentions() by @​DV8FromTheWorld in https://github.com/DV8FromTheWorld/JDA/pull/2015

Bug Fixes

• Fix broken context map config by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2110
• Improve check for GuildVoiceState#declineSpeaker by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2112
• Remove checks for archive durations by @​DerBanko in https://github.com/DV8FromTheWorld/JDA/pull/2127
• [Bugfix] retrieving public archived threads by @​Sanduhr32 in https://github.com/DV8FromTheWorld/JDA/pull/2115
• Fixed deadlock in JDABuilder#login and JDA#shutdown

Full Changelog: discord-jda/JDA@v5.0.0-alpha.11...v5.0.0-alpha.12

Installation

Gradle

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

Maven

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

v5.0.0-alpha.11

Compare Source

Overview

This release finally brings out modals! This includes a variety of constructs, but the key ones to be immediately aware of are:

• Modal
• TextInput
• ModalInteraction
• ModalInteractionEvent
• IModalCallback (replyModal(modal))

Modal Example

@​Override
public void onSlashCommandInteraction(@​Nonnull SlashCommandInteractionEvent event) {
    if (event.getName().equals("support")) {
        TextInput email = TextInput.create("email", "Email", TextInputStyle.SHORT)
                .setPlaceholder("Enter your E-mail")
                .setMinLength(10)
                .setMaxLength(100) // or setRequiredRange(10, 100)
                .build();

        TextInput body = TextInput.create("body", "Body", TextInputStyle.PARAGRAPH)
                .setPlaceholder("Your concerns go here")
                .setMinLength(30)
                .setMaxLength(1000)
                .build();

        Modal modal = Modal.create("support", "Support")
                .addActionRows(ActionRow.of(email), ActionRow.of(body))
                .build();

        event.replyModal(modal).queue();
    }
}

@​Override
public void onModalInteraction(@​Nonnull ModalInteractionEvent event) {
    if (event.getModalId().equals("support")) {
        String email = event.getValue("email").getAsString();
        String body = event.getValue("body").getAsString();

        createSupportTicket(email, body);

        event.reply("Thanks for your request!").setEphemeral(true).queue();
    }
}

New Features

• Add support for modals by @​Xirado in https://github.com/DV8FromTheWorld/JDA/pull/2024

Changes

• Fix typos in GatewayIntent Javadoc and contributing guidelines by @​CheesyGamer77 in https://github.com/DV8FromTheWorld/JDA/pull/2098
• prevent creating OptionData with OptionType#UNKNOWN by @​caneleex in https://github.com/DV8FromTheWorld/JDA/pull/2101

Bug Fixes

• Fix NewsChannel#getManager always returning null by @​CheesyGamer77 in https://github.com/DV8FromTheWorld/JDA/pull/2107

Removed

• [Breaking] Remove confusing permission override methods by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2067

Full Changelog: discord-jda/JDA@v5.0.0-alpha.10...v5.0.0-alpha.11

Installation

Gradle

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

Maven

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

v5.0.0-alpha.10

Compare Source

Overview

UserSnowflake

We changed User.fromId to now return UserSnowflake instead of User. This is done to prevent users from attempting code such as User.fromId(123).openPrivateChannel() which would never work.

With this we also changed some methods to no longer accept raw IDs as long and String. Instead you can now use method(User.fromId(long/String)), ie. ban(User.fromId(1234)).

Removed Methods:

• Guild#ban(long/String), Guild#ban(long/String, int), Guild#ban(long/String, int, String)
• Guild#kick(long/String), Guild#kick(long/String, String)
• Guild#unban(long/String)
• Guild#retrieveBanById(long/String)
• Guild#addMember(String, long/String)
• Guild#timeoutForById(long/String, Duration)
• Guild#timeoutUntilById(long/String, TemporalAccessor)
• Guild#removeTimeoutById(long/String)
• Guild#addRoleToMember(long/String, Role)
• Guild#removeRoleFromMember(long/String, Role)
• AuditLogPaginationAction#user(long/String)

New Features

• Add Tags, Default Install Url, Scopes and Permissions to ApplicationInfo by @​Xirado in https://github.com/DV8FromTheWorld/JDA/pull/1936
• Add UserSnowflake and improve User#fromId by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2065
• Add CommandInteractionPayload#isGuildCommand by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2091
• Implement pagination for the guild ban list by @​RedDaedalus in https://github.com/DV8FromTheWorld/JDA/pull/2076
• Replace magic embed count number to constant by @​Tais993 in https://github.com/DV8FromTheWorld/JDA/pull/2048
• Add required & autoComplete in Command.Option to equals() & hashCode() by @​itsmefox in https://github.com/DV8FromTheWorld/JDA/pull/2086
• Return MessageReaction for getReactionX methods by @​duncte123 in https://github.com/DV8FromTheWorld/JDA/pull/2026

Changes

• Dependency upgrades by @​Alf-Melmac in https://github.com/DV8FromTheWorld/JDA/pull/1819
• Improve handling of Role#getPosition and canInteract by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2085
• Add GuildImpl#invalidate by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2032
• Handle message related events from unexpected channel types by @​MinnDevelopment in https://github.com/DV8FromTheWorld/JDA/pull/2078
• Correct Activity.listening documentation by @​markozajc in https://github.com/DV8FromTheWorld/JDA/pull/2052
• Replace faulty link with value in replyChoices docs by @​SIMULATAN in https://github.com/DV8FromTheWorld/JDA/pull/2073
• transform hardcoded jump url format into a constant by @​caneleex in https://github.com/DV8FromTheWorld/JDA/pull/2087

Bug Fixes

• Fix NPE when cloning guild role with null icon (v5) by @​Tais993 in https://github.com/DV8FromTheWorld/JDA/pull/2063
• Build the User from data in the Interaction if the User was not cached. by @​oliver276 in https://github.com/DV8FromTheWorld/JDA/pull/2060
• Fix possible ClassCastException when removing reactions in threads by @​RoanH in https://github.com/DV8FromTheWorld/JDA/pull/2069
• Fix rate limiter not shutting down if there is an empty bucket at shutdown by @​Vankka in https://github.com/DV8FromTheWorld/JDA/pull/2080

Removed

• Remove mentioning members with ! by @​Tais993 in https://github.com/DV8FromTheWorld/JDA/pull/2081
• A variety of overloads that accepted string/long/User/Member. Refer to UserSnowflake details above.

Full Changelog: discord-jda/JDA@v5.0.0-alpha.9...v5.0.0-alpha.10

Installation

Gradle

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

Maven

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

---

Configuration

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

🚦 Automerge: Disabled due to failing status checks.

♻ 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, click this checkbox.

---

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