🚀 Discord Bot Boilerplate (Spring Boot + JDA)

Build powerful Discord bots with Java + Spring Boot — production-ready, scalable, and easy to extend.

Stop wasting time wiring commands, persistence, and event handling. This starter kit gives you a solid foundation with built-in moderation, reminders, and server customization features — so you can focus on your bot’s unique personality.

🔥 Why this boilerplate?

Most Discord bot tutorials stop at simple commands. This boilerplate goes further:

• ✅ Clean command system with prefix support (!help, !ping)
• ✅ Built-in moderation (ban, kick, warn, infractions) with database persistence
• ✅ Reminders & scheduling with Spring’s @Scheduled jobs
• ✅ Server-ready setup (welcome messages, role management, info commands)
• ✅ Spring Boot + JDA foundation → easy to extend with REST APIs, services, or admin panels

Whether you’re a developer, freelancer, or server owner, this saves weeks of repetitive setup.

📦 What’s included?

Core Features

• Command system with prefix (!help, !ping)
• User & server info commands
• Welcome system with customizable messages
• Role management (assign/remove roles)

Moderation

• Ban / Kick commands
• Warn system (!warn @user reason)
• Infractions tracking (!infractions @user)
• Logs stored in MySQL (or H2 for testing)

Reminders & Scheduling

• Personal reminders (!remind 21:00 "Go study!")
• Daily reminders with scheduled jobs
• Automatic DM notifications

Database Ready

• Built with Spring Data JPA
• Default MySQL integration
• Optional H2 in-memory DB for instant setup

📂 Clean Project Structure

command/       → All bot commands (Ban, Warn, Help, etc.)
listener/      → Discord event listeners
entities/      → JPA entities (GuildSettings, Reminder, Infraction)
repositories/  → Spring Data repositories
jobs/          → Scheduled tasks
services/      → Business logic layer

⚙️ Setup Instructions

1. Unzip & Open
   • Download and extract discord-bot.zip
   • Open in your IDE
2. Configure application.properties

   discord.token=YOUR_DISCORD_BOT_TOKEN
   spring.datasource.url=jdbc:mysql://localhost:3306/your_db
   spring.datasource.username=root
   spring.datasource.password=YOUR_PASSWORD
   

3. Run
   • Terminal: ./mvnw spring-boot:run
   • Or IDE → Run as → Spring Boot App

🎯 Who is this for?

✔️ Developers → Skip boilerplate, focus on unique features
✔️ Freelancers → Deliver bots faster to clients
✔️ Server Owners → Launch a customizable bot foundation
✔️ Students & Learners → Learn Spring Boot + JDA with real-world code

🛠️ Roadmap (Free Updates 🚀)

• Role persistence → restore roles when users rejoin
• Server Settings REST API → manage prefixes/welcome via HTTP
• Command permissions → restrict sensitive commands to admins

📦 You’ll Get

• ✅ Complete Spring Boot project (source code)
• ✅ Ready-to-run Discord bot with MySQL integration
• ✅ MIT License
• ✅ Future updates + improvements

📧 Support

Need help or want custom features?
📩 boileragents@gmail.com

⚡ Build your next-gen Discord bot in hours instead of weeks.
👉 Get the Discord Bot Boilerplate today and start coding smarter!