create-discobase

discoBase

Introducing discoBase v2.5 — the ultimate solution for building and managing your Discord bots with maximum flexibility and next-level control. 🔥

No bloat, no limits — only what you choose to run. Whether you need a simple moderation bot or a complex multi-purpose system, discoBase adapts to your style.

✨ Fully compatible with the latest Discord.js v14.
🌐 Official Website & Docs: https://www.discobase.site

✨ What’s New in v2.5?

• ✅ Advanced Dashboard — Control your bot through a clean, modern web dashboard.
• ✅ 100% Customization — Enable or disable any feature with just a click.
• ✅ Plug & Play — Clean structure, easy setup, no headaches.
• ✅ Powerful & Optimized — Faster, more stable, and scalable for any server size.
• ✅ New Command Options — disabled and requiredRoles for more control.
• ✅ Flexible Config — Easily toggle errorLogging and manage presence directly from your config file.
• ✅ And much more…

📸 Dashboard Preview

Below is a sneak peek at the new Discobase Dashboard:

Main Stats View	Guild Manager & Much More

⚡ Features

• 🎉 Slash & Prefix Command Handler
• 📅 Event Handler
• ⚙️ Advanced Customization Options
• 🔄 Dynamic Reloading
• 🚀 Asynchronous & Modular
• 🛠️ Structured & Scalable
• 🔒 Never Crash — built-in error logging & graceful fallback
• 🔤 Prefix Commands Support
• ➗ Slash Commands Support
• 🔍 Auto Detect Missing Intents
• ⚙️ Configurable Functions: once, interval, retryAttempts, maxExecution, initializer
• 🗂️ Error Logging: Enable or disable with a single discobase.json flag.
• 🎮 Presence Manager: Easily control your bot's status, activity, and type through discobase.json.
• 📊 Discobase Dashboard: Live stats, activities, & easy settings.
• ⚡ Generate Command: npm run generate instantly scaffolds new commands/events!

📦 Installation

Create a new discoBase project in seconds:

npx create-discobase@latest my-project

Or create in the current directory:

npx create-discobase@latest

⚙️ Configuration

Your config.json must have these keys:

Parameter	Type	Description
bot.token	string	Required. Your Discord bot token
bot.id	string	Required. Your Discord bot ID
bot.admins	array	Optional. List of admin user IDs
bot.ownerId	string	Optional. The owner's user ID
bot.developerCommandsServerIds	array	Optional. Server IDs where dev-only commands run
database.mongodbUrl	string	Optional. MongoDB connection URL
logging.guildJoinLogsId	string	Optional. Channel ID for guild join logs
logging.guildLeaveLogsId	string	Optional. Channel ID for guild leave logs
logging.commandLogsChannelId	string	Optional. Channel ID for command logs
logging.errorLogs	string	Optional. Webhook URL for error logging
prefix.value	string	Optional. Prefix for non-slash commands

🧩 Command Options

Use these powerful options in any command file:

Option	Type	Description
ownerOnly	boolean	If true, only the bot owner can use the command.
adminOnly	boolean	If true, only users in bot.admins can use it.
devOnly	boolean	If true, runs only in servers listed under developerCommandsServerIds.
botPermissions	array	List of required bot permissions (e.g. 'SendMessages', 'ManageChannels').
userPermissions	array	List of required user permissions (e.g. 'Administrator', 'KickMembers').
cooldown	number	Cooldown in seconds before reuse (default: 3).
disabled	boolean	New in 2.5 — Easily disable buggy or incomplete commands.
requiredRoles	array	New in 2.5 — Array of server role IDs required to run this command.

🔧 Function Options

Property	Type	Description
once	boolean	Run once then stop.
interval	number	Time (ms) between repeated executions.
retryAttempts	number	Number of retries if the function fails.
maxExecution	number	Maximum number of executions allowed.
initializer	number	Initial value/state for setup or counting.

Example:

const exampleFunction = async () => {
  console.log("Function ran successfully!");
};

exampleFunction.config = {
  once: true,
  interval: 10000,
  retryAttempts: 3,
  maxExecution: 5,
  initializer: 0
};

module.exports = exampleFunction;

🔍 Activity Tracker

Track all file changes in your project in real-time — additions, edits, deletions, and renames — directly in your terminal.

The Activity Tracker is fully configurable through discobase.json.

Property	Type	Description
activityTracker.enabled	boolean	Enable or disable the tracker globally.
activityTracker.ignoredPaths	array	Glob patterns of paths to ignore. Merges with default ignored paths automatically.

Example discobase.json:

{
  "activityTracker": {
    "enabled": true,
    "ignoredPaths": [
      "**/logs/**",
      "**/private/**"
    ]
  }
}

✨ Generate with Ease

Create commands & events instantly:

npm run generate

🤝 Contributing

We love contributions!
Check contributing.md for guidelines & submit your ideas.

⭐ Show Your Support

If this project helped you, please consider leaving a ⭐️ star!

💬 Feedback & Support

Got feedback or questions?
Join our Discord Community.

🔥 Enjoy building with discoBase 2.5 — your bot, your rules.