lenkunz / JDA-Utilities

A commands extension for JDA to assist in bot creation

JDA-Utilities

JDA-Utilities is a series of tools and utilities for use with JDA to assist in bot creation.

Version 2.0 Notice

Version 2.0 will be a come with a lot of big (some breaking) changes to the library.

If you use this library for anything, it is STRONGLY recommended you read this gist which documents all of the changes that will be made, as to better prepare yourself for moving to 2.0.

Note that the gist is in no way final, and will be modified possibly until the day that we release 2.0, so it's a good idea to keep up-to-date with it in the coming weeks.

If you have questions or concerns about any of these changes, please contact Shengaero#9090.

Getting Started

You will need to add this project as a dependency (either from the latest .jar from the releases page, or via maven or gradle), as well as JDA. With maven, you can use the snippets below:

  <dependency>
    <groupId>com.jagrosh</groupId>
    <artifactId>JDA-Utilities</artifactId>
    <version>1.9</version>
    <scope>compile</scope>
  </dependency>
  <dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>LATEST</version>
  </dependency>

  <repository>
    <id>central</id>
    <name>bintray</name>
    <url>http://jcenter.bintray.com</url>
  </repository>

With gradle:

dependencies {
    compile 'com.jagrosh:JDA-Utilities:1.9'
    compile 'net.dv8tion:JDA:LATEST'
}

repositories {
    jcenter()
}

Examples

Check out the ExampleBot for a simple bot example.

Other guides and information can be found on the wiki.

Projects

Vortex - Vortex is an easy-to-use moderation bot that utilizes the JDA-Utilities library for the Command Client and some of the menus
JMusicBot - This music bot uses the Command Client for its base, and several menus, including the OrderedMenu for search results and the Paginator for the current queue
GiveawayBot - GiveawayBot is a basic bot for hosting quick giveaways!