djs-builder

Welcome to the Discord Bot Utilities package! 🥏

Table of Contents

• Starter
• Function
• Command

🎯 STARTER

Starter provides functionality for initializing and starting a Discord bot 🤖.

Features:

• 🛠️ Handler for slash and prefix commands all in just two lines 🔩
• 📜 A list displaying all information(number of commands, events, and comprehensive bot) 🔍
• 🧰 Event handler in just one line 🎊
• ⚠️ Anti-crash system with error lock 📃
• 🔋 Direct connection with MongoDB 📥
• 📑 Logging for slash and prefix command usage with comprehensive information 🧭

💡 Tip: Any option you don't want, just DELETE 🗑️ the option .

Starter ⚙️

   const { starter } = require("djs-builder");

const { Client, GatewayIntentBits } = require("discord.js");
const client = new Client({
  intents: Object.keys(GatewayIntentBits).map((a) => {
    return GatewayIntentBits[a];
  }),
});

// Define starter options
const starterOptions = {
  bot: {
    token: "YOUR_BOT_TOKEN", // [OPTIONAL] Discord bot token
    ownerId: "YOUR_USER_ID",
  },
  terminal: true,
  Status: {
    status: "online", // Required: Bot presence state ['online', 'offline', 'dnd', 'idle', 'Streaming']
    activities: ["Game 1", "Game 2"], // [OPTIONAL] Bot activities
    type: 0, // [OPTIONAL] Bot activity type
    time: 60000, // [OPTIONAL] Activity rotation delay in milliseconds
  },
  database: {
    url: "mongodb://localhost:27017", // Required: MongoDB connection URI
  },

  slash: {
    path: "./path/to/slash_commands", // Required: Path to slash commands
    log: "", // id of log channel
  },
  prefix: {
    path: "./path/to/prefixes", // Required: Path to prefix settings
    prefix: "!", // Required: Default bot prefix
    log: "", // id of log channel
    custom_prefix: {
      id : prefix,
      id : prefix,
    } // select prefix for servers
  },
  events: {
    path: "./path/to/events", // Required: Path to event handlers
  },
  anticrash: {
    url: "https://your.crash.webhook.url", // Required: Webhook URL for crash alerts
    mention_id: "YOUR_USER_ID", // [OPTIONAL] User ID to mention in crash alerts
  },
};

await starter(client, starterOptions);

⚙️ function

• Easyest ✨
• Fastest ⚡
• Clear 🧵

Than the discord.js

CreateRow 🔵

🔵 CreateRow is a utility for managing the creation of Discord Row ✨.

const { CreateRow } = require('djs-builder');

const actionRow = new CreateRow([

//// for any row add new [] or {}
// for buttom
[
      {
    id: 'button1', //  ID for the button customId
    style: 1,  // style: Primary(1), Secondary(2), Success(3), Danger(4), Link(5)
    label: 'Primary Button',
    emoji: '😃',  // Emoji for the button
    enabled: false,  // Whether the button is disabled
  },
  {
    id: 'button2',
    style: 2,
    emoji: '🚀',
    enabled: true,
  }
], ///// now it is row 1 for button and you can add more rows
{
    type : "string" /// you can select from ["role" , "user" , "channel" ]
    options : {
        id: "menu", // ID for the select menu customId
        placeholder: "Select an option", // Placeholder text for the select menu
        min: 1, // Minimum number of selected values
        max: 2, // Maximum number of selected values
        data: [ // you shuld add your options (it not work for role , user and channel)
          { name: 'Option 1', id: 'option1', about: 'Description for Option 1', icon: '🌟' },
          { name: 'Option 2', id: 'option2', about: 'Description for Option 2', icon: '🚀' },
          { name: 'Option 3', id: 'option3', about: 'Description for Option 3', icon: '🔗' },
        ],  //// is should not look like this ,you selecit it in next step
        value: "id", // here you can set the value of the selected option ( defult the value is will be index (0,1,2 .....) )
        description: "about", // here you can set the description of the selected option ( defult the description not work )
        label: "name", // here you can set the label of the selected option ( defult the label is (Option 1 , Option 2 , Option 3) )
        emoji: "icon" // here you can set the emoji of the selected option ( defult the emoji not work )

    }
}
]);

CreateBar 🧾

🧾 CreateBar it ✨.

const { CreateBar } = require("djs-builder");

const menu = new CreateBar(0, 100, {
  lenth: 20,
  fill: "✅",
  empty: "❌",
  partialChar: "⏳",
  showPercent: true,
  left: "[",
  right: "]",
});

you can do any type of bar you want like

createProgressBar(3.7, 5, {
  filledChar: '🟦',
  emptyChar: '⬛',
  partialChar: '🟨',
  leftEdge: '❰',
  rightEdge: '❱',
  precision: 1
});
// ❰🟦🟦🟦🟨⬛❱ 74.0%



console.log(createProgressBar(7, 10, {
  length: 20,
  filledChar: '💚',
  emptyChar: '🖤',
}));



[💚💚💚💚💚💚💚🖤🖤🖤🖤🖤🖤🖤🖤🖤🖤🖤🖤] 70%

Wait ⏰

⏰ Wait insted of collecter 🤮 ✨.

const { Wait } =  require('djs-builder');

const message = await Wait({
    context: message, /// message or interaction
    userId : (message.author.id || interaction.user.id), /// user id
     type: "interaction", /// message to wait message or interaction to wait button/menu or both 💪
      time: 30000 /// time in ms
      message_Wait : message /// message of button (for button or both)
       });

log 📸

📸 Log For All Discord Events ✨.

const { log } = require("djs-builder");

module.exports = {
  name: "clientReady",
  async run(client) {
    await log(
      client,
      "YOUR_GUILD_ID", /// your guild id
      "YOUR_CHANNEL_ID" /// your log channel id
    );
  },
};

GetUser 👤

👤 Utility function to get a member from a message ✨.

const data = await GetUser(message);

📦 What does it return?

{
  user: <GuildMember>,        // 🎯 The targeted member
  args: [ "word1", "word2" ]  // ✍️ Remaining args after mention/ID
}

📌 How does it detect the user?

• Mention inside the message

  Example: !ban @Ahmed Breaking rules.

• User ID directly

  Example: !ban 123456789012345678 Spamming.

• Reply to someone’s message

  Reply to a user’s message with: !ban.

🛠️ Example usage (ban command) 🚫

client.on("messageCreate", async (message) => {
  if (!message.content.startsWith("!ban")) return;

  const data = await GetUser(message);
  if (!data) return message.reply("❌ Couldn't find this user.");

  const member = data.user;
  const reason = data.args.join(" ") || "No reason provided";

  await member.ban({ reason });
  message.reply(`🚫 ${member.user.tag} has been banned for: ${reason}`);
});

Contributions

Contributions are welcome! If you have any suggestions, bug reports, or feature requests, feel free to contact us on discord.