Free · Open source

Other project

BaselyJava Discord bot starter with JDA

Java and Spring Boot Discord bot starter with structured JDA commands, events, moderation, and scheduled work.

Spring BootJavaJDADiscord
View on GitHubView capabilities

Basely · quick run

Quick start

Run Basely

Terminal
git clone https://github.com/buildbasekit/Basely.git
cd Basely
# Configure the Discord bot token and MySQL
mvn spring-boot:run
Java 21 · Git · Maven · MySQLRead the setup guide on GitHub

Product preview

Ping command

Release details

Version
v1.0.0
Java
21
Spring Boot
3.5.13
License
MIT

Capability summary

Features

The focused capabilities included in the current product generation.

Prefix commands

Resolve commands through a registry with a configurable per-guild prefix.

Moderation

Ban, kick, warn, infractions, role, and welcome-message workflows provide a practical starting set.

Events

JDA listeners cover message and member events while delegating focused behavior.

Scheduling

Personal reminders and background jobs demonstrate time-based bot work.

Guild settings

Persist server-specific command prefixes and welcome configuration.

Fit

Who this is for

  • Java developers building community and moderation bots
  • Discord projects that need structured command handling
  • Teams moving beyond a single oversized JDA listener
  • Builders who want scheduled work alongside bot events

Build or adopt

Why Basely?

Basely provides a working structure for Discord commands, events, guild settings, and scheduled work.

Without Basely

  • Build command discovery and dispatch
  • Mix permissions into raw event listeners
  • Create guild settings and scheduled jobs
  • Document how new handlers fit together

With Basely

  • Commands implement a small shared contract
  • The listener delegates through a command manager
  • Guild settings and reminders are persisted
  • GitHub keeps the complete technical reference

Repository reference

Technical details

Setup, architecture, the complete command reference, and implementation details are maintained with the open-source project.

!help!ping!ban!remind
View technical details on GitHub

Related guidance

Architecture and implementation guidance related to this foundation.

GuideJava Discord Bot Architecture with JDA

Design a Java Discord bot architecture with separate JDA commands, event listeners, services, configuration, persistence, and extension boundaries.

9 min readGuideHow to Structure a Java Discord Bot with JDA

Structure a Java Discord bot by separating JDA listeners, commands, services, configuration, persistence, and scheduled work.

5 min readGuideCommon JDA Discord Bot Mistakes and Fixes

Fix common JDA bot problems involving oversized listeners, mixed business logic, event handling, hardcoded configuration, and unclear extension boundaries.

8 min read

Evaluate Basely

Review the repository, run the starter, and adapt its commands and events to your Discord community.

View on GitHub