v6.0.0: | New Component API

Overview

This is the stable release of JDA 6.0.0. To avoid repeating the same information again, please look at the release notes of the release candidates for detailed explanations of the breaking changes and new features.

Release Candidates

1. v6.0.0-rc.1 New Components
2. v6.0.0-rc.2 New Pin Pagination API
3. v6.0.0-rc.3 New pin permissions and removal of bot owned guilds
4. v6.0.0-rc.4 Change to Modals
5. v6.0.0-rc.5 Modal Components and Serialization

Migrating to 6.0.0

To help ease the upgrade to JDA 6.0.0, we've provided an OpenRewrite recipe that can automatically refactor parts of your codebase. This will update imports and replace a few method calls with their new equivalents in JDA 6.0.0.

However, not all breaking changes can be handled automatically — for example, code that relied on the mutability of ActionRow will require manual adjustments.

You will also have to update your code for creating Modal instances. Instead of using ActionRow, modals now make use of the Label component. Read the release notes for v6.0.0-rc.4 to learn more.

The OpenRewrite Recipe

Before applying the recipe, make sure you’re using version control (e.g., Git) or back up your project manually. You’ll also need to be using Gradle or Maven to apply the migration.

plugins {
    id("org.openrewrite.rewrite") version "7.11.0"
}

repositories {
    mavenCentral()
}

dependencies {
    // Your current JDA version before upgrading to 6.0.0
    implementation("net.dv8tion:JDA:5.+")

    rewrite("net.dv8tion:JDA:6.0.0")
    rewrite("org.openrewrite.recipe:rewrite-java-dependencies:1.37.0")
}

rewrite {
    activeRecipe("net.dv8tion.MigrateComponentsV2")
}

<plugin>
  <groupId>org.openrewrite.maven</groupId>
  <artifactId>rewrite-maven-plugin</artifactId>
  <version>6.13.0</version>
  <configuration>
    <activeRecipes>
      <recipe>net.dv8tion.MigrateComponentsV2</recipe>
    </activeRecipes>
  </configuration>
  <dependencies>
    <dependency>
      <groupId>org.openrewrite.recipe</groupId>
      <artifactId>rewrite-java-dependencies</artifactId>
      <version>1.37.0</version>
    </dependency>
    <dependency>
      <groupId>net.dv8tion</groupId>
      <artifactId>JDA</artifactId>
      <version>6.0.0</version>
    </dependency>
  </dependencies>
</plugin>

New Features

• Add support for components V2 by @​freya022 in #​2809
• Add new pinned message pagination by @​MinnDevelopment in #​2874
• Add message pin permission by @​freya022 in #​2895
• Add support for user primary guilds by @​mjezek-dev in #​2863
• Add common interface for interactions with a custom ID by @​Kaktushose in #​2778
• Add support for Label and StringSelectMenu in Modals by @​Xirado in #​2162
• Add ComponentSerializer and ComponentDeserializer by @​MinnDevelopment in #​2906
• Add TextInput#of shortcut by @​MinnDevelopment in #​2908
• Add entity selects and text displays in modals by @​freya022 in #​2913

Changes

• Remove deprecated features by @​MinnDevelopment in #​2867
• Make JDA#getMutualGuilds accept UserSnowflake instead of User objects by @​MineKing9534 in #​2877
• Move modal classes out of the interactions package by @​freya022 in #​2890
• Use new routes to (un)pin messages by @​freya022 in #​2896
• Remove bot owned guild endpoints by @​freya022 in #​2888

Bug Fixes

• Remove port stripping in VoiceServerUpdateHandler by @​MinnDevelopment in #​2884
• Use DELETE_GUILD route according to the Discord Docs by @​kiLeo13 in #​2875
• Handle forum channels with missing available_tags field by @​MinnDevelopment in #​2902
• Remove unnecessary escaping while creating a masked link by @​Alf-Melmac in #​2910

Full Changelog: discord-jda/JDA@v5.6.1...v6.0.0

Installation

Gradle

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

Maven

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