discoBase

discoBase is a lightweight command and event handler package for Discord bots, enabling easy management of commands and events with a structured file organization and dynamic loading system. It allows you to build almost any advanced Discord bot effortlessly.

✨ Supports Latest Discord.js v14.

🎉 New Update (v1.0.10) 🎉

• 🚀 Enhanced Terminal Look: Experience a cleaner and more modern terminal display with colorful logs for success, errors, and info messages.
• 📝 Auto-Generated Files: Commands, events, and prefix commands now come with pre-built templates to save you time.
• ⚡ Optimized File Watching: Automatic detection and template insertion for new command, event, and prefix files.

Features

• 🎉 Command Handler
• 📅 Event Handler
• ⚙️ Advanced Customization
• 🚀 Asynchronous Support
• 🔄 Dynamic Reloading
• 🛠️ Modular Structure
• 🛡 Never Crash
• 🌐 Compatibility with Advanced Discord Bots
• 🔤 Prefix Commands Support
• ➗ Slash Commands Support
• 🔔 Automatic Detection of Missing Intents

Installation

To create a new discoBase project, run the following commands:

npx create-discobase my-project

You can also create a new project in the current directory without specifying a project name:

npx create-discobase

This will generate a new discoBase project in the current directory.

Configuration

To run this project, you will need to provide the necessary values in the config.json file located in the root directory. The structure of the file is as follows:

| Parameter | Type | Description | | :------------------------------| :------- | :----------------------------------------------------------- | | bot.token | string | Required. Your Discord bot token | | bot.id | string | Required. The ID of your Discord bot | | 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 developer commands are enabled | | 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. Command prefix for non-slash commands |

Command Options

| Option | Type | Description | | :------------------ | :---------- | :--------------------------------------------------------------------------------------------------- | | ownerOnly | boolean | Optional. If true, the command can only be run by the bot owner. | | adminOnly | boolean | Optional. If true, the command can only be used by bot admins specified in the config file. | | devOnly | boolean | Optional. If true, the command is only registered in specific developer servers (slash commands only). | | botPermissions | array | Optional. List of permissions the bot needs to execute the command (e.g., 'SendMessages', 'ManageChannels'). | | userPermissions | array | Optional. List of permissions the user needs to execute the command (e.g., 'Administrator', 'KickMembers'). | | cooldown | number | Optional. The cooldown time in seconds before the command can be reused. Default is 3 seconds. |

Authors

• @ethical_dev

Contributing

Contributions are always welcome!

See contributing.md for ways to get started.

Please adhere to this project's code of conduct.

Show your support

Give a ⭐️ if this project helped you!

Feedback & Suggestion

If you have any feedback or suggestion, please reach out to us at Discord Community

Support

For support & questions, join our Discord server: Discord Community.