JDA-Commands

A lightweight, easy-to-use command framework for building Discord bots with JDA with full support for interactions. JDA-Commands goal is to remove any boilerplate code, so you can focus solely on the business logic of your bot - writing bots has never been easier!

Features

• Simple and intuitive syntax following an annotation-driven and declarative style

• Built-in support for slash commands, message and action components, embeds, context menus and modals

• Automatic and customizable type adapting and constraint validation of parameters

• Expandable executing chain (Middleware API)

• Multithreaded event handling using VirtualThreads

• First-hand localization support (via Project Fluent or custom implementation)

• Usage of jSpecify nullability annotations

• and many more!

If you want to learn more, go check out the Wiki or Javadocs and join our Discord server.

Example

@Interaction
public class CookieClicker {

    private int counter;

    @Command(value = "cookie clicker", desc = "Play cookie clicker")
    public void onClicker(CommandEvent event) {
        event.with().components("onCookie", "onReset").reply("You've got { $count } cookie(s)!", entry("count", counter));
    }

    @Button(value = "Collect", emoji = "🍪", style = ButtonStyle.SUCCESS)
    public void onCookie(ComponentEvent event) {
        event.reply("You've got { $count } cookie(s)!", entry("count", counter++));
    }

    @Button(value = "Reset", emoji = "🔄", style = ButtonStyle.DANGER)
    public void onReset(ComponentEvent event) {
        count = 0;
        event.reply("You've got { $count } cookie(s)!", entry("count", counter));
    }
}

Components V2

@Command(value = "cookie clicker", desc = "Play cookie clicker")
public void onClicker(CommandEvent event) {
    event.reply(
            Container.of(
                    TextDisplay.of("You've got { $count } cookie(s)!"),
                    ActionRow.of(Component.button("onCookie"), Component.button("onReset"))
            ), entry("count", 1)
    );
}

Download

You can download the latest version here.

Maven

<dependency>
   <groupId>io.github.kaktushose</groupId>
   <artifactId>jda-commands</artifactId>
   <version>5.1.1</version>
</dependency>

Gradle

repositories {
   mavenCentral()
}
dependencies {
   implementation("io.github.kaktushose:jda-commands:5.1.1")
}

Contributing

If you think that something is missing, and you want to add it yourself, feel free to open a pull request. Please consider opening an issue first, so we can discuss if your changes fit to the framework. Also check out the project board to see what we already planned for future releases.

Special thanks to all contributors, especially to @Goldmensch and @lus <3