Package Exports
- create-discobase-test
- create-discobase-test/setup.mjs
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (create-discobase-test) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme

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 โ
disabledandrequiredRolesfor more control. - โ
Flexible Config โ Easily toggle
errorLoggingand managepresencedirectly 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.jsonflag. - ๐ฎ 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 generateinstantly scaffolds new commands/events! - ๐ป Manage Command:
npm run manageEnable or disable slash or prefix commands/events!
๐ฆ Installation
Create a new discoBase project in seconds:
npx create-discobase@latest my-projectOr 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๐ ๏ธ New: Discord.js Builder Support
When generating commands, you can now select which Discord.js builders to include:
- EmbedBuilder - Create rich embedded messages
- ButtonBuilder & ActionRowBuilder - Add interactive buttons
- StringSelectMenuBuilder - Create dropdown menus
- ModalBuilder & TextInputBuilder - Show input forms
The CLI will automatically generate the appropriate imports and example code!
๐ Manage Commands & Events
Use the new management CLI to edit, pause, or delete commands and events:
npm run manageFeatures:
- ๐ Browse commands and events in a tree view
- โ๏ธ Edit files directly in your preferred editor
- โธ๏ธ Pause/Resume commands without deleting them
- ๐๏ธ Delete commands and events with confirmation
- ๐ Organized by categories for easy navigation
๐ค 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.

