Basely

Free

A robust, production-ready Discord bot boilerplate built with Java and JDA for command handling, event management, and scalable bot architecture.

Get Source Code on GitHub

Introduction

Basely removes the repetitive setup work behind Discord bot development. It gives you a clean Java foundation for slash commands, event listeners, and configuration so you can focus on the features that matter.

Use it as a starting point for personal bots, community tools, moderation bots, utility bots, or as a learning project for JDA and Spring-style structure in Java.

Who is this for?

  • • Java developers building their first Discord bot
  • • Students learning JDA and bot architecture
  • • Indie hackers shipping community or utility bots
  • • Developers who want a clean bot starter without clutter

Why Use This Bot Starter

Save Setup Time

Start with a working project structure instead of wiring bot bootstrapping from scratch.

Clean and Minimal

A lightweight codebase makes it easier to understand, extend, and maintain.

Easy to Customize

Modular commands, listeners, and config classes make feature expansion straightforward.

Great Learning Base

Ideal for understanding how real bot projects are organized in Java.

Why not build it yourself?

Without Basely

  • ❌ More time spent on boilerplate and wiring
  • ❌ Repeating the same bot setup for every new project
  • ❌ Higher chance of messy structure early on

With Basely

  • ✅ Fast startup with a clear folder structure
  • ✅ Simple command and listener organization
  • ✅ Easier to grow into a full bot product

Key Features

  • Command Handling

    Built for slash commands with a modular, easy-to-manage structure.

  • Event System

    Listener classes keep event logic separated and maintainable.

  • Configuration Management

    Environment-based configuration keeps secrets out of source code.

  • Modular Architecture

    Organized packages make the codebase easier to scale as your bot grows.

  • Java + JDA Foundation

    Designed around the popular Java Discord API for reliable bot development.

Project Structure

src/main/java/com/discordbot/
├── commands/       # Slash command implementations
├── config/         # Configuration management
├── entities/       # Database models
├── jobs/           # Cron job management
├── listener/       # Discord event listeners
├── repositories/   # Database access
└── services/       # Business logic

Quick Start

Step 1

Clone the project from GitHub repository.

Step 2

Open the project in your IDE (IntelliJ, Eclipse, or VS Code).

Step 3

Configure DB and discord app in application.properties.

Step 4

Run as spring boot app.

Core Modules

Commands

Modular slash commands (ban, kick, warn, reminders, roles, etc.) managed via a centralized command manager.

Listeners

Event listeners for handling Discord events like messages, joins, and welcome flows.

Services

Business logic layer for managing guild settings, reminders, and user preferences.

Repositories

Data access layer using Spring Data for storing infractions, reminders, and guild configurations.

Entities

Database models such as GuildSettings, Infraction, Reminder, and UserPreference.

Schedulers & Jobs

Background jobs for handling scheduled reminders and automated bot tasks.

Configuration

Centralized configuration for bot setup, environment variables, and application properties.

Ready to Start Building your Discord bot?

Download Basely and launch your Discord bot foundation in minutes.

Get Source Code on GitHub Explore More Boilerplates