Skip to content

ethical-programmer/create-discobase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Logo

Discord NPM Version NPM License NPM Downloads

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:

Dashboard 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.


About

Easily create and manage your Discord bot with our powerful toolkit! ๐Ÿš€

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published