Update v2.1.0

Author: TFAGaming

.env.example

@@ -0,0 +1,3 @@
+CLIENT_TOKEN = Your bot token
+CLIENT_ID = Your bot ID
+MONGODB_URI = Your mongodb URI string

README.md

@@ -7,11 +7,13 @@ The simplified Discord bot commands & events handler built with discord.js versi
 - The user commands are built-in Discord commands, and to execute a user command, right-click on a Discord user profile, Apps, and then select a command.
 - The message commands are built-in Discord commands, and to execute a message command, right-click on a message, Apps, and then select a command.
 
-Did you liked my project? Click on the star button (⭐️) right above your screen, thank you!
+This project also handles components, such as Buttons and Select menu (any; String, User, Role...).
+
+Did you like my project? Click on the star button (⭐️) right above your screen, thank you!
 
 Looking for the old version? [Click here](https://github.com/TFAGaming/DiscordJS-V14-Bot-Template/releases/tag/v1.7.0-last).
 
-## Commands/Events structure
+## Commands, events, and components structure
 
 > **Note**
 > This handler uses **CommonJS** modules system.
@@ -44,14 +46,24 @@ module.exports = {
 ```ts
 module.exports = {
     event: string,
-    once: boolean,
-    // ...args are the arguments of the event chosen (from discord.js).
+    once?: boolean,
+    // '...args' are the arguments of the event chosen (from discord.js).
     run: (client, ...args) => {
 
     }
 };
 ```
 
+### Component:
+```ts
+module.exports = {
+    customId: string,
+    run: (client, interaction) => {
+        
+    }
+};
+```
+
 ## Requirements
 ### Packages:
 - **chalk** v2.4.2
@@ -89,22 +101,32 @@ handler: {
     message: boolean // <= Toggle message commands
   },
   mongodb: { // MongoDB database
-    uri: string // <= Your MongoDB URI string
+    uri: string, // <= Your MongoDB URI string,
+    toggle: boolean // <= Connect to the database or not? (true: Yes, false: No)
   }
 }
 ```
 
+You can use ENV instead of `config.js` to keep your bot token and ID and your MongoDB URI in a safe place. Rename the file `.env.example` to `.env` and fill all the required values.
+
+```apache
+CLIENT_TOKEN = Your bot token
+CLIENT_ID = Your bot ID
+MONGODB_URI = Your mongodb URI string
+```
+
 6. To start your bot, run `node .` or `npm run start`.
 7. Enjoy. =)
 
 ## Hosting (<img src="https://media.discordapp.net/attachments/1111644651036876822/1124045180484472882/discloud_white_horizon-e96efbfa.png?width=960&height=163" width=100>)
-Use [DisCloud](https://discloudbot.com/)! A trust-worthy Discord bot hosting service.
+Use [Discloud](https://discloudbot.com/)! A trust-worthy Discord bot hosting service.
 
 1. Login using your Discord/GitHub account, and then don't close the Dashboard tab (because we need it later).
-2. Go to your project on VSCode, create a new file `discloud.config`. This file is a configuration file for DisCloud apps servers. The `discloud.config` file content must be like the codeblock below, and remember to change **YOUR_BOT_ID** to your actual bot ID.
+2. Go to your project on VSCode, create a new file `discloud.config`. This file is a configuration file for Discloud apps servers. The `discloud.config` file content must be like the codeblock below, and remember to change **YOUR_BOT_ID** to your actual bot ID.
 
-```config
-ID = YOUR_BOT_ID
+```apache
+# Your actual bot ID below
+ID = 1234567890123456789
 TYPE = bot
 MAIN = src/index.js
 RAM = 100
@@ -114,11 +136,11 @@ API = tools
 ```
 
 3. Open explorer and navigate using the path of your project. Hold the **CTRL** key, and click on `src/`, `package.json`, and `discloud.config`. Now release the key, and right click on the selected files/folders and click on **Convert into .zip file**.
-4. Go back to the DisCloud dashboard, click on **Add App**, and then upload the .zip file in the upload box. Make sure to accept the ToS of the service and then click on **Upload**.
+4. Go back to the Discloud dashboard, click on **Add App**, and then upload the .zip file in the upload box. Make sure to accept the ToS of the service and then click on **Upload**.
 5. Wait for at least 20 seconds (depends on your Internet speed), and then your bot should be on.
 
 > **Warning**
-> DisCloud has recently made every Free plan servers into **15 days** hosting only. Use the command `.rw` from their bot in the commands channel (on their Discord server) to reset the timer to **0**.
+> Discloud has recently made every Free plan servers into **15 days** hosting only. Use the command `.rw` from their bot in the commands channel (on their Discord server) to reset the timer. Join the server: [Click here!](https://discord.gg/discloud-584490943034425391)
 
 ## Contributors
 <img src="https://contrib.rocks/image?repo=TFAGaming/DiscordJS-V14-Bot-Template">

command.example.txt

@@ -7,7 +7,8 @@ module.exports = {
     structure: {
         name: '',
         description: '',
-        aliases: ['']
+        aliases: [],
+        permissions: null
     },
     /**
      * @param {ExtendedClient} client 

package.json

@@ -1,12 +1,11 @@
 {
   "name": "discordjs-v14-bot-template",
   "version": "2.0.0",
-  "description": "",
+  "description": "The simplified Discord bot commands & events handler built with discord.js version 14 and written in JavaScript. This handler can load up to 4 different type of commands; Prefix, Slash, User context and Message context.",
   "main": "src/index.js",
   "scripts": {
     "test": "echo \"Wow is this a test?\" && exit 1",
-    "start": "node .",
-    "git": "git add . && git commit -m \"Git auto\""
+    "start": "node ."
   },
   "keywords": [],
   "author": "",

src/class/ExtendedClient.js

@@ -1,31 +1,27 @@
-const { Client, Partials, Collection } = require("discord.js");
+const { Client, Partials, Collection, GatewayIntentBits } = require("discord.js");
 const config = require('../config');
 const commands = require("../handlers/commands");
 const events = require("../handlers/events");
 const deploy = require("../handlers/deploy");
 const mongoose = require("../handlers/mongoose");
+const components = require("../handlers/components");
 
 module.exports = class extends Client {
     collection = {
         interactioncommands: new Collection(),
         prefixcommands: new Collection(),
-        aliases: new Collection()
+        aliases: new Collection(),
+        components: {
+            buttons: new Collection(),
+            selects: new Collection()
+        }
     };
     applicationcommandsArray = [];
 
     constructor() {
         super({
-            intents: [
-                'Guilds',
-                'GuildMessages',
-                'GuildMembers',
-                'MessageContent'
-            ],
-            partials: [
-                Partials.Channel,
-                Partials.User,
-                Partials.Message
-            ],
+            intents: [Object.keys(GatewayIntentBits)],
+            partials: [Object.keys(Partials)],
             presence: {
                 activities: [{
                     name: 'DiscordJS-V14-Bot-Template v2'
@@ -35,11 +31,12 @@ module.exports = class extends Client {
     };
 
     start = async () => {
-        await this.login(process.env.CLIENT_TOKEN || config.client.token);
-
         commands(this);
         events(this);
-        mongoose();
+        components(this);
+        if (config.handler.mongodb.toggle) mongoose();
+
+        await this.login(process.env.CLIENT_TOKEN || config.client.token);
 
         if (config.handler.deploy) deploy(this, config);
     };

src/commands/prefix/Info/help.js

@@ -16,10 +16,20 @@ module.exports = {
      */
     run: async (client, message, args) => {
 
-        const prefix = (await GuildSchema.findOne({ guild: message.guildId }))?.prefix || config.handler.prefix;
+        let prefix = config.handler.prefix;
 
-        const mapIntCmds = client.applicationcommandsArray.map((v) => `\`/${v.name}\`: ${v.description}`);
-        const mapPreCmds = client.collection.prefixcommands.map((v) => `\`${prefix}${v.structure.name}\` (${v.structure.aliases.length > 0 ? v.structure.aliases.map((a) => `**${a}**`).join(', ') : 'None'}): ${v.structure.description || '[No description was provided]'}`);
+        if (config.handler?.mongodb?.toggle) {
+            try {
+                const data = (await GuildSchema.findOne({ guild: message.guildId }));
+
+                prefix = data?.prefix;
+            } catch {
+                prefix = config.handler.prefix;
+            };
+        };
+
+        const mapIntCmds = client.applicationcommandsArray.map((v) => `\`/${v.name}\`: ${v.description || '(No description)'}`);
+        const mapPreCmds = client.collection.prefixcommands.map((v) => `\`${prefix}${v.structure.name}\` (${v.structure.aliases.length > 0 ? v.structure.aliases.map((a) => `**${a}**`).join(', ') : 'None'}): ${v.structure.description || '(No description)'}`);
 
         await message.reply({
             embeds: [

src/commands/prefix/Utility/ping.js

@@ -5,7 +5,8 @@ module.exports = {
     structure: {
         name: 'ping',
         description: 'Replies with Pong!',
-        aliases: ['p']
+        aliases: ['p'],
+        permissions: 'Administrator'
     },
     /**
      * @param {ExtendedClient} client 

src/commands/prefix/Utility/prefix.js

@@ -16,6 +16,14 @@ module.exports = {
      */
     run: async (client, message, args) => {
 
+        if (!config.handler?.mongodb?.toggle) {
+            await message.reply({
+                content: 'Database is not ready, this command cannot be executed.'
+            });
+
+            return;
+        };
+
         const type = args[0];
 
         switch (type) {

src/commands/slash/Info/help.js

@@ -16,10 +16,20 @@ module.exports = {
 
         await interaction.deferReply();
 
-        const prefix = (await GuildSchema.findOne({ guild: interaction.guildId }))?.prefix || config.handler.prefix;
+        let prefix = config.handler.prefix;
 
-        const mapIntCmds = client.applicationcommandsArray.map((v) => `\`/${v.name}\`: ${v.description}`);
-        const mapPreCmds = client.collection.prefixcommands.map((v) => `\`${prefix}${v.structure.name}\` (${v.structure.aliases.length > 0 ? v.structure.aliases.map((a) => `**${a}**`).join(', ') : 'None'}): ${v.structure.description || '[No description was provided]'}`);
+        if (config.handler?.mongodb?.toggle) {
+            try {
+                const data = (await GuildSchema.findOne({ guild: message.guildId }));
+
+                prefix = data?.prefix;
+            } catch {
+                prefix = config.handler.prefix;
+            };
+        };
+
+        const mapIntCmds = client.applicationcommandsArray.map((v) => `\`/${v.name}\`: ${v.description || '(No description)'}`);
+        const mapPreCmds = client.collection.prefixcommands.map((v) => `\`${prefix}${v.structure.name}\` (${v.structure.aliases.length > 0 ? v.structure.aliases.map((a) => `**${a}**`).join(', ') : 'None'}): ${v.structure.description || '(No description)'}`);
 
         await interaction.followUp({
             embeds: [

src/commands/slash/Utility/components.js

@@ -0,0 +1,40 @@
+const { ChatInputCommandInteraction, SlashCommandBuilder, ActionRowBuilder, ButtonBuilder, StringSelectMenuBuilder } = require('discord.js');
+const ExtendedClient = require('../../../class/ExtendedClient');
+
+module.exports = {
+    structure: new SlashCommandBuilder()
+        .setName('components')
+        .setDescription('Test the components handler.'),
+    /**
+     * @param {ExtendedClient} client 
+     * @param {ChatInputCommandInteraction} interaction 
+     * @param {[]} args 
+     */
+    run: async (client, interaction, args) => {
+
+        await interaction.reply({
+            content: 'Select one of the components below.',
+            components: [
+                new ActionRowBuilder()
+                    .addComponents(
+                        new ButtonBuilder()
+                            .setCustomId('example-button')
+                            .setLabel('Example Button')
+                            .setStyle(1)
+                    ),
+                new ActionRowBuilder()
+                    .addComponents(
+                        new StringSelectMenuBuilder()
+                            .setCustomId('example-select')
+                            .setPlaceholder('Example Select menu')
+                            .addOptions(
+                                { label: 'Option 1', value: 'option 1' },
+                                { label: 'Option 2', value: 'option 2' },
+                                { label: 'Option 3', value: 'option 3' },
+                            )
+                    )
+            ]
+        });
+
+    }
+};

src/components/button/example-button.js

@@ -0,0 +1,19 @@
+const { ButtonInteraction } = require('discord.js');
+const ExtendedClient = require('../../class/ExtendedClient');
+
+module.exports = {
+    customId: 'example-button',
+    /**
+     * 
+     * @param {ExtendedClient} client 
+     * @param {ButtonInteraction} interaction 
+     */
+    run: async (client, interaction) => {
+
+        await interaction.reply({
+            content: 'The button has been successfully responded!',
+            ephemeral: true
+        });
+
+    }
+};

src/components/select/example-select.js

@@ -0,0 +1,21 @@
+const { StringSelectMenuInteraction } = require('discord.js');
+const ExtendedClient = require('../../class/ExtendedClient');
+
+module.exports = {
+    customId: 'example-select',
+    /**
+     * 
+     * @param {ExtendedClient} client 
+     * @param {StringSelectMenuInteraction} interaction 
+     */
+    run: async (client, interaction) => {
+
+        const value = interaction.values[0];
+        
+        await interaction.reply({
+            content: `You have selected from the menu: **${value}**`,
+            ephemeral: true
+        });
+
+    }
+};

src/events/Guild/components.js

@@ -0,0 +1,42 @@
+const config = require('../../config');
+const { log } = require('../../functions');
+const ExtendedClient = require('../../class/ExtendedClient');
+
+module.exports = {
+    event: 'interactionCreate',
+    /**
+     * 
+     * @param {ExtendedClient} client 
+     * @param {import('discord.js').Interaction} interaction 
+     * @returns 
+     */
+    run: (client, interaction) => {
+        if (interaction.isButton()) {
+            const component = client.collection.components.buttons.get(interaction.customId);
+
+            if (!component) return;
+
+            try {
+                component.run(client, interaction);
+            } catch (error) {
+                log(error, 'error');
+            }
+
+            return;
+        };
+
+        if (interaction.isAnySelectMenu()) {
+            const component = client.collection.components.selects.get(interaction.customId);
+
+            if (!component) return;
+
+            try {
+                component.run(client, interaction);
+            } catch (error) {
+                log(error, 'error');
+            }
+
+            return;
+        };
+    },
+};

src/events/Guild/interactionCreate.js

@@ -1,8 +1,15 @@
 const config = require('../../config');
 const { log } = require('../../functions');
+const ExtendedClient = require('../../class/ExtendedClient');
 
 module.exports = {
     event: 'interactionCreate',
+    /**
+     * 
+     * @param {ExtendedClient} client 
+     * @param {import('discord.js').Interaction} interaction 
+     * @returns 
+     */
     run: (client, interaction) => {
         if (config.handler.commands.slash === false && interaction.isChatInputCommand()) return;
         if (config.handler.commands.user === false && interaction.isUserContextMenuCommand()) return;