Discord.js v14 Command Handler

A simple and efficient command handler for your Discord bot built using discord.js. This setup organizes commands and events for better maintainability and scalability.

Features

• Organized command and event handling.
• Auto-loading commands and events from respective directories.
• Modular structure for easy expansion.

Prerequisites

• node.js v16.6.0 or higher
• discord.js v14.x.x or higher

Installation

1. Clone the repository:

git clone https://github.com/zyflou/discord.js-v14-handler
cd discord.js-v14-handler

2. Install dependencies:

npm install discord.js dotenv

3. Configure the bot: Create a .env file in the root directory and add the following values:

TOKEN= #YOUR-DISCORD-BOT-TOKEN
PREFIX= #YOUR-DISCORD-BOT-PREFIX
OWNERID= #YOUR-ID

4. Run the bot:

npm run start 

Commands

All command files are stored in the commands/ folder. Each command is organized into categories (folders). A command file typically looks like this:

module.exports = {
  name: "ping",
  description: "Ping command",
  category: "utility",
  async exec(client, message, args) {
  message.channel.send('Pong!')
  }
}

Events

Events are stored in the events/ folder, and organized into client/ and guild/ sub-folders. The event handler will automatically register all events from these directories.

Event Handler

(handler/event.js)

const { readdirSync, existsSync } = require("fs");
const path = require("path");

module.exports = (client) => {
    const basePath = "./events/";

    if (existsSync(basePath)) {
        const folders = readdirSync(basePath, { withFileTypes: true })
            .filter((dirent) => dirent.isDirectory())
            .map((dirent) => dirent.name);

        folders.forEach((folder) => {
            const folderPath = path.join(basePath, folder);
            const files = readdirSync(folderPath).filter((f) => f.endsWith(".js"));

            files.forEach((fileName) => {
                const event = require(path.join("..", folderPath, fileName));
                if (event.name && event.exec) {
                    client.on(event.name, (...args) => event.exec(client, ...args));
                }
            });
        });
    }
};

Example Events

(events/client/ready.js)

This event triggers when the bot is ready.

module.exports = {
    name: "ready",
    exec: async (client) => {
        console.log(`Logged in as ${client.user.tag}!`);
    },
};

Contributing

We welcome contributions to improve this project! If you'd like to contribute, please follow these guidelines:

• Follow the coding style: Ensure that your code follows the project's existing conventions to maintain consistency.
• Document your changes: For any new features or major updates, please add comments in the code and update the README if necessary.
• Test thoroughly: Before submitting any changes, test them to ensure that everything works properly without introducing new bugs.
• Respectful collaboration: Maintain a respectful tone when interacting with other contributors or maintainers, and be open to feedback.
• Open issues for major changes: If your contribution introduces a significant change or is breaking existing functionality, please open an issue first to discuss the change before proceeding.

If you encounter any bugs or have suggestions for new features, feel free to open an issue.

License

This project is licensed under the ISC License.