Skip to content

# Changelog

This page lists all versions of JavaBotBlockAPI and the changes being made.

Important

- Numbers marked with a `*` are not available on bintray.
  You may use jitpack.io for downloading those.
- Numbers marked with a `**` will require you to add `https://dl.bintray.com/andre601/maven` to your build.gradle or pom.xml as a repository.
- Numbers below version `4.0.0` use `com.andre601` as package and not `org.botblock` and also require the above repo-url.

## v5

Split up the different `GET` actions into bot and list related actions.
Many new `GET` actions added for list related stuff.

### 5.2.3

- Site updated:
  - Deprecated `VULTREX_IO` (Planned removal: 5.2.5)
  - Added `DISCORDBOTS_CO` (Replacement of vultrex.io)
- Removed deprecated Methods:
  - `GetBotAction()`
  - `GetBotAction(boolean)`
  - `GetListAction()`
  - `GetListAction(boolean)`
  - `GetListAction.ApiField#API_ALL`
  - `GetListAction.ApiField#API_DOCS`
  - `GetListAction.ApiField#API_GET`
  - `GetListAction.ApiField#API_POST`
  - `GetListAction.ApiField#API_FIELD`
  - `GetListAction.ApiField#API_SHARD_ID`
  - `GetListAction.ApiField#API_SHARD_COUNT`
  - `GetListAction.ApiField#API_SHARDS`
  - `PostAction()`
  - `BotBlockAPI(Map<String, String>)`
- Fixed issue with new ApiField having wrong names.

### 5.2.2

- Added `@PlannedRemoval` annotation to mark objects marked for removal.
- Replaced Jetbrain's `@NotNull` and `@Nullable` annotations with Javax's `@Nonnull` and `@Nullable`
- Dependencies updated:
  - JDA: `4.1.1_165` to `4.2.0_172`

### 5.2.1

- Site updated:
  - Added `DISCORDLISTOLOGY_COM`
  - Added `VULTREX_IO`
- Dependencies updated:
  - JDA: `4.1.1_156` to `4.1.1_165`
- Improved Javadoc
- Removed deprecated `getInvite` methods from `GetBotAction`
- Make the RequestHandler return proper JSON on (partially) failed POST

### 5.2.0

Important

This version is a breaking change!

- Deprecated Constructors:
  - `BotBlockAPI(Map<String, String>`
  - `GetBotAction()`
  - `GetBotAction(boolean)`
  - `GetListAction()`
  - `GetListAction(boolean)`
  - `PostAction()`
- New Constructors:
  - `GetBotAction(String)`
  - `GetBotAction(boolean, String)`
  - `GetBotAction(boolean, String, String)`
  - `GetListAction(String)`
  - `GetListAction(boolean, String)`
  - `GetListAction(boolean, String, String)`
  - `PostAction(String)`
  - `PostAction(String, String)`
- Site updated:
  - Removed `CLOUD_BOTLIST_XYZ`
  - Removed `CLOUDLIST_XYZ`
  - Removed `DISCORDBOT_WORLD`
  - Removed `DIVINEDISCORDBOTS_COM`
  - Removed `LBOTS_ORG`
- Dependencies updated:
  - JDA: `4.1.1_154` to `4.1.1_156`
  - JSON: `20190722` to `20200518`

### 5.1.17

- Site updated:
  - Added `BOTSDATABASE_COM`
- Dependencies updated:
  - OkHttp: `4.2.2` to `4.7.2`
  - JDA: `4.1.1_137` to `4.1.1_154`

### 5.1.16

- Site updated:
  - Deprecated `CLOUD_BOTLIST_XYZ`
  - Deprecated `CLOUDLIST_XYZ`
  - Deprecated `DIVINEDISCORDBOTS_COM`
  - Removed `ARCANE_BOTCENTER_XYZ`
  - Removed `DISCORDBOTREVIEWS_XYZ`
- Dependencies updated:
  - JDA: `4.1.1_136` to `4.1.1_137`

### 5.1.15

- Site updated:
  - Deprecated `LBOTS_ORG`
  - Deprecated `DISCORDBOT_WORLD`
- Dependencies updated:
  - JDA: `4.1.1_105` to `4.1.1_136`

### 5.1.14

- Site updated:
  - Added `DISCORDLIST_CO`
  - Deprecated `DISCORDBOTREVIEW_XYZ`
  - Removed `TOP_GG`

### 5.1.13

- Site updated:
  - Added `ARCANE_CENTER_XYZ`
  - Deprecated `ARCANE_BOT_CENTER_XYZ`
  - Removed `DISCORDBESTBOTS_XYZ` and `DISCORDBOTS_GG`
- Changed ApiField enum names and deprecated old ones.

### 5.1.12

- Improve format of `RatelimitedException#getMessage()`
- Added `toString()` for RatelimitedException

### 5.1.11

- Fix version

### 5.1.10*

- Site updated:
  - Added `SPACE_BOT_LIST_ORG`

### 5.1.9

- Site updated:
  - Added `CLOUDLIST_XYZ`
- Dependencies updated:
  - JDA: `4.1.1_101` to `4.1.1_105`

### 5.1.8

- Same changes as 5.1.7

### 5.1.7*

- Changed `RatelimitedException` from extending Throwable to extending RuntimeException.
  You no longer need to try-cacth the RatelimitedException.
- Dependencies updated:
  - JDA: `4.1.0_100` to `4.1.1_101`

### 5.1.6

- Site updated:
  - Deprecated `TOP_GG` for this reason.

### 5.1.5*

- The GitHub Action to upload assets to the release now adds the jar files and the zip file to the release.

### 5.1.4

- Test release for upload to release-action.

### 5.1.3

- Dependencies updated:
  - JDA: `4.1.0_99` to `4.1.0_100`

### 5.1.2

- BotBlockAPI will now throw an `IllegalArgumentException` when the provided Map is empty.
- The Integer updateDelay in BotBlockAPI is now marked as `@NotNull`

### 5.1.1

- Site updated:
  - Added `GLENNBOTLIST_XYZ`

### 5.1.0

- Removed deprecated `GetAction` class. Use `GetBotAction` or `GetListAction` respectively.

### 5.0.5*

- Second test for adding zip file to Release.

### 5.0.4*

- Test for adding zip file to Release.

### 5.0.3*

- Debugging.

### 5.0.2

- Changed `@DeprecatedSince` annotation.
- Dependencies updated:
  - JDA: `4.1.0_96` to `4.1.0_97`

### 5.0.1

- Renamed `getFilteredList(String)` to `getFilteredLists(String)`

### 5.0.0

- Deprecated `GetAction`. `GetBotAction` and `GetListAction` were added as replacement.
- New methods added to `GetListAction`:
  - `getApiField(String, Site|String, ApiField)`
  - `getBotWidgetUrl(String, Site|String)`
  - `getDescription(String, Site|String)`
  - `getDiscordInvite(String, Site|String)`
  - `getFeatures(String, Site|String)`
  - `getFilteredList(String)`
  - `getIcon(String, Site|String)`
  - `getId(String, Site|String)`
  - `getLanguage(String, Site|String)`
  - `getList(String, Site|String)`
  - `getLists(String)`
  - `getName(String, Site|String)`
  - `getOwners(String, Site|String)`
  - `getTimeAdded(String, Site|String)`
  - `getUrl(String, Site|String)`
  - `isDefunct(String, Site|String)`
  - `isDiscordOnly(String, Site|String)`

## v4

Package renaming from `com.andre601` to `org.botblock`.
Many new `GET` methods.

### v4.3.0

- Adds new GetAction
  - `getBotListFeatures(String, Site|String)`: Returns a JSONArray with all features the bot list has.

### v4.2.5**

- This was a test release for the attachment of zip files to the release. It failed.

### v4.2.4

- Site updated:
  - Added `ARCANE_BOTCENTER_XYZ`
  - Added `DBLISTA_PL`

### v4.2.3

- Site updated:
  - Deprecated `DISCORDBESTBOTS_XYZ`
    Use `DISCORDEXTREMELIST_XYZ` instead.

### v4.2.2

- Site updated:
  - Removed `GLENNBOTLIST_XYZ`

### v4.2.1**

- Removed unused imports.

### v4.2.0**

- Added new get methods to GetAction:
  - `getDiscriminator(Long|String)`: Returns the discriminator of the bot or an empty String.
  - `getGitHub(Long|String)`: Returns GitHub url or an empty String.
  - `getLibrary(Long|String)`: Returns the library used by the bot or an empty String.
  - `getName(Long|String)`: Returns the name of the bot or an empty String.
  - `getPrefix(Long|String)`: Returns the command prefix of the bot or an empty String.
  - `getSupportLink(Long|String)`: Returns the support link (i.e. Discord invite) or an empty String.
  - `getWebsite(Long|String)`: Returns the website link of the bot or an empty String.
- `getServerCount(Long|String id)` is now declared as `@Nullable` meaning result may be null.

### v4.1.1

- `@DeprecatedSince` was slightly changed.

### v4.1.0

- Merged the `@ReplacedWith` into the `@DeprecatedSince` annotation.

### v4.0.4

- For unknown reason is the wrapper not available through normal downloads...

### v4.0.3

- Fixed broken version system.

### v4.0.2*

- Updated version system.
- Releases are back to `#.#.#` format while dev builds are `#.#.#_#`

### v4.0.1_0

- Updated message of RatelimitedException

### v4.0.0_0

- Updated packages from `com.andre601` to `org.botblock`.
  This is a breaking change.

## v3

Separated `POST` and `GET` requests into their own respective classes.
Dev builds where also available from v3.1.0 onwards.

### v3.3.0_0

- Version now has a build-number attached (used for Jenkin builds)

### v3.2.1

- Site updated:
  - Added `GLENNBOTLIST_XYZ`
  - Added `CLOUD_BOTLIST_XYZ`

### v3.2.0

- Added `@DeprecatedSince` and `@ReplacedWith` annotations

### v3.1.0

- Updated Gradle to v5.5
- Added links to Jenkins for dev builds (Thanks CodeMC)
- Dependencies updated:
  - Shadow: `4.0.4` to `5.2.0`
  - JDA: `4.0.0_73` to `4.1.0_81`

### v3.0.6

- It's `targetCompatibility` not `targetCompitability`

### v3.0.5*

- Fixed broken build.gradle

### v3.0.4*

- RequestHandler was removed
- Dependencies updated:
  - JDA: `4.0.0_70` to `4.0.0_73`

### v3.0.3

- Same changes as v3.0.2

### v3.0.2*

- Dependencies updated:
  - JDA: `4.0.0_61` to `4.0.0_70`

### v3.0.1

- Site updated:
  - Deprecated `Site.DISCORDBOTS_ORG`.
    Use `Site.TOP_GG` instead.

### v3.0.0

- Moved post and get methods to their own class
  - GetAction was created for all GET methods.
  - PostAction was created for all POST methods.
- RequestHandler (`com.andre601.javabotblockapi.RequestHandler`) is now deprecated.
- Site updated:
  - Added `TOP_GG`
- New methods `getInvite(Long|String)` and `getServerCount(Long|String)` added.
- Timeouts for POST requests where made dynamic.
- GET methods which used either an JDA or ShardManager instance got removed.
- Renamed multiple methods:
  - `getBotInfo` and `getBotInfos` where renamed to `getBotListInfo`
  - `getAll` was renamed to `getBotInfo`
  - `startAutoPosting` was renamed to `enableAutoPost`
  - `stopAutoPosting` was renamed to `disableAutoPost`
- Dependencies updated:
  - JDA: `4.0.0_52` to `4.0.0_61`
  - annotations: `17.0.0` to `18.0.0`

## v2

Added support for `GET` methods and added the Site enum.
Additionally added support for first v4 versions of JDA.

### v2.3.9

- Dependencies updated:
  - JDA: `4.0.0_48` to `4.0.0_52`
  - OkHttp: `4.2.1` to `4.2.2`

### v2.3.8

- Implemented GitHub actions for automated releasing to Bintray.

### v2.3.6

- 2nd attempt on integrating GitHub actions (failed)

### v2.3.5

- Dependencies updated:
  - JDA: `4.0.0_45` to `4.0.0_48`
- Updated to Java 11. It can still work with Java 8.

### v2.3.4

- Sites updated:
  - Fixed wrong Site name from DISCORSDBESTBOTS_XYZ to DISCORDBESTBOTS_XYZ

### v2.3.3

- Site updated:
  - Added `DISCORDEXTREMELIST_XYZ`
  - Removed `DISCORDBOTLIST_US_TO`
- Removed GitHub Actions for now.

### v2.3.2

- Attempt to fix GitHub's Actions.

### v2.3.1

- Adding GitHub Actions to workflow.

### v2.3.0

- Implemented caching to get methods.
  - `getBotlists()` and `getBotlist(String|Site site)` now require an additional String parameter.
- Dependencies updated:
  - JDA: `4.0.0_40` to `4.0.0_45`

### v2.2.1

- Dependencies updated:
  - JDA: `4.0.0_39` to `4.0.0_40`

### v2.2.0

- Dependencies updated:
  - JDA: `4.BETA.0_32` to `4.0.0_39` (Official release of JDA v4)

### v2.1.1

- Site updated:
  - Added `YABL_XYZ`

### v2.1.0

- Added new Site enum to have easier methods and reliable site names

### v2.0.2

- Dependencies updated
  - JDA: `4.BETA.0_30` to `4.BETA.0_32`

### v2.0.1

- Dependencies updated:
  - JDA: `4.BETA.0_23` to `4.BETA.0_30`

### v2.0.0

- Added new get methods for bot and botlist infos.
- Dependencies updated:
  - JDA: Updated to `4.BETA.0_23`

## v1

First releases of the Java Wrapper.

### v1.0.5

- Updated minimal delay to 2 since rate limit is 1/120s.

### v1.0.4

- Made RequestHandler an empty constructor.

### v1.0.3

- Fixing JSONException when BotBlock.org has no 'failure' object present.

### v1.0.2

- Moved JDA and ShardManager from BotBlockAPI to RequestHandler methods.

### v1.0.1

- Make BotBlockAPI.Builder static. Fixes `Non enclosing class` error

### v1.0.0

- First release