Skip to main content

Versions

The following table describes our current available versions, their support status, Discord API versions and compatibility with other projects like Spring Boot.

Discord4JSupportGateway/APIIntentsReactorSpring BootArtifact VERSION
v3.3.xIn developmentv9 (Threads)Mandatory3.4 (2020)2.3 and aboveSnapshots only
v3.2.xCurrentv8Mandatory3.4 (2020)2.3 and aboveMaven Central
v3.1.xMaintenance Onlyv6Optional3.3 (Dysprosium)2.2 and aboveMaven Central

Discord API v8 and above require mandatory intents, Discord4J uses non-privileged intents by default.

All supported versions have JDK 8 baseline. Spring Boot compatibility is a general guideline as other versions might work through shading techniques for transitive libraries like Reactor and Netty.

"Maintenance only" support means we'll try to address critical issues only but no new features will be added to that branch.

If you want to use experimental snapshot versions, refer to Using Snapshots.

Recent features supported

Featurev3.3.xv3.2.xv3.1.x
Slash commandsYesYesYes
ButtonsYesYesYes
Select menusYesYesYes
Context menusYesYesYes
Guild stickersYesYesNo
Unique usernamesYesYesNo
Stage channels and instancesYesNoNo
ThreadsYesNoNo
ForumsYesNoNo

Compatibility

Discord4J uses a Generation.Major.Minor version scheme so the following guidelines apply:

  • Upgrades from a x.y.z to x.y.z+1 version don't affect public API and behavior changes are not expected unless they mean to fix a major issue.
  • Upgrades from a x.y to x.y+1 generally need a migration guide as they can have public API changes. We will try to offer a migration period of at least 1 major version whenever possible.

Classes and methods marked as Beta or Experimental are not affected by this policy.