Initial commit: Advanced Discord.js v14 Bot Template

Author: arpandevv

.env.example

@@ -0,0 +1,13 @@
+# Discord Bot Configuration
+# Get your token and client ID from: https://discord.com/developers/applications
+DISCORD_TOKEN=your_bot_token_here
+CLIENT_ID=your_client_id_here
+
+# Optional: Guild ID for instant command deployment to a specific server.
+# If left empty, commands will be deployed globally (can take up to an hour to update).
+GUILD_ID=your_guild_id_here
+
+# MongoDB Connection String (Optional)
+# Example: mongodb+srv://user:pass@cluster.mongodb.net/database
+# If left empty, database features will be disabled.
+MONGODB_URI=your_mongodb_uri_here

.gitignore

@@ -0,0 +1,14 @@
+# Dependencies
+node_modules/
+package-lock.json
+
+# Environment Variables
+.env
+
+# Logs
+Logs/
+*.log
+
+# System Files
+.DS_Store
+Thumbs.db

Commands/Fun/8ball.js

@@ -0,0 +1,44 @@
+const { SlashCommandBuilder } = require('discord.js');
+const Embeds = require('../../Utils/Embeds');
+
+module.exports = {
+    cooldown: 3,
+    data: new SlashCommandBuilder()
+        .setName('8ball')
+        .setDescription('Ask the magic 8-ball a question.')
+        .addStringOption(option =>
+            option.setName('question')
+                .setDescription('The question you want to ask')
+                .setRequired(true)),
+    async execute(interaction) {
+        const responses = [
+            'It is certain.',
+            'It is decidedly so.',
+            'Without a doubt.',
+            'Yes – definitely.',
+            'You may rely on it.',
+            'As I see it, yes.',
+            'Most likely.',
+            'Outlook good.',
+            'Yes.',
+            'Signs point to yes.',
+            'Reply hazy, try again.',
+            'Ask again later.',
+            'Better not tell you now.',
+            'Cannot predict now.',
+            'Concentrate and ask again.',
+            "Don't count on it.",
+            'My reply is no.',
+            'My sources say no.',
+            'Outlook not so good.',
+            'Very doubtful.'
+        ];
+
+        const question = interaction.options.getString('question');
+        const answer = responses[Math.floor(Math.random() * responses.length)];
+
+        await interaction.reply({
+            embeds: [Embeds.info(`**Question:** ${question}\n**Answer:** ${answer}`, '🔮 Magic 8-Ball')]
+        });
+    },
+};

Commands/Fun/joke.js

@@ -0,0 +1,24 @@
+const { SlashCommandBuilder } = require('discord.js');
+const axios = require('axios');
+const Embeds = require('../../Utils/Embeds');
+const logger = require('../../Utils/Logger');
+
+module.exports = {
+    cooldown: 5,
+    data: new SlashCommandBuilder()
+        .setName('joke')
+        .setDescription('Tells a random joke.'),
+    async execute(interaction) {
+        try {
+            const response = await axios.get('https://official-joke-api.appspot.com/random_joke');
+            const { setup, punchline } = response.data;
+
+            await interaction.reply({
+                embeds: [Embeds.info(`${setup}\n\n*${punchline}*`, '😂 Random Joke')]
+            });
+        } catch (error) {
+            logger.error('Error fetching joke:', error);
+            await interaction.reply({ embeds: [Embeds.error('Failed to fetch a joke. Please try again later.')], ephemeral: true });
+        }
+    },
+};

Commands/Moderation/ban.js

@@ -0,0 +1,31 @@
+const { SlashCommandBuilder, PermissionFlagsBits } = require('discord.js');
+const Embeds = require('../../Utils/Embeds');
+
+module.exports = {
+    userPermissions: [PermissionFlagsBits.BanMembers],
+    data: new SlashCommandBuilder()
+        .setName('ban')
+        .setDescription('Bans a member from the server.')
+        .addUserOption(option =>
+            option.setName('target')
+                .setDescription('The member to ban')
+                .setRequired(true))
+        .addStringOption(option =>
+            option.setName('reason')
+                .setDescription('The reason for banning')),
+    async execute(interaction) {
+        const target = interaction.options.getMember('target');
+        const reason = interaction.options.getString('reason') ?? 'No reason provided';
+
+        if (!target) {
+            return interaction.reply({ embeds: [Embeds.error('Could not find that member.')], ephemeral: true });
+        }
+
+        if (!target.bannable) {
+            return interaction.reply({ embeds: [Embeds.error('I cannot ban this member. They might have a higher role than me.')], ephemeral: true });
+        }
+
+        await target.ban({ reason });
+        await interaction.reply({ embeds: [Embeds.success(`Successfully banned **${target.user.tag}** for: ${reason}`)] });
+    },
+};

Commands/Moderation/kick.js

@@ -0,0 +1,31 @@
+const { SlashCommandBuilder, PermissionFlagsBits } = require('discord.js');
+const Embeds = require('../../Utils/Embeds');
+
+module.exports = {
+    userPermissions: [PermissionFlagsBits.KickMembers],
+    data: new SlashCommandBuilder()
+        .setName('kick')
+        .setDescription('Kicks a member from the server.')
+        .addUserOption(option =>
+            option.setName('target')
+                .setDescription('The member to kick')
+                .setRequired(true))
+        .addStringOption(option =>
+            option.setName('reason')
+                .setDescription('The reason for kicking')),
+    async execute(interaction) {
+        const target = interaction.options.getMember('target');
+        const reason = interaction.options.getString('reason') ?? 'No reason provided';
+
+        if (!target) {
+            return interaction.reply({ embeds: [Embeds.error('Could not find that member.')], ephemeral: true });
+        }
+
+        if (!target.kickable) {
+            return interaction.reply({ embeds: [Embeds.error('I cannot kick this member. They might have a higher role than me.')], ephemeral: true });
+        }
+
+        await target.kick(reason);
+        await interaction.reply({ embeds: [Embeds.success(`Successfully kicked **${target.user.tag}** for: ${reason}`)] });
+    },
+};

Commands/Moderation/purge.js

@@ -0,0 +1,30 @@
+const { SlashCommandBuilder, PermissionFlagsBits } = require('discord.js');
+const Embeds = require('../../Utils/Embeds');
+
+module.exports = {
+    userPermissions: [PermissionFlagsBits.ManageMessages],
+    data: new SlashCommandBuilder()
+        .setName('purge')
+        .setDescription('Deletes a specified amount of messages.')
+        .addIntegerOption(option =>
+            option.setName('amount')
+                .setDescription('Amount of messages to delete (1-100)')
+                .setMinValue(1)
+                .setMaxValue(100)
+                .setRequired(true)),
+    async execute(interaction) {
+        const amount = interaction.options.getInteger('amount');
+
+        await interaction.channel.bulkDelete(amount, true).then(messages => {
+            interaction.reply({
+                embeds: [Embeds.success(`Successfully deleted \`${messages.size}\` messages.`)],
+                ephemeral: true
+            });
+        }).catch(err => {
+            interaction.reply({
+                embeds: [Embeds.error('There was an error trying to purge messages in this channel!')],
+                ephemeral: true
+            });
+        });
+    },
+};

Commands/Utility/help.js

@@ -0,0 +1,23 @@
+const { SlashCommandBuilder, EmbedBuilder } = require('discord.js');
+
+module.exports = {
+    cooldown: 10,
+    data: new SlashCommandBuilder()
+        .setName('help')
+        .setDescription('List all available commands.'),
+    async execute(interaction, client) {
+        const embed = new EmbedBuilder()
+            .setTitle('📚 Bot Commands')
+            .setDescription('Here is a list of all available slash commands:')
+            .setColor('#3498DB')
+            .setTimestamp();
+
+        client.commands.forEach(command => {
+            const name = command.data.name;
+            const description = command.data.description;
+            embed.addFields({ name: `/${name}`, value: description, inline: true });
+        });
+
+        await interaction.reply({ embeds: [embed] });
+    },
+};

Commands/Utility/ping.js

@@ -0,0 +1,19 @@
+const { SlashCommandBuilder } = require('discord.js');
+const Embeds = require('../../Utils/Embeds');
+
+module.exports = {
+    cooldown: 5,
+    data: new SlashCommandBuilder()
+        .setName('ping')
+        .setDescription('Replies with Pong and latency!'),
+    async execute(interaction, client) {
+        const sent = await interaction.reply({ content: 'Pinging...', fetchReply: true });
+        const latency = sent.createdTimestamp - interaction.createdTimestamp;
+        const apiLatency = Math.round(client.ws.ping);
+
+        await interaction.editReply({
+            content: null,
+            embeds: [Embeds.success(`🏓 Pong!\n\n**Latency:** \`${latency}ms\`\n**API Latency:** \`${apiLatency}ms\``)]
+        });
+    },
+};

Commands/Utility/search.js

@@ -0,0 +1,26 @@
+const { SlashCommandBuilder } = require('discord.js');
+
+module.exports = {
+    cooldown: 5,
+    data: new SlashCommandBuilder()
+        .setName('search')
+        .setDescription('Example command with autocomplete.')
+        .addStringOption(option =>
+            option.setName('query')
+                .setDescription('The item to search for')
+                .setAutocomplete(true)
+                .setRequired(true)),
+    async autocomplete(interaction) {
+        const focusedValue = interaction.options.getFocused();
+        const choices = ['Apple', 'Banana', 'Cherry', 'Date', 'Elderberry', 'Fig', 'Grape'];
+        const filtered = choices.filter(choice => choice.toLowerCase().startsWith(focusedValue.toLowerCase()));
+
+        await interaction.respond(
+            filtered.map(choice => ({ name: choice, value: choice })),
+        );
+    },
+    async execute(interaction) {
+        const query = interaction.options.getString('query');
+        await interaction.reply(`You searched for: **${query}**`);
+    },
+};