Skip to content

Eclipse Setup


  1. If you have Eclipse IDE for Java Developers installed, skip to 2., otherwise you need to install the Buildship Gradle Integration plugin first:

    1. Open up Eclipse and go to the Marketplace (located under the Help tab)
    2. Search for "Gradle" and install Buildship Gradle Integration (Plugin-Page)
    3. After the plugin is installed, relaunch Eclipse
  2. Right click within Package/Project Explorer and select New > Other...

    New Gradle Project

  3. In the Gradle folder, select Gradle Project

    Gradle Project

  4. Type a name for your Project and click on Finish. Your setup should look like this at this point:

    Folder Structure

  5. Delete the classes within src/main/java and src/test/java

    Files To Delete

  6. Open up and edit the file build.gradle

    Build_Gradle Location

  7. Replace its content with the following code:

    plugins {
        id("com.github.johnrengelman.shadow") version "6.0.0"
    mainClassName = "com.example.jda.Bot"
    version '1.0'
    sourceCompatibility = 1.8
    repositories {
    dependencies {
    compileJava.options.encoding = "UTF-8"
  8. Adjust the version of JDA you want to use (see dependencies-section of file) and fill in your Main-Class as soon as you have one (the one containing your public static void main(String[] args) method)

  9. Save the file and do the following: Right click your project > Gradle > Refresh All

    Refresh Gradle Project

  10. Once all the dependencies have been downloaded, create your desired packages/classes in src/main/java and start coding!

  11. To build your project you can run gradlew shadowJar in a terminal of your project root, and it will produce a jar filled with your compiled code and JDA included in a single jar file! The jar can be found in build/libs
  12. Setup Logback
  13. Continue with Getting Started

Prerequisites: Maven-Plugin and local Maven installation

  1. Create a new Maven project. (File -> New -> Other -> Maven -> Maven Project)

    New Maven Project

  2. Check the Create a simple project box on the next page as we don't need to worry about archetypes.

    Check Simple Project

  3. Add a groupId, artifactId and a name. Make sure you try to follow the naming conventions while you are at this step. The result could look like the image below.

    Project Values

  4. Now let's start configuring it, first off, open up your pom.xml and add the following lines right after </description>


  5. This will make your project support UTF-8 characters (So you can have it on Japanese servers for example) and also force Java 8, which is needed.

  6. Now, add the dependency, make sure you change X.Y.Z-beta.W to the latest version number (You can find it in the releases:


  7. Now you need to set up the (build) maven-shade and maven-compile plugins, add the following lines right after </dependencies>


    The following changes will force the compiler to use Java 8 (JDA needs it), so make sure you have it installed.

                        <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                            <mainClass>YourMainClass</mainClass> <!-- (1) -->
    1. You have to replace this with a path to your main class like me.myname.mybotproject.Main
  8. After that, the project must be updated to download the dependencies. Right click > Maven > Update Project

    Maven Update

  9. You are done! Now you can head to the Javadocs or see examples at the Examples page.

  10. Setup Logback
  11. Continue with Getting Started
  1. Download the latest (Binary) version of JDA (with Dependencies):
  2. Create a new Java Project

    New Java Project

  3. Fill out the bot name, and set it to Java 8 (or above if available). This option might be set automatically when the Use default location box is checked.

    Java 8

  4. Right click the project, go to Properties

  5. Click on Java Build Path, then click on Libraries, then on Classpath, Add External JARs...

    Add External Jars

  6. Add your downloaded JDA-withDependencies-x.x.x_xxx.jar and expand its properties

  7. If you don't want Javadoc and source annotations, skip to 11 (not recommended).

    Add External Jars

  8. Click on Source Attachment, then on Edit..., then mark External Locations and click on External File

    External File

  9. Here, add your JDA-x.x.x_xxx-sources.jar and click on OK

  10. Next, click on Javadoc Location, then on Edit..., then mark Javadoc in archive and click on Browse


  11. Here, add your JDA-x.y.z-www.p-javadoc.jar and click on OK

  12. Setup Logback
  13. Continue with Getting Started