Skip to content

Latest commit

 

History

History
97 lines (81 loc) · 3.55 KB

README.md

File metadata and controls

97 lines (81 loc) · 3.55 KB

version license issues

JDA-Utilities

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

Packages

Since JDA-Utilities 2.x, the library has been split into multiple modular projects, in order to better organize it's contents based on what developers might want to use and not use.

Visit individual modules to read more about their contents!

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:

  <dependency>
    <groupId>com.jagrosh</groupId>
    <artifactId>jda-utilities</artifactId>
    <version>JDA-UTILITIES-VERSION</version>
    <scope>compile</scope>
    <type>pom</type>
  </dependency>
  <dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>JDA-VERSION</version>
  </dependency>
  <repository>
    <id>central</id>
    <name>bintray</name>
    <url>http://jcenter.bintray.com</url>
  </repository>

With gradle:

dependencies {
    compile 'com.jagrosh:jda-utilities:JDA-UTILITIES-VERSION'
    compile 'net.dv8tion:JDA:JDA-VERSION'
}

repositories {
    jcenter()
}

Individual modules can be downloaded using the same structure shown above, with the addition of the module's name as a suffix to the dependency:

With maven:

  <dependency>
    <groupId>com.jagrosh</groupId>
    <!-- Notice that the dependency notation ends with "-command" -->
    <artifactId>jda-utilities-command</artifactId>
    <version>JDA-UTILITIES-VERSION</version>
    <scope>compile</scope>
  </dependency>

With gradle:

dependencies {
    // Notice that the dependency notation ends with "-command"
    compile 'com.jagrosh:jda-utilities-command:JDA-UTILITIES-VERSION'
}

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!