🚀 Basely – Discord Bot Boilerplate (Spring Boot + JDA)

Basely is a modular, production-ready Discord bot starter built for developers.
It helps you build, customize, and scale Discord bots faster with pre-built features for moderation, automation, and server management.

👉 Full details: https://buildbasekit.com/boilerplates/basely-discord-bot-boilerplate

---

📂 Project Structure

src/main/java/com/discordbot
│   DiscordBotApplication.java
│
├── command/impl        # All command implementations (ban, kick, ping, etc.)
├── config              # DiscordBotConfig (JDA + Spring setup)
├── entities            # JPA entities (GuildSettings, Reminder, UserPreference, Infraction)
├── jobs                # Scheduled tasks (DailyReminder, ReminderScheduler)
├── listener            # JDA event listeners
├── repositories        # Spring Data JPA repositories
└── services            # Business logic (GuildSettingsService, etc.)

---

✅ Features Implemented (Current Version)

🔹 Core

• Prefix support (configurable per guild).
• Help command to list available commands.
• Ping command (latency check).
• Server Info & User Info commands.

🔹 Moderation

• Ban / Kick users with proper handling.

• Warn system

  • !warn @user reason → Stores infractions in DB.
  • !infractions @user → Lists all warnings from DB.

• Role management (assign/remove roles).

• Audit logging ready (infractions retrievable).

🔹 Welcome & Notifications

• Custom welcome messages (!setwelcome).
• Notification preferences stored per user.
• Automatic DM reminders (daily or scheduled).

🔹 Reminders

• !remind 21:00 "Go study!" → Saves a personal reminder in DB.
• Daily reminders sent at scheduled times.

---

🛠️ Features Planned (Next Version)

🔹 Role Persistence

• Store user roles on leave.
• Restore roles on rejoin.
• Backed by UserRoleBackup entity.

---

⚙️ Tech Stack

• Java 21+
• **Spring Boot 3.5.5
• Spring Data JPA + MySQL (default) / H2 (optional)
• JDA (Java Discord API)

---

💡 Usage (Commands)

| Command               | Description                 |
| --------------------- | --------------------------- |
| `!ping`               | Check latency.              |
| `!help`               | List available commands.    |
| `!userinfo @user`     | Show info about a user.     |
| `!serverinfo`         | Show info about the server. |
| `!ban @user`          | Ban a user.                 |
| `!kick @user`         | Kick a user.                |
| `!warn @user reason`  | Warn user & log infraction. |
| `!infractions @user`  | List infractions from DB.   |
| `!setwelcome`         | Configure welcome message.  |
| `!remind 21:00 "msg"` | Set reminder for yourself.  |

---

🎯 Who is it for?

• Indie developers building Discord tools.
• Server admins wanting a customizable bot.
• Freelancers delivering Discord bots faster.

---

⭐ Support

If this helped you:

• Give it a ⭐ on GitHub
• Share with other devs

---

🔗 About BuildBaseKit

We build production-ready starter kits so you can skip setup and ship faster.

🌐 https://buildbasekit.com

For special requirements: 📩 hello@buildbasekit.com

---