djs-builder 0.6.401 → 0.7.1-8.1

package/README.md

@@ -5,13 +5,16 @@
 **Welcome to the ultimate Discord Bot Utilities package! 🥏**
 Boost your Discord bot development with ease, speed, and all-in-one features.
 
+[![Discord Banner](https://api.weblutions.com/discord/invite/uYcKCZk3/)](https://discord.gg/uYcKCZk3)
+
 ---
 
 ## 📑 Table of Contents
 
-1. 🎯 [Starter](#starter) – Initialize your bot with commands, events, presence, and more.
-2. ⚙️ [Functions](#function) – Utilities like CreateRow, CreateBar, Wait, and GetUser.
-3. ⚡ [Commands & Events](#commands--events) – Easy setup with cooldowns, permissions, logging, and anti-crash.
+1. 🎯 [Starter](#-starter) – Initialize your bot with commands, events, presence, and more.
+2. ⚙️ [Functions](#%EF%B8%8F-functions) – Utilities like CreateRow, CreateBar, Wait, and GetUser.
+3. ⚡ [Commands & Events](#-commands--events) – Easy setup with cooldowns, permissions, logging, and anti-crash.
+4. 🌐 [Dashboard](#-dashboard) – Web-based control panel for managing your bot.
 
 ---
 
@@ -63,12 +66,21 @@ const starterOptions = {
 
   database: {
     url: "mongodb://localhost:27017", // 💾 MongoDB connection
+    dbName: "yourDatabaseName", // 📁 Optional: Specify database name (default: "test")
   },
 
   anticrash: {
     url: "https://your.crash.webhook.url", // 🚨 Webhook for crash reports
     mention_id: "YOUR_USER_ID", // 📣 Optional: mention user on crash
   },
+
+  // 🌐 Dashboard Configuration (Full docs at the end of this page)
+  dashboard: {
+    clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
+    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
+    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
+    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
+  },
 };
 
 // Start the bot
@@ -90,6 +102,7 @@ await starter(client, starterOptions);
 
 - Connects automatically to MongoDB 💾.
 - Useful for bots with persistent data storage.
+- Specify the database name using the `dbName` option. If not specified, MongoDB uses "test" as the default database name.
 
 #### 3️⃣ Anticrash System
 
@@ -130,6 +143,14 @@ await starter(client, starterOptions);
 
 - Available via `client.files`, useful for debugging or terminal display 🛠️.
 
+#### 7️⃣ Dashboard (Web Control Panel)
+
+- Launches a **modern web-based control panel** for your bot 🌐.
+- Supports Discord OAuth2 authentication 🔐.
+- Manage servers, levels, giveaways, and blacklists from the browser 🎛️.
+
+> 📖 **Full Dashboard documentation available at the end of this page** → [🌐 DASHBOARD](#-dashboard)
+
 ---
 
 ### 💡 Tips
@@ -190,6 +211,12 @@ const actionRow = new CreateRow([
       emoji: "🚀",
       disabled: true, // Button is disabled
     },
+    {           
+      style: 5,
+      label: "link",
+      emoji: "🔗" 
+      url : "https://discord.gg/z9GpYsYF" // for url button
+    }
   ],
 
   // 🔹 Row #2: Select Menu
@@ -224,7 +251,7 @@ const actionRow = new CreateRow([
       disabled: false, // Disable the entire menu
       defaultValues: [
         // For role/user/channel menus
-        { id: "123456789012345678", type: "user" }, // Pre-selected
+        { id: "123456789012345678" }, // Pre-selected
       ],
       channelTypes: [0, 2], // Only for ChannelSelectMenu (0 = Text, 2 = Voice)
     },
@@ -243,6 +270,7 @@ const actionRow = new CreateRow([
 - `label` → Button text
 - `emoji` → Displayed emoji
 - `disabled` → true = button is unclickable
+- `url` → requiier for like button (style : 5)
 
 #### 🔹 Select Menus
 
@@ -376,166 +404,1922 @@ console.log(
 ---
 
 <details>
-<summary>Wait ⏰</summary>
+<summary>CreateModal 🔳</summary>
 
-**⏰ Wait – Await messages, buttons, select menus or modals easily ✨**
+**🔳 CreateModal – Easily create Discord Modals with Text Inputs, Menus, Files, and Labels ✨**
 
-`Wait` is a replacement for traditional collectors. It supports:
+`CreateModal` is a powerful utility to build Discord **Modals**. It supports:
 
-- Awaiting **messages** 📝
-- Awaiting **interactions** (buttons / select menus) 🎛️
-- Awaiting **modal submissions** 📋
-- Filtering by **user** and timeout
+- **Text Inputs** 📝
+- **Select Menus** 🎯 (`string`, `role`, `user`, `channel`)
+- **File Uploads** 📎
+- **Text Displays** 🏷️
 
 ---
 
 ### 📌 Example Usage:
 
 ```js
-const { Wait } = require("djs-builder");
+const { CreateModal } = require("djs-builder");
 
-const response = await Wait({
-  context: message, // Message or Interaction object
-  userId: message.author.id, // Optional: filter by user
-  type: "both", // "message" | "interaction" | "both"
-  time: 30000, // Time in ms
-  message_Wait: message, // Required if waiting for buttons/selects
+const modal = CreateModal({
+  id: "myModal",
+  title: "User Information",
+  components: [
+    {
+      type: "textInput",
+      components: [
+        {
+          label: "Your Name",
+          id: "name",
+          style: 1, // 1: Short, 2: Paragraph
+          placeholder: "Enter your name",
+          required: true,
+          minLength: 2,
+          maxLength: 50,
+        },
+      ],
+    },
+    {
+      type: "menu",
+      components: {
+        type: "string",
+        options: {
+          id: "favoriteColor",
+          placeholder: "Choose your favorite color",
+          min: 1,
+          max: 1,
+          data: [
+            {
+              label: "Red",
+              value: "red",
+              description: "A bold color",
+              emoji: "🔴",
+              default: false,
+            },
+            {
+              label: "Blue",
+              value: "blue",
+              description: "A calm color",
+              emoji: "🔵",
+            },
+          ],
+          label: "label",
+          value: "value",
+          description: "description",
+          emoji: "emoji",
+          disabled: false,
+        },
+      },
+    },
+    {
+      type: "file",
+      components: {
+        id: "avatar",
+        label: "Upload Avatar",
+        description: "Optional avatar image",
+      },
+    },
+    {
+      type: "text",
+      components: {
+        content: "Thank you for your input!",
+      },
+    },
+  ],
 });
 
-if (!response) return console.log("⏱️ Timeout!");
-console.log("✅ Collected:", response);
+// Show the modal
+await interaction.showModal(modal);
 ```
 
 ---
 
-### 🔹 Options
+### 📔 Examples for Each Component Type:
 
-- `context` → The message or interaction context
-- `userId` → Only collect from this user (optional)
-- `type` → `"message" | "interaction" | "both"`
-- `time` → Timeout in milliseconds
-- `message_Wait` → Message containing buttons/select menus (for interaction/both type)
+#### 🔹 Text Input Example:
+
+```js
+{
+  type: "textInput",
+  components: [
+    {
+      label: "Your Age",
+      id: "age",
+      style: 1, // Short input
+      placeholder: "Enter your age",
+      required: true,
+      minLength: 1,
+      maxLength: 3,
+      value: "18", // Pre-filled
+    },
+  ],
+},
+```
+
+#### 🔹 Menu Example:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "country",
+      mine_label: "Choose Your Country", // Label displayed above the menu
+      mine_description: "Please select your country from the list below", // Optional description
+      placeholder: "Select your country",
+      min: 1,
+      max: 1,
+      data: [
+        {
+          name: "USA",
+          id: "usa",
+          desc: "United States",
+          icon: "🇺🇸",
+          default: true, // This option is pre-selected
+        },
+        {
+          name: "Canada",
+          id: "canada",
+          desc: "Canada",
+          icon: "🇨🇦",
+        },
+      ],
+      label: "name", // Maps to 'name' field in data
+      value: "id",   // Maps to 'id' field in data
+      description: "desc", // Maps to 'desc' field
+      emoji: "icon", // Maps to 'icon' field
+      disabled: false,
+    },
+  },
+},
+```
+
+#### 🔹 File Example:
+
+```js
+{
+  type: "file",
+  components: {
+    id: "document",
+    label: "Upload Document",
+    description: "Upload a PDF or image",
+  },
+},
+```
+
+#### 🔹 Label Example:
+
+```js
+{
+  type: "text",
+  components: {
+    content: "Please fill out the form above.",
+  },
+},
+```
+
+---
+
+### �📖 Explanation
+
+#### 🔹 Text Input
+
+- `label` → Label for the input field
+- `id` → customId for the input
+- `style` → 1: Short, 2: Paragraph
+- `placeholder` → Placeholder text
+- `required` → true/false
+- `minLength` / `maxLength` → Min/Max characters
+- `value` → Pre-filled value
+
+#### 🔹 Menu
+
+Same as CreateRow select menus.
+
+- `type` → `"string" | "user" | "role" | "channel"`
+- `id` → customId for menu
+- `mine_label` → Label displayed above the menu component (defaults to "Select an option")
+- `mine_description` → Description text displayed below the menu label (optional)
+- `placeholder` → Text shown before selection
+- `min` / `max` → Min/Max selectable values
+- `data` → Options array (for string select only)
+
+  - `label` → Visible text (maps to the field specified in `label` key)
+  - `value` → Internal value (maps to the field specified in `value` key)
+  - `description` → Short description (maps to the field specified in `description` key)
+  - `emoji` → Option emoji (maps to the field specified in `emoji` key)
+  - `default` → Pre-selected option (true/false in data array)
+
+- `label` → Key in data to use as label (e.g., "name")
+- `value` → Key in data to use as value (e.g., "id")
+- `description` → Key in data to use as description (e.g., "desc")
+- `emoji` → Key in data to use as emoji (e.g., "icon")
+- `disabled` → Disable menu completely
+- `defaultValues` → Pre-selected user/role/channel options (for non-string menus)
+- `channelTypes` → Restrict selectable channel types (for channel menu)
+
+#### 🔹 File
+
+- `id` → customId for the file upload
+- `label` → Label
+- `description` → Description
+
+#### 🔹 text
+
+- `content` → Text to display
 
 ---
 
 ### 🔹 Notes
 
-- Supports **automatic cleanup** of collectors after completion
-- Can return **Message**, **Interaction**, or **ModalSubmitInteraction**
+- Supports multiple components in one modal
+- Fully customizable with Discord.js ModalBuilder
 
 </details>
 
 ---
 
 <details>
-<summary>GetUser 👤</summary>
+<summary>CreateComponents 🧩</summary>
 
-**👤 GetUser – Fetch a GuildMember easily from a message ✨**
+**🧩 CreateComponents – Build Advanced Discord UI Components with Containers, Sections & Media ✨**
 
-`GetUser` helps to detect a **target member** in multiple ways:
+`CreateComponents` is a powerful utility to build Discord's **new UI components**. It supports:
 
-1. Mention (`@User`)
-2. User ID (`123456789012345678`)
-3. Reply to another message
+- **Text Displays** 📝
+- **Separators** ➖
+- **Media Galleries** 🖼️
+- **File Attachments** 📎
+- **Buttons** 🔘
+- **Select Menus** 🎯 (`string`, `role`, `user`, `channel`)
+- **Sections with Accessories** 📦 (Thumbnails & Buttons)
+- **Containers** 📦 (Group all components together)
 
 ---
 
-### 📌 Example Usage:
+### 📌 Example Usage (Array Mode):
+
+```js
+const { CreateComponents } = require("djs-builder");
+
+const components = await CreateComponents("array", [
+  {
+    type: "text",
+    content: "Welcome to our server! 🎉",
+  },
+  {
+    type: "separator",
+    divider: true,
+    spacing: 1, // 1: Small, 2: Large
+  },
+  {
+    type: "media",
+    links: [
+      "https://example.com/image1.png",
+      {
+        url: "https://example.com/image2.png",
+        description: "A cool image",
+        spoiler: true,
+      },
+    ],
+  },
+  {
+    type: "button",
+    components: [
+      {
+        id: "btn_1",
+        style: 1, // 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
+        label: "Click Me!",
+        emoji: "🚀",
+      },
+      {
+        id: "btn_2",
+        style: 3,
+        label: "Confirm",
+      },
+    ],
+  },
+]);
+
+// Send the components
+await channel.send({ 
+   flags: 32768,
+   components : components
+ });
+```
+
+---
+
+### 📌 Example Usage (Container Mode):
+
+```js
+const { CreateComponents } = require("djs-builder");
+
+const components = await CreateComponents(true, [
+  {
+    type: "text",
+    content: "# 📢 Server Announcement\nWelcome everyone!",
+  },
+  {
+    type: "separator",
+    divider: true,
+  },
+  {
+    type: "section",
+    content: "Check out our latest updates and news!",
+    accessory: {
+      type: "thumbnail",
+      url: "https://example.com/thumbnail.png",
+      description: "News Image",
+    },
+  },
+  {
+    type: "section",
+    content: "**Click below to get your roles!**",
+    accessory: {
+      type: "button",
+      id: "get_roles",
+      style: 1,
+      label: "Get Roles",
+      emoji: "🎭",
+    },
+  },
+  {
+    type: "media",
+    links: ["https://example.com/banner.png"],
+  },
+  {
+    type: "button",
+    components: [
+      { id: "rules", style: 2, label: "📜 Rules", emoji: "📜" },
+      { id: "help", style: 2, label: "❓ Help", emoji: "❓" },
+      { style: 5, label: "🌐 Website", url: "https://example.com" },
+    ],
+  },
+]);
+
+// Send with container
+await channel.send({ components, flags: 32768 }); // flags for components v2
+```
+
+---
+
+### 📜 Examples for Each Component Type:
+
+---
+
+<details>
+<summary>🔹 Text Component Examples</summary>
+
+#### 📌 Simple Text:
+
+```js
+{
+  type: "text",
+  content: "Hello World! 👋",
+}
+```
+
+#### 📌 Text with Markdown:
+
+```js
+{
+  type: "text",
+  content: "# 📢 Announcement\n**Important:** Server maintenance tonight!",
+}
+```
+
+#### 📌 Text with Multiple Lines:
+
+```js
+{
+  type: "text",
+  content: `## 🎮 Game Stats
+  
+**Player:** Ahmed
+**Level:** 50
+**XP:** 12,500 / 15,000
+**Rank:** Diamond 💎`,
+}
+```
+
+#### 📌 Text with Emojis & Formatting:
+
+```js
+{
+  type: "text",
+  content: ">>> 💡 **Tip:** Use `/help` to see all commands!\n\n*This message will auto-delete in 30 seconds*",
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>➖ Separator Component Examples</summary>
+
+**➖ Separator – Add spacing and dividers between components**
+
+The separator component allows you to add visual breaks between other components with customizable spacing and divider lines.
+
+---
+
+### 📖 Separator Options
+
+| Option    | Type      | Default | Description                                        |
+| --------- | --------- | ------- | -------------------------------------------------- |
+| `type`    | `string`  | —       | Must be `"separator"`                              |
+| `divider` | `boolean` | `false` | Show a horizontal dividing line                    |
+| `spacing` | `number`  | `1`     | Spacing size: `1` (Small) or `2` (Large)           |
+
+---
+
+#### 📌 Simple Divider Line:
+
+```js
+{
+  type: "separator",
+  divider: true,
+}
+```
+**Result:** A thin horizontal line appears between components.
+
+---
+
+#### 📌 Separator without Line (Spacing Only):
+
+```js
+{
+  type: "separator",
+  divider: false,
+  spacing: 2, // Large spacing
+}
+```
+**Result:** Empty space without any visible line - useful for visual grouping.
+
+---
+
+#### 📌 Small Spacing with Divider:
+
+```js
+{
+  type: "separator",
+  divider: true,
+  spacing: 1, // Small spacing (default)
+}
+```
+**Result:** A divider line with minimal padding above and below.
+
+---
+
+#### 📌 Large Spacing with Divider:
+
+```js
+{
+  type: "separator",
+  divider: true,
+  spacing: 2, // Large spacing
+}
+```
+**Result:** A divider line with more padding - creates stronger visual separation.
+
+---
+
+### 💡 When to Use Each Option:
+
+| Scenario                              | `divider` | `spacing` |
+| ------------------------------------- | --------- | --------- |
+| Separate major sections               | `true`    | `2`       |
+| Separate sub-sections                 | `true`    | `1`       |
+| Group related items visually          | `false`   | `1`       |
+| Create breathing room between content | `false`   | `2`       |
+| Minimal separation                    | `false`   | `1`       |
+
+</details>
+
+---
+
+<details>
+<summary>🖼️ Media Gallery Examples</summary>
+
+**🖼️ Media Gallery – Display images in a beautiful gallery format**
+
+The media component creates an image gallery that can display one or multiple images. Each image can be a simple URL string or a detailed object with additional options.
+
+
+---
+
+### 📌 Format 1: Simple String URLs
+
+The simplest way - just pass image URLs as strings:
+
+```js
+{
+  type: "media",
+  links: ["https://example.com/image.png"],
+}
+```
+
+---
+
+### 📌 Format 2: Object with Full Options
+
+For more control, use objects with url, description, and spoiler:
+
+```js
+{
+  type: "media",
+  links: [
+    {
+      url: "https://example.com/image.png",
+      description: "A beautiful sunset",
+      spoiler: false,
+    },
+  ],
+}
+```
+
+---
+
+### 📌 Single Image with Spoiler:
+
+```js
+{
+  type: "media",
+  links: [
+    {
+      url: "https://example.com/spoiler.png",
+      description: "⚠️ Spoiler Alert!",
+      spoiler: true,
+    },
+  ],
+}
+```
+
+---
+
+### 📌 Multiple Images (Simple Strings):
+
+```js
+{
+  type: "media",
+  links: [
+    "https://example.com/image1.png",
+    "https://example.com/image2.png",
+    "https://example.com/image3.png",
+    "https://example.com/image4.png",
+  ],
+}
+```
+**Result:** A 2x2 gallery grid of images.
+
+---
+
+### 📌 Mixed Format (Strings + Objects):
+
+You can mix simple strings with detailed objects in the same array:
+
+```js
+{
+  type: "media",
+  links: [
+    // Simple string - just the URL
+    "https://example.com/public-image.png",
+    
+    // Object with description
+    {
+      url: "https://example.com/special-image.png",
+      description: "Limited Edition Art",
+    },
+    
+    // Object with spoiler
+    {
+      url: "https://example.com/secret-image.png",
+      description: "Secret Content",
+      spoiler: true,
+    },
+    
+    // Another simple string
+    "https://example.com/another-image.png",
+  ],
+}
+```
+
+---
+
+### 📌 Meme/Artwork Gallery with Spoilers:
+
+```js
+{
+  type: "media",
+  links: [
+    {
+      url: "https://example.com/meme1.png",
+      description: "Funny meme #1",
+      spoiler: false,
+    },
+    {
+      url: "https://example.com/meme2.png",
+      description: "Funny meme #2",
+      spoiler: false,
+    },
+    {
+      url: "https://example.com/nsfw-meme.png",
+      description: "⚠️ Slightly inappropriate",
+      spoiler: true, // Hidden behind blur
+    },
+  ],
+}
+```
+
+---
+
+### 💡 Tips for Media Galleries:
+
+| Images Count | Display Layout         |
+| ------------ | ---------------------- |
+| 1 image      | Full width single image |
+| 2 images     | Side by side           |
+| 3 images     | 1 large + 2 small      |
+| 4+ images    | Grid layout            |
+
+- Use `description` for accessibility and context
+- Use `spoiler: true` for sensitive/spoiler content
+- Mix formats freely - strings for quick images, objects for detailed ones
+- Images are displayed in the order provided
+
+</details>
+
+---
+
+<details>
+<summary>📎 File Component Examples</summary>
+
+#### 📌 Simple File Attachment:
+
+```js
+{
+  type: "file",
+  url: "attachment://document.pdf",
+}
+```
+
+
+
+#### 📌 Full Example with File:
+
+```js
+const { CreateComponents } = require("djs-builder");
+const { AttachmentBuilder } = require("discord.js");
+
+const file = new AttachmentBuilder("./myfile.txt", { name: "myfile.txt" });
+
+const components = await CreateComponents("container", [
+  {
+    type: "text",
+    content: "📄 **Here is your requested file:**",
+  },
+  {
+    type: "file",
+    url: "attachment://myfile.txt",
+  },
+]);
+
+await channel.send({ components, files: [file], flags: 32768 });
+```
+
+</details>
+
+---
+
+<details>
+<summary>🔘 Button Component Examples</summary>
+
+#### 📌 Button with Emoji:
+
+```js
+{
+  type: "button",
+  components: [
+    {
+      id: "like_btn",
+      style: 3, // Success (Green)
+      label: "Like",
+      emoji: "👍",
+    },
+  ],
+}
+```
+
+#### 📌 Multiple Buttons in Row:
+
+```js
+{
+  type: "button",
+  components: [
+    { id: "btn_yes", style: 3, label: "Yes", emoji: "✅" },
+    { id: "btn_no", style: 4, label: "No", emoji: "❌" },
+    { id: "btn_maybe", style: 2, label: "Maybe", emoji: "🤔" },
+  ],
+}
+```
+
+#### 📌 All Button Styles:
+
+```js
+{
+  type: "button",
+  components: [
+    { id: "primary", style: 1, label: "Primary", emoji: "🔵" },    // Blue
+    { id: "secondary", style: 2, label: "Secondary", emoji: "⚪" }, // Gray
+    { id: "success", style: 3, label: "Success", emoji: "🟢" },    // Green
+    { id: "danger", style: 4, label: "Danger", emoji: "🔴" },      // Red
+    { style: 5, label: "Link", emoji: "🔗", url: "https://discord.com" }, // Link
+  ],
+}
+```
+
+
+</details>
+
+---
+
+<details>
+<summary>🎯 Menu Component Examples</summary>
+
+#### 📌 String Select Menu (Basic):
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "color_select",
+      placeholder: "🎨 Choose a color",
+      data: [
+        { name: "Red", id: "red", icon: "🔴" },
+        { name: "Blue", id: "blue", icon: "🔵" },
+        { name: "Green", id: "green", icon: "🟢" },
+      ],
+      label: "name",
+      value: "id",
+      emoji: "icon",
+    },
+  },
+}
+```
+
+#### 📌 String Select with Description:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "role_select",
+      placeholder: "🎭 Select your role",
+      data: [
+        { name: "Gamer", id: "gamer", desc: "For gaming enthusiasts", icon: "🎮" },
+        { name: "Artist", id: "artist", desc: "For creative people", icon: "🎨" },
+        { name: "Developer", id: "dev", desc: "For coders & programmers", icon: "💻" },
+        { name: "Music Lover", id: "music", desc: "For music fans", icon: "🎵" },
+      ],
+      label: "name",
+      value: "id",
+      description: "desc",
+      emoji: "icon",
+    },
+  },
+}
+```
+
+#### 📌 String Select with Min/Max:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "string",
+    options: {
+      id: "games_select",
+      placeholder: "🎮 Select your favorite games (2-4)",
+      min: 2,
+      max: 4,
+      data: [
+        { name: "Minecraft", id: "mc", icon: "⛏️" },
+        { name: "Fortnite", id: "fn", icon: "🔫" },
+        { name: "Valorant", id: "val", icon: "🎯" },
+        { name: "League of Legends", id: "lol", icon: "⚔️" },
+        { name: "Rocket League", id: "rl", icon: "🚗" },
+      ],
+      label: "name",
+      value: "id",
+      emoji: "icon",
+    },
+  },
+}
+```
+
+
+#### 📌 User Select (Multiple):
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "user",
+    options: {
+      id: "users_select",
+      placeholder: "👥 Select users to invite (1-5)",
+      min: 1,
+      max: 5,
+    },
+  },
+}
+```
+
+#### 📌 Role Select Menu:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "role",
+    options: {
+      id: "role_select",
+      placeholder: "🎭 Select a role",
+      min: 1,
+      max: 1,
+    },
+  },
+}
+```
+
+
+#### 📌 Channel Select Menu:
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "channel",
+    options: {
+      id: "channel_select",
+      placeholder: "📢 Select a channel",
+      min: 1,
+      max: 1,
+    },
+  },
+}
+```
+
+#### 📌 Channel Select with Type Filter:
+
+```js
+const { ChannelType } = require("discord.js");
+
+{
+  type: "menu",
+  components: {
+    type: "channel",
+    options: {
+      id: "text_channel_select",
+      placeholder: "💬 Select a text channel",
+      channelTypes: [ChannelType.GuildText, ChannelType.GuildAnnouncement],
+    },
+  },
+}
+```
+
+#### 📌 Menu with Default Values (User/Role/Channel):
+
+```js
+{
+  type: "menu",
+  components: {
+    type: "user",
+    options: {
+      id: "user_select_default",
+      placeholder: "👤 Select users",
+      min: 1,
+      max: 3,
+      defaultValues: [
+        { id: "123456789012345678", type: "user" },
+        { id: "987654321098765432", type: "user" },
+      ],
+    },
+  },
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>📦 Section Component Examples</summary>
+
+
+#### 📌 Section with Thumbnail (Product):
+
+```js
+{
+  type: "section",
+  content: "🛒 **iPhone 15 Pro**\n💰 Price: $999\n⭐ Rating: 4.8/5\n📦 In Stock: Yes",
+  accessory: {
+    type: "thumbnail",
+    url: "https://example.com/iphone.png",
+    description: "iPhone 15 Pro Image",
+  },
+}
+```
+
+#### 📌 Section with Button :
+
+```js
+{
+  type: "section",
+  content: "🎁 **Daily Reward**\nClick to claim your daily reward!\n💎 **+100 Coins**",
+  accessory: {
+    type: "button",
+    id: "claim_daily",
+    style: 3, 
+    label: "Claim",
+    emoji: "🎁",
+  },
+}
+```
+
+
+
+
+</details>
+
+---
+
+
+### 📖 Component Types Explanation
+
+#### 🔹 Text
+
+- `type` → `"text"`
+- `content` → The text content to display (supports Markdown)
+
+#### 🔹 Separator
+
+- `type` → `"separator"`
+- `divider` → Show a dividing line (true/false)
+- `spacing` → Spacing size (1: Small, 2: Large)
+
+#### 🔹 Media Gallery
+
+- `type` → `"media"`
+- `links` → Array of image URLs or objects with:
+  - `url` → Image URL
+  - `description` → Alt text for the image
+  - `spoiler` → Hide behind spoiler (true/false)
+
+#### 🔹 File
+
+- `type` → `"file"`
+- `url` → File URL or attachment reference
+- `spoiler` → Hide behind spoiler (true/false)
+
+#### 🔹 Button
+
+- `type` → `"button"`
+- `components` → Array of button objects:
+  - `id` → customId (required for non-link buttons)
+  - `style` → 1: Primary, 2: Secondary, 3: Success, 4: Danger, 5: Link
+  - `label` → Button text
+  - `emoji` → Button emoji
+  - `disabled` → Disable button (true/false)
+  - `url` → URL for link buttons (style: 5)
+
+#### 🔹 Menu
+
+- `type` → `"menu"`
+- `components` → Object containing:
+  - `type` → `"string" | "user" | "role" | "channel"`
+  - `options` → Menu configuration:
+    - `id` → customId
+    - `placeholder` → Placeholder text
+    - `min` / `max` → Min/Max selectable values
+    - `data` → Options array (for string select)
+    - `label` → Key in data for label
+    - `value` → Key in data for value
+    - `emoji` → Key in data for emoji
+    - `description` → Key in data for description
+    - `channelTypes` → Channel types filter (for channel menu)
+    - `defaultValues` → Pre-selected values
+
+#### 🔹 Section
+
+- `type` → `"section"`
+- `content` → Text content for the section
+- `accessory` → Side component:
+  - **Button Accessory:**
+    - `type` → `"button"`
+    - `id` → customId
+    - `style` → Button style
+    - `label` → Button text
+    - `emoji` → Button emoji
+    - `url` → URL (for link buttons)
+  - **Thumbnail Accessory:**
+    - `type` → `"thumbnail"`
+    - `url` → Image URL
+    - `description` → Image description
+
+---
+
+### 🔹 Mode Differences
+
+| Feature          | `"array"` Mode          | `"container"` Mode        |
+| ---------------- | ----------------------- | ------------------------- |
+| Return Type      | Array of components     | Single ContainerBuilder   |
+| Usage            | Standard messages       | Components V2 messages    |
+| Sections Support | ✅                      | ✅                        |
+| Grouping         | Individual components   | All grouped in container  |
+| Flags Required   | ❌                      | ✅ (flags: 32768)         |
+
+---
+
+### 🔹 Notes
+
+- Use `"container"` mode for Discord's **Components V2** (newer UI)
+- Use `"array"` mode for standard component arrays
+- Sections can have either a **button** or **thumbnail** as accessory, not both
+- Media galleries support multiple images in a single component
+- All components are fully customizable 🎨
+
+</details>
+
+---
+
+<details>
+<summary>Wait ⏰</summary>
+
+**⏰ Wait – Await messages, buttons, select menus or modals easily ✨**
+
+`Wait` is a replacement for traditional collectors. It supports:
+
+- Awaiting **messages** 📝
+- Awaiting **interactions** (buttons / select menus) 🎛️
+- Awaiting **modal submissions** 📋
+- Filtering by **user** and timeout
+
+---
+
+### 📌 Example Usage:
+
+```js
+const { Wait } = require("djs-builder");
+
+const response = await Wait({
+  context: message, // Message or Interaction object
+  userId: message.author.id, // Optional: filter by user
+  type: "both", // "message" | "interaction" | "both"
+  time: 30000, // Time in ms
+  message_Wait: message, // Required if waiting for buttons/selects
+});
+
+if (!response) return console.log("⏱️ Timeout!");
+console.log("✅ Collected:", response);
+```
+
+---
+
+### 🔹 Options
+
+- `context` → The message or interaction context
+- `userId` → Only collect from this user (optional)
+- `type` → `"message" | "interaction" | "both"`
+- `time` → Timeout in milliseconds
+- `message_Wait` → Message containing buttons/select menus (for interaction/both type)
+
+---
+
+### 🔹 Notes
+
+- Supports **automatic cleanup** of collectors after completion
+- Can return **Message**, **Interaction**, or **ModalSubmitInteraction**
+
+</details>
+
+---
+
+<details>
+<summary>GetUser 👤</summary>
+
+**👤 GetUser – Fetch a GuildMember easily from a message ✨**
+
+`GetUser` helps to detect a **target member** in multiple ways:
+
+1. Mention (`@User`)
+2. User ID (`123456789012345678`)
+3. Reply to another message
+
+---
+
+### 📌 Example Usage:
+
+```js
+const { GetUser } = require("djs-builder");
+
+const data = await GetUser(message);
+
+if (!data) return message.reply("❌ Could not find the user.");
+
+const member = data.user; // GuildMember object
+const args = data.args; // Remaining arguments
+const reason = args.join(" ") || "No reason provided";
+
+await member.ban({ reason });
+message.reply(`🚫 ${member.user.tag} was banned for: ${reason}`);
+```
+
+---
+
+### 🔹 Returns
+
+```js
+{
+  user: <GuildMember>,  // Targeted member
+  args: [ "arg1", "arg2" ] // Remaining message arguments
+}
+```
+
+---
+
+### 🔹 Detection Methods
+
+- **Mention:** `!ban @Ahmed Spamming`
+- **User ID:** `!ban 123456789012345678 Spamming`
+- **Reply:** `Reply to user's message with !ban`
+
+---
+
+### 🔹 Notes
+
+- Automatically handles missing users
+- Returns `null` if user not found
+- Works in any text channel of the guild
+
+</details>
+
+---
+
+<details>
+<summary>Logging System 🛡️</summary>
+
+## 🛡️ Logging System – Track Everything in Your Server
+
+The **Logging System** is a powerful feature that keeps track of almost everything happening inside your Discord server 🔍.  
+From **messages** 📝 to **channels** 📂, **roles** 🎭, **invites** 🔗, and even **voice state changes** 🎙️ – nothing goes unnoticed!
+
+> **Note 1**: Using `database: true` requires a **MongoDB** connection. | **Note 2**: You can import the **Log** model for direct database access 💾.
+
+---
+
+### 📦 Module Exports
+
+```js
+const { log, Log } = require("djs-builder");
+```
+
+- `log(client, options)` → Start the logging system with your configuration 🚀.
+- `Log` → The Mongoose model for direct database access and custom modifications 💾.
+
+---
+
+### 📋 Simple Example
+
+```js
+const { log } = require("djs-builder");
+
+module.exports = {
+  name: "clientReady",
+  async run(client) {
+    const logData = [
+      {
+        guildId: "999888777666555444",
+        channelId: "444555666777888999",
+      },
+
+          {
+        guildId: "999888777666555444",
+        channelId: "444555666777888999",
+      },
+    ];
+
+    // Start logging with custom data
+    await log(client, {
+      Data: logData, // 📊 Your configurations
+    });
+
+    console.log("✅ Logging system started with custom data!");
+  },
+};
+```
+
+---
+
+### ✨ Features
+
+- 📝 **Messages** – Deleted & edited messages are logged with details.
+- 📂 **Channels** – Creation, deletion, and updates are tracked.
+- 🎭 **Roles** – Created, deleted, and updated roles, including member role changes.
+- 🎙️ **Voice State** – Joins, leaves, and moves between channels.
+- 🔗 **Invites** – Created invites & usage tracking.
+- 😀 **Emojis & Stickers** – Added, removed, or updated.
+- 👤 **Members** – Join, leave, kick, ban, and unban events.
+- 🚨 **Audit Log Integration** – Fetches the executor (who did what).
+- 🎨 **Beautiful Embeds** – Every log is shown in a clean, styled embed with timestamps.
+- 🗄️ **Caching System** – Fast performance with built-in data caching.
+
+---
+
+### 📊 Database Schema
+
+The logging system uses the following data structure:
+
+```js
+{
+  guildId: String,      // 🏠 Server ID (required)
+  channelId: String,    // 📢 Default log channel ID
+  channels: Object,     // 📂 Custom channels per event type (optional)
+  colors: Object,       // 🎨 Custom colors per event type (optional)
+  disable: Array,       // 🚫 Array of disabled event types (optional)
+}
+```
+
+---
+
+<details>
+<summary>📋 Supported Event Types</summary>
+
+### 📋 Supported Event Types
+
+| Event Type          | Description               |
+| ------------------- | ------------------------- |
+| `messageDelete`     | Message deleted 📝        |
+| `messageUpdate`     | Message edited ✏️         |
+| `channelCreate`     | Channel created 📁        |
+| `channelDelete`     | Channel deleted 🗑️        |
+| `channelUpdate`     | Channel updated ⚙️        |
+| `guildMemberAdd`    | Member joined 🎉          |
+| `guildMemberRemove` | Member left/kicked 🚪     |
+| `guildBanAdd`       | Member banned 🔨          |
+| `guildBanRemove`    | Member unbanned 🤗        |
+| `roleCreate`        | Role created 🏅           |
+| `roleDelete`        | Role deleted ❌           |
+| `roleUpdate`        | Role updated 🔄           |
+| `guildMemberUpdate` | Member roles changed 👤   |
+| `voiceStateUpdate`  | Voice channel activity 🎤 |
+| `inviteCreate`      | Invite created 🔗         |
+| `emojiCreate`       | Emoji added 😀            |
+| `emojiDelete`       | Emoji removed 🚫          |
+| `emojiUpdate`       | Emoji updated 🔄          |
+| `stickerCreate`     | Sticker added ✨          |
+| `stickerDelete`     | Sticker removed 🗑️        |
+| `stickerUpdate`     | Sticker updated 🌀        |
+
+</details>
+
+---
+
+<details>
+<summary>⚡ Method Using Database (Recommended) 🗄️</summary>
+
+### 🗄️ Using MongoDB Database
+
+This method stores log configuration in MongoDB, allowing dynamic management via commands.
+
+**⚡ Setup in `clientReady` Event:**
+
+```js
+const { log } = require("djs-builder");
+
+module.exports = {
+  name: "clientReady",
+  async run(client) {
+    // Start logging with database mode
+    await log(client, {
+      database: true, // 🗄️ Uses MongoDB to store/fetch config
+    });
+
+    console.log("✅ Logging system started with database mode!");
+  },
+};
+```
+
+---
+
+### 💡 How It Works
+
+- ✅ The system automatically fetches log configuration for each guild from MongoDB.
+- 🛠️ You can manage settings via slash commands (see management command below).
+- 🎨 Supports per-guild customization for channels, colors, and disabled events.
+- 📖 **Important**: If you use database mode, see the [Log Management Command](#-slash-command-for-log-management-) below to edit data.
+
+</details>
+
+---
+
+<details>
+<summary>⚡ Method Using Custom Data Array 📋</summary>
+
+### 📋 Using Custom Data Array
+
+This method uses a predefined array of configurations – perfect for simple setups or testing.
+
+**⚡ Setup in `clientReady` Event:**
+
+
+
+
+```js
+const { log } = require("djs-builder");
+
+module.exports = {
+  name: "clientReady",
+  async run(client) {
+    // Define your log configurations
+    const logData = [
+      {
+        guildId: "123456789012345678", // 🏠 Server ID
+        channelId: "987654321098765432", // 📢 Default log channel
+        channels: {
+          // 📂 Custom channels (optional)
+          messageDelete: "111111111111111111",
+          voiceStateUpdate: "222222222222222222",
+        },
+        colors: {
+          // 🎨 Custom colors (optional)
+          messageDelete: "DarkRed",
+          channelCreate: "DarkGreen",
+        },
+        disable: ["inviteCreate"], // 🚫 Disabled events (optional)
+      },
+      // Add more guild configurations...
+      {
+        guildId: "999888777666555444",
+        channelId: "444555666777888999",
+      },
+    ];
+
+    // Start logging with custom data
+    await log(client, {
+      database: false, // 📋 Uses custom array
+      Data: logData, // 📊 Your configurations
+    });
+
+    console.log("✅ Logging system started with custom data!");
+  },
+};
+```
+
+---
+
+### 🎨 Supported Colors
+
+`Default`, `White`, `Aqua`, `Green`, `Blue`, `Yellow`, `Purple`, `LuminousVividPink`, `Fuchsia`, `Gold`, `Orange`, `Red`, `Grey`, `Navy`, `DarkAqua`, `DarkGreen`, `DarkBlue`, `DarkPurple`, `DarkVividPink`, `DarkGold`, `DarkOrange`, `DarkRed`, `DarkGrey`, `DarkerGrey`, `LightGrey`, `DarkNavy`, `Blurple`, `Greyple`, `DarkButNotBlack`, `NotQuiteBlack`, `Random`, or any **Hex Color** like `#FF5733`.
+
+---
+
+### 🌐 Multi-Guild Support
+
+> 💡 **Tip:** You can add configurations for multiple guilds in the same array. Each guild can have its own unique settings for channels, colors, and disabled events!
+
+</details>
+
+---
+
+<details>
+<summary>🔧 Direct Database Access with Log Model 💾</summary>
+
+### 💾 Using the Log Model Directly
+
+You can import the `Log` Mongoose model to create, update, or delete log configurations programmatically.
+
+**📥 Import the Model:**
+
+```js
+const { Log } = require("djs-builder");
+```
+
+**➕ Create New Configuration:**
+
+```js
+const { Log } = require("djs-builder");
+
+// Create a new log configuration for a guild
+const newConfig = await Log.create({
+  guildId: "123456789012345678",
+  channelId: "987654321098765432",
+  channels: {
+    messageDelete: "111111111111111111",
+  },
+  colors: {
+    messageDelete: "Red",
+  },
+  disable: [],
+});
+
+console.log("✅ Log configuration created!", newConfig);
+```
+
+**✏️ Update Existing Configuration:**
+
+```js
+const { Log } = require("djs-builder");
+
+// Update log channel
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { channelId: "NEW_CHANNEL_ID" },
+  { upsert: true } // Create if doesn't exist
+);
+
+// Add event to disable list
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $push: { disable: "voiceStateUpdate" } }
+);
+
+// Remove event from disable list
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $pull: { disable: "voiceStateUpdate" } }
+);
+
+// Update specific channel for an event
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $set: { "channels.messageDelete": "NEW_CHANNEL_ID" } }
+);
+
+// Update specific color for an event
+await Log.findOneAndUpdate(
+  { guildId: "123456789012345678" },
+  { $set: { "colors.messageDelete": "DarkRed" } }
+);
+```
+
+**🗑️ Delete Configuration:**
+
+```js
+const { Log } = require("djs-builder");
+
+await Log.findOneAndDelete({ guildId: "123456789012345678" });
+console.log("🗑️ Log configuration deleted!");
+```
+
+**📊 Fetch Configuration:**
+
+```js
+const { Log } = require("djs-builder");
+
+const config = await Log.findOne({ guildId: "123456789012345678" });
+if (config) {
+  console.log("📢 Log Channel:", config.channelId);
+  console.log("📂 Custom Channels:", config.channels);
+  console.log("🎨 Custom Colors:", config.colors);
+  console.log("🚫 Disabled Events:", config.disable);
+}
+```
+
+</details>
+
+---
+
+<details>
+<summary>🌐 Dashboard Integration – Manage Logs from Web Panel 🖥️</summary>
+
+### 🖥️ Web Dashboard for Log Management
+
+When you use **database mode** (`database: true`), you can manage the logging system directly from the **djs-builder Dashboard**! 🎛️
+
+---
+
+#### ✨ Dashboard Features for Logs
+
+| Feature                | Description                                  |
+| ---------------------- | -------------------------------------------- |
+| 📢 **Default Channel** | Set the main channel for all logs            |
+| 📂 **Custom Channels** | Assign specific channels for each event type |
+| 🎨 **Custom Colors**   | Choose embed colors for each event type      |
+| 🔄 **Toggle Events**   | Enable/Disable specific event types          |
+| 📊 **Statistics**      | View enabled/disabled events count           |
+| 🗑️ **Reset**           | Clear all log settings with one click        |
+
+---
+
+#### 🚀 How to Access
+
+1. Navigate to your dashboard (e.g., `http://localhost:3000`)
+2. Log in with Discord OAuth2
+3. Select a server
+4. Click on **"سجلات المراقبة"** (Logs) in the sidebar
+
+---
+
+#### ⚠️ Important Notes
+
+**When `database: true`:**
+
+- ✅ Full editing capabilities from dashboard
+- ✅ Changes are saved automatically to MongoDB
+- ✅ Real-time updates
+
+**When `database: false` (Custom Data Array):**
+
+- ⚠️ Dashboard shows **read-only** mode
+- ⚠️ A warning banner appears at the top
+- ⚠️ You must edit settings in your code
+
+</details>
+
+---
+
+<details>
+<summary>🎮 Slash Command for Log Management 🛠️</summary>
+
+### 🛠️ Complete Log Management Slash Command
+
+This command allows server administrators to manage the logging system via Discord.
+
+> ⚠️ **Important**: This command requires `database: true` mode to work properly.
+
+```js
+const { Log, getLogConfigData } = require("djs-builder");
+const {
+  SlashCommandBuilder,
+  PermissionFlagsBits,
+  EmbedBuilder,
+  ChannelType,
+} = require("discord.js");
+
+// All supported event types (21 events)
+const EVENT_TYPES = [
+  { name: "Message Delete", value: "messageDelete" },
+  { name: "Message Update", value: "messageUpdate" },
+  { name: "Channel Create", value: "channelCreate" },
+  { name: "Channel Delete", value: "channelDelete" },
+  { name: "Channel Update", value: "channelUpdate" },
+  { name: "Member Join", value: "guildMemberAdd" },
+  { name: "Member Leave", value: "guildMemberRemove" },
+  { name: "Member Ban", value: "guildBanAdd" },
+  { name: "Member Unban", value: "guildBanRemove" },
+  { name: "Role Create", value: "roleCreate" },
+  { name: "Role Delete", value: "roleDelete" },
+  { name: "Role Update", value: "roleUpdate" },
+  { name: "Member Role Update", value: "guildMemberUpdate" },
+  { name: "Voice State", value: "voiceStateUpdate" },
+  { name: "Invite Create", value: "inviteCreate" },
+  { name: "Emoji Create", value: "emojiCreate" },
+  { name: "Emoji Delete", value: "emojiDelete" },
+  { name: "Emoji Update", value: "emojiUpdate" },
+  { name: "Sticker Create", value: "stickerCreate" },
+  { name: "Sticker Delete", value: "stickerDelete" },
+  { name: "Sticker Update", value: "stickerUpdate" },
+];
+
+// Helper function to clear cache after updates
+function clearLogCache(guildId) {
+  const logData = getLogConfigData();
+  if (logData.clearCache) logData.clearCache(guildId);
+}
+
+module.exports = {
+  data: new SlashCommandBuilder()
+    .setName("logs")
+    .setDescription("🛡️ Manage the server logging system")
+    .setDefaultMemberPermissions(PermissionFlagsBits.Administrator)
+    .addSubcommand((sub) =>
+      sub
+        .setName("setup")
+        .setDescription("📢 Set up the default log channel")
+        .addChannelOption((opt) =>
+          opt
+            .setName("channel")
+            .setDescription("The channel to send logs to")
+            .addChannelTypes(ChannelType.GuildText)
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("channel")
+        .setDescription("📂 Set a specific channel for an event type")
+        .addStringOption((opt) =>
+          opt
+            .setName("event")
+            .setDescription("The event type")
+            .setRequired(true)
+            .addChoices(...EVENT_TYPES)
+        )
+        .addChannelOption((opt) =>
+          opt
+            .setName("channel")
+            .setDescription("The channel for this event")
+            .addChannelTypes(ChannelType.GuildText)
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("color")
+        .setDescription("🎨 Set a custom color for an event type")
+        .addStringOption((opt) =>
+          opt
+            .setName("event")
+            .setDescription("The event type")
+            .setRequired(true)
+            .addChoices(...EVENT_TYPES)
+        )
+        .addStringOption((opt) =>
+          opt
+            .setName("color")
+            .setDescription("Color name or hex code (e.g., Red, #FF5733)")
+            .setRequired(true)
+        )
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("toggle")
+        .setDescription("🔄 Enable or disable an event type")
+        .addStringOption((opt) =>
+          opt
+            .setName("event")
+            .setDescription("The event type")
+            .setRequired(true)
+            .addChoices(...EVENT_TYPES)
+        )
+        .addStringOption((opt) =>
+          opt
+            .setName("action")
+            .setDescription("Enable or disable")
+            .setRequired(true)
+            .addChoices(
+              { name: "Enable", value: "enable" },
+              { name: "Disable", value: "disable" }
+            )
+        )
+    )
+    .addSubcommand((sub) =>
+      sub.setName("view").setDescription("📊 View current log configuration")
+    )
+    .addSubcommand((sub) =>
+      sub
+        .setName("reset")
+        .setDescription("🗑️ Reset all log settings for this server")
+    ),
 
-```js
-const { GetUser } = require("djs-builder");
+  async run(client, interaction) {
+    await interaction.deferReply({ ephemeral: true });
 
-const data = await GetUser(message);
+    const subcommand = interaction.options.getSubcommand();
+    const guildId = interaction.guild.id;
 
-if (!data) return message.reply("❌ Could not find the user.");
+    // ═══════════════════════════════════════════════════════
+    // 📢 SETUP - Set default log channel
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "setup") {
+      const channel = interaction.options.getChannel("channel");
 
-const member = data.user; // GuildMember object
-const args = data.args; // Remaining arguments
-const reason = args.join(" ") || "No reason provided";
+      await Log.findOneAndUpdate(
+        { guildId },
+        { guildId, channelId: channel.id },
+        { upsert: true, new: true }
+      );
 
-await member.ban({ reason });
-message.reply(`🚫 ${member.user.tag} was banned for: ${reason}`);
-```
+      clearLogCache(guildId); // Clear cache to apply changes immediately
 
----
+      const embed = new EmbedBuilder()
+        .setTitle("✅ Logging System Setup")
+        .setDescription(`Logs will now be sent to ${channel}`)
+        .setColor("Green")
+        .setTimestamp();
 
-### 🔹 Returns
+      return interaction.editReply({ embeds: [embed] });
+    }
 
-```js
-{
-  user: <GuildMember>,  // Targeted member
-  args: [ "arg1", "arg2" ] // Remaining message arguments
-}
-```
+    // ═══════════════════════════════════════════════════════
+    // 📂 CHANNEL - Set specific channel for event
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "channel") {
+      const event = interaction.options.getString("event");
+      const channel = interaction.options.getChannel("channel");
+
+      await Log.findOneAndUpdate(
+        { guildId },
+        { $set: { [`channels.${event}`]: channel.id } },
+        { upsert: true }
+      );
 
----
+      clearLogCache(guildId);
 
-### 🔹 Detection Methods
+      const eventName =
+        EVENT_TYPES.find((e) => e.value === event)?.name || event;
+      const embed = new EmbedBuilder()
+        .setTitle("📂 Event Channel Updated")
+        .setDescription(`**${eventName}** logs will now be sent to ${channel}`)
+        .setColor("Blue")
+        .setTimestamp();
 
-- **Mention:** `!ban @Ahmed Spamming`
-- **User ID:** `!ban 123456789012345678 Spamming`
-- **Reply:** `Reply to user's message with !ban`
+      return interaction.editReply({ embeds: [embed] });
+    }
 
----
+    // ═══════════════════════════════════════════════════════
+    // 🎨 COLOR - Set custom color for event
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "color") {
+      const event = interaction.options.getString("event");
+      const color = interaction.options.getString("color");
+
+      await Log.findOneAndUpdate(
+        { guildId },
+        { $set: { [`colors.${event}`]: color } },
+        { upsert: true }
+      );
 
-### 🔹 Notes
+      clearLogCache(guildId);
+
+      const eventName =
+        EVENT_TYPES.find((e) => e.value === event)?.name || event;
+      
+      // Try to use the color, fallback to Blue if invalid
+      let embedColor;
+      try {
+        embedColor = color;
+      } catch {
+        embedColor = "Blue";
+      }
 
-- Automatically handles missing users
-- Returns `null` if user not found
-- Works in any text channel of the guild
+      const embed = new EmbedBuilder()
+        .setTitle("🎨 Event Color Updated")
+        .setDescription(
+          `**${eventName}** embeds will now use color: \`${color}\``
+        )
+        .setColor(embedColor)
+        .setTimestamp();
 
-</details>
+      return interaction.editReply({ embeds: [embed] });
+    }
 
----
+    // ═══════════════════════════════════════════════════════
+    // 🔄 TOGGLE - Enable/Disable event
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "toggle") {
+      const event = interaction.options.getString("event");
+      const action = interaction.options.getString("action");
+
+      if (action === "disable") {
+        await Log.findOneAndUpdate(
+          { guildId },
+          { $addToSet: { disable: event } },
+          { upsert: true }
+        );
+      } else {
+        await Log.findOneAndUpdate(
+          { guildId },
+          { $pull: { disable: event } },
+          { upsert: true }
+        );
+      }
 
-<details>
-  <summary>Logging System 🛡️</summary>
+      clearLogCache(guildId);
 
-The **Logging System** is a powerful feature that keeps track of almost everything happening inside your Discord server 🔍.  
-From **messages** 📝 to **channels** 📂, **roles** 🎭, **invites** 🔗, and even **voice state changes** 🎙️ – nothing goes unnoticed!
+      const eventName =
+        EVENT_TYPES.find((e) => e.value === event)?.name || event;
+      const embed = new EmbedBuilder()
+        .setTitle(
+          action === "disable" ? "🚫 Event Disabled" : "✅ Event Enabled"
+        )
+        .setDescription(`**${eventName}** logging has been ${action}d`)
+        .setColor(action === "disable" ? "Red" : "Green")
+        .setTimestamp();
 
----
+      return interaction.editReply({ embeds: [embed] });
+    }
 
-### ✨ Features
+    // ═══════════════════════════════════════════════════════
+    // 📊 VIEW - Show current configuration
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "view") {
+      const config = await Log.findOne({ guildId });
 
-- 📝 **Messages** – Deleted & edited messages are logged with details.
-- 📂 **Channels** – Creation, deletion, and updates are tracked.
-- 🎭 **Roles** – Created, deleted, and updated roles, including member role changes.
-- 🎙️ **Voice State** – Joins, leaves, and moves between channels.
-- 🔗 **Invites** – Created invites & usage tracking.
-- 😀 **Emojis & Stickers** – Added, removed, or updated.
-- 🚨 **Audit Log Integration** – Fetches the executor (who did what).
-- 🎨 **Beautiful Embeds** – Every log is shown in a clean, styled embed with timestamps.
+      if (!config) {
+        return interaction.editReply({
+          content:
+            "❌ No logging configuration found for this server. Use `/logs setup` first!",
+        });
+      }
 
----
+      const channelsList = config.channels
+        ? Object.entries(config.channels)
+            .map(([k, v]) => {
+              const eventName = EVENT_TYPES.find((e) => e.value === k)?.name || k;
+              return `• **${eventName}**: <#${v}>`;
+            })
+            .join("\n") || "None"
+        : "None";
+
+      const colorsList = config.colors
+        ? Object.entries(config.colors)
+            .map(([k, v]) => {
+              const eventName = EVENT_TYPES.find((e) => e.value === k)?.name || k;
+              return `• **${eventName}**: \`${v}\``;
+            })
+            .join("\n") || "None"
+        : "None";
+
+      const disabledList =
+        config.disable?.length > 0
+          ? config.disable.map((e) => {
+              const eventName = EVENT_TYPES.find((ev) => ev.value === e)?.name || e;
+              return `• ${eventName}`;
+            }).join("\n")
+          : "None";
+
+      const enabledCount = EVENT_TYPES.length - (config.disable?.length || 0);
+
+      const embed = new EmbedBuilder()
+        .setTitle("📊 Log Configuration")
+        .setDescription(`**${enabledCount}/${EVENT_TYPES.length}** events are enabled`)
+        .setColor("Blue")
+        .addFields(
+          {
+            name: "📢 Default Channel",
+            value: config.channelId ? `<#${config.channelId}>` : "Not set",
+            inline: true,
+          },
+          {
+            name: "📂 Custom Channels",
+            value: channelsList.slice(0, 1024) || "None",
+            inline: false,
+          },
+          {
+            name: "🎨 Custom Colors",
+            value: colorsList.slice(0, 1024) || "None",
+            inline: false,
+          },
+          {
+            name: "🚫 Disabled Events",
+            value: disabledList.slice(0, 1024) || "None",
+            inline: false,
+          }
+        )
+        .setFooter({ text: `Guild ID: ${guildId}` })
+        .setTimestamp();
 
-### ⚙️ Setup Example
+      return interaction.editReply({ embeds: [embed] });
+    }
 
-Using the `log` function is very simple ⚡.  
-Just place this code inside an event (like `clientReady`) to start logging:
+    // ═══════════════════════════════════════════════════════
+    // 🗑️ RESET - Delete all configuration
+    // ═══════════════════════════════════════════════════════
+    if (subcommand === "reset") {
+      await Log.findOneAndDelete({ guildId });
+      
+      clearLogCache(guildId);
 
-```js
-const { log } = require("djs-builder");
+      const embed = new EmbedBuilder()
+        .setTitle("🗑️ Configuration Reset")
+        .setDescription(
+          "All logging settings have been deleted for this server."
+        )
+        .setColor("Red")
+        .setTimestamp();
 
-module.exports = {
-  name: "clientReady",
-  async run(client) {
-    await log(
-      client,
-      "GUILD_ID", // 🏠 Guild ID (server)
-      "CHANNEL_ID" // 📢 Channel ID for logs
-    );
+      return interaction.editReply({ embeds: [embed] });
+    }
   },
 };
 ```
 
+</details>
+
 ---
 
-### 💡 How It Works
+### 💡 Tips & Notes
+
+- 🔄 **Caching**: The system caches guild configurations for better performance.
+- 🔐 **Permissions**: Make sure your bot has `View Audit Log` permission for full functionality.
+- 📢 **Invite Tracking**: Uses `discord-inviter` package for accurate invite tracking.
+- 🎨 **Default Colors**: Each event type has sensible default colors if not customized.
+- 🚫 **Disabled Events**: Events in the `disable` array will be completely ignored.
+- 📂 **Channel Fallback**: If no specific channel is set for an event, it uses `channelId`.
+- 💾 **Database Mode**: Recommended for multi-server bots with dynamic configuration needs.
+- 🌐 **Dashboard Integration**: When using database mode, you can manage logs via the web dashboard!
 
-- ✅ Pass your **Client**, **Guild ID**, and **Log Channel ID**.
-- 🔔 Instantly starts tracking events and sending them to the log channel.
-- 🧰 No extra setup required – plug and play!
+---
 
 </details>
 
@@ -552,9 +2336,7 @@ module.exports = {
 The **Level System** module lets you track user experience points (XP) in **text** 💬 and **voice** 🎙️, handle **level-ups** ⬆️, and display **leaderboards** 🏅.
 Perfect for gamifying your Discord server! 🎮✨
 
-> **Note**: To use this module, you **MUST** have **DATABASE** conection.
-
-> **Note**: You can get all data by requiring the **Level** module.
+> **Note**: To use this module, you **MUST** have **DATABASE** conection. | **Note 2**: You can get all data by requiring the **Level** module.
 
 ---
 
@@ -708,9 +2490,7 @@ module.exports = {
 
 This module provides a robust and feature-rich suite of functions to effortlessly launch, monitor, manage, and conclude **Giveaways** on your Discord server. It fully supports both **Reactions** and **Buttons** for entry, featuring advanced controls like pausing, resuming, and rerolling winners. **It is highly recommended to read the Important Notes section below.** 🚨
 
-> **Note**: To use this module, you **MUST** have **DATABASE** conection.
-
-> **Note**: You can get all data by requiring the **giveaway** module.
+> **Note**: To use this module, you **MUST** have **DATABASE** conection. | **Note 2**: You can get all data by requiring the **giveaway** module.
 
 ---
 
@@ -795,51 +2575,54 @@ const { Gstart } = require("djs-builder");
 const { EmbedBuilder } = require("discord.js");
 
 module.exports = {
-  name: "gstart",
-  description: "Starts a new highly-customized giveaway.",
-  run: async (client, message, args) => {
-    // ⏰ Giveaway ends in 48 hours
-    const twoDays = 48 * 60 * 60 * 1000;
-    const channelId = 'YOUR_GIVEAWAY_CHANNEL_ID'; // 📢 Target Channel
-
-    await Gstart({
-      context: message,
-      endTime: twoDays,
-      winers: 5, // 5 lucky winners! 🏆
-      channelId: channelId,
+  name: "gstart",
+  description: "Starts a new highly-customized giveaway.",
+  run: async (client, message, args) => {
+    // ⏰ Giveaway ends in 48 hours
+    const twoDays = Date.now() + 48 * 60 * 60 * 1000;
+    const channelId = "YOUR_GIVEAWAY_CHANNEL_ID"; // 📢 Target Channel
 
-      // 🎨 Customization for the STARTING EMBED
-      embed: {
+    await Gstart({
+      context: message,
+      endTime: twoDays,
+      winers: 5, // 5 lucky winners! 🏆
+      channelId: channelId,
 
-            custom: new EmbedBuilder().setTitle("Raw Embed").toJSON(),// 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
-            title: "🎉 **HUGE SERVER BOOST GIVEAWAY!**",
-            description: "Click the button below to enter for a chance to win a free server boost!",
-            color: "Blue", // Any valid Discord color
-            image: "https://yourimage.com/banner.png", 🖼️
-            thumbnail: message.guild.iconURL(),
-      },
+      // 🎨 Customization for the STARTING EMBED
+      embed: {
+        custom: new EmbedBuilder().setTitle("Raw Embed"), // 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
+        title: "🎉 **HUGE SERVER BOOST GIVEAWAY!**",
+        description:
+          "Click the button below to enter for a chance to win a free server boost!",
+        color: "Blue", // Any valid Discord color
+        image: "https://yourimage.com/banner.png", // image URL
+        thumbnail: message.guild.iconURL(),
+      },
 
       // 🛑 Customization for the ENDED EMBED
-      endEmbed: {
-            custom: new EmbedBuilder().setTitle("Raw Embed").toJSON(),// 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
-            title: "🛑 Giveaway Has Concluded!",
-            description: "Congratulations to the winners! Check the message below.",
-            color: "Green",
-            // Eimage and Ethumbnail can also be set here
-      },
+      endEmbed: {
+        custom: new EmbedBuilder().setTitle("Raw Embed"), // 💡 You can use 'custom' to pass a raw Discord.js EmbedBuilder JSON
+        title: "🛑 Giveaway Has Concluded!",
+        description: "Congratulations to the winners! Check the message below.",
+        color: "Green", // Eimage and Ethumbnail can also be set here
+      },
 
       // 🖱️ Button Entry Method
-      reaction: {
-        type: "button", // Use 'reaction' for an emoji reaction
-        emoji: "✅", // The emoji displayed on the button
-        label: "Enter Giveaway!", // The text label
-        style: 3, // Button style: Primary(1), Secondary(2), Success(3), Danger(4)
-        id: "giveaway", // Custom ID for the button
-
-      },
-    });
-    message.reply("🎉 Giveaway started successfully!");
-  },
+      reaction: {
+        type: "button", // Use 'reaction' for an emoji reaction
+        emoji: "✅", // The emoji displayed on the button
+        label: "Enter Giveaway!", // The text label
+        style: 3, // Button style: Primary(1), Secondary(2), Success(3), Danger(4)
+        id: "djs-builder-giveaway", // Custom ID for the button
+      },
+
+      // 🔒 Requirements (Optional)
+      requirements: {
+        requiredRoles: ["123456789012345678"], // 🛡️ User MUST have this role to join (Button Only)
+      },
+    });
+    message.reply("🎉 Giveaway started successfully!");
+  },
 };
 ```
 
@@ -867,6 +2650,11 @@ This module requires specific setup steps to function correctly. Pay attention t
   - You **MUST** manually implement a listener for the **`interactionCreate`** event and use the **`GaddUser`** function to register the user entry when the button is clicked. 🖱️
   - _See the `GaddUser` section for a detailed code example._
 
+- **3. Requirements (Roles):**
+
+  - The `requiredRoles` feature currently works **ONLY** with the **Button** entry method (`reaction.type: "button"`).
+  - When using `GaddUser`, you must pass the `guild` object as the third argument for the role check to work.
+
 </details>
 
 ---
@@ -1076,27 +2864,38 @@ module.exports = {
   run: async (interaction) => {
     // 1. Handle Join/Entry Button Click
     if (interaction.customId === "djs-builder-giveaway") {
+      // ⚠️ Note: Pass 'interaction.guild' as the 3rd argument to enable Role Requirements check!
       const result = await GaddUser(
         interaction.message.id,
-        interaction.user.id
+        interaction.user.id,
+        interaction.guild
       );
 
-      if (result?.error === "❌ User Already Joined") {
-        // User already joined, offer a 'Leave' button dynamically
-        const row = await CreateRow([
-          [
-            {
-              label: "Leave Giveaway",
-              id: "djs-builder-giveaway-leave-" + interaction.message.id, // Dynamic ID
-              style: 4, // Danger Red
-            },
-          ],
-        ]);
+      if (result?.error) {
+        // Handles both "User Already Joined" and "Missing Roles" errors
+        if (result.error === "❌ User Already Joined") {
+          // ... (Leave button logic)
+          const row = await CreateRow([
+            [
+              {
+                label: "Leave Giveaway",
+                id: "djs-builder-giveaway-leave-" + interaction.message.id, // Dynamic ID
+                style: 4, // Danger Red
+              },
+            ],
+          ]);
+          return interaction.reply({
+            content:
+              "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
+            components: row,
+            flags: 64,
+          });
+        }
+
+        // Show error (e.g. Missing Role)
         return interaction.reply({
-          content:
-            "⚠️ You have **already joined** this giveaway! You can **leave** by clicking the button below.",
-          components: row,
-          flags: 64, // Ephemeral reply
+          content: result.error,
+          flags: 64,
         });
       }
 
@@ -1208,8 +3007,9 @@ if (giveawayData) {
   "channelId": "876543210987654321", // 📢 Channel ID
   "messageId": "987654321098765432", // 💬 Message ID of the giveaway post
   "hoster": "112233445566778899", // 👤 User ID of the giveaway host
-  "winwesNumber": 1, // 🔢 Number of winners set
-  "winers": [], // 🏆 Array of user IDs who won (empty if not ended)
+"prize" : "code" // 🎁 prize
+  "winnerCount": 1, // 🔢 Number of winners set
+  "winners": [], // 🏆 Array of user IDs who won (empty if not ended)
   "paused": false, // ⏸️ True if the giveaway is paused
   "pausedTime": [], // ⏱️ Array of saved remaining times (used for resume)
   "endTime": "1730995200000", // 📅 Timestamp (MS) of when the giveaway should end
@@ -1223,7 +3023,7 @@ if (giveawayData) {
     "fields": [
       {
         "name": "🎉 Giveaway",
-        "value": "- Winer(s): 1\n- Time : <t:1730995200:R>\n- Hosted By : <@112233445566778899>",
+        "value": "- Winner(s): 1\n- Time : <t:1730995200:R>\n- Hosted By : <@112233445566778899>",
         "inline": true
       }
     ]
@@ -1499,6 +3299,7 @@ module.exports = {
         channelId: channel.id,
         winers: winnerCount,
         endTime: endTimeMs,
+        prize: prize,
         embed: {
           title: `🎉 ${prize} Giveaway!`,
           image: image,
@@ -1550,7 +3351,7 @@ module.exports = {
           content: `${title}\n\n${listContent}`,
         });
       } else if (listContent.length <= MAX_EMBED_LENGTH) {
-        // Output as an Embed (Over 2000, under 4096)
+        // Output as an Embed (Over 2000, under 4000)
         const embed = new EmbedBuilder()
           .setTitle(title.replace(/\*\*/g, ""))
           .setDescription(listContent)
@@ -1561,7 +3362,7 @@ module.exports = {
           embeds: [embed],
         });
       } else {
-        // Output as an attachment/JSON file (Over 4096 chars)
+        // Output as an attachment/JSON file (Over 4000 chars)
         const jsonFile = new AttachmentBuilder(
           Buffer.from(JSON.stringify(giveaways, null, 2)),
           { name: `${type}_giveaways_list.json` }
@@ -1768,6 +3569,8 @@ module.exports = {
 
 </details>
 
+---
+
 </details>
 
 ---
@@ -1779,9 +3582,7 @@ module.exports = {
 
 The **Blacklist System** allows you to block specific **users**, **roles**, or **channels** from using your bot's commands. This is useful for moderation and preventing abuse.
 
-> **Note**: To use this module, you **MUST** have **DATABASE** connection.
-
-> **Note**: You can get all data by requiring the **Blacklist** module.
+> **Note 1**: To use this module, you **MUST** have **DATABASE** connection. | **Note 2**: You can get all data by requiring the **Blacklist** module.
 
 ---
 
@@ -1845,10 +3646,12 @@ console.log("Role unblacklisted! 🔓");
 Returns an array of blacklisted items for a guild. You can optionally filter by type (`user`, `role`, `channel`).
 
 **Parameters:**
+
 - `guildId` (String): The ID of the guild.
 - `type` (String, optional): The type to filter by (`user`, `role`, `channel`).
 
 **Example:**
+
 ```js
 // Get all blacklisted items
 const allBlacklisted = await getBlacklist("GUILD_ID");
@@ -1873,35 +3676,80 @@ Output:
 You can create a slash command to manage the blacklist easily.
 
 ```js
-const { addToBlacklist, removeFromBlacklist, isBlacklisted, getBlacklist } = require("djs-builder");
-const { SlashCommandBuilder, PermissionFlagsBits, EmbedBuilder } = require("discord.js");
+const {
+  addToBlacklist,
+  removeFromBlacklist,
+  isBlacklisted,
+  getBlacklist,
+} = require("djs-builder");
+const {
+  SlashCommandBuilder,
+  PermissionFlagsBits,
+  EmbedBuilder,
+} = require("discord.js");
 
 module.exports = {
   data: new SlashCommandBuilder()
     .setName("blacklist")
     .setDescription("Manage the blacklist")
     .setDefaultMemberPermissions(PermissionFlagsBits.Administrator)
-    .addSubcommand(sub =>
-      sub.setName("add").setDescription("Add to blacklist")
-        .addUserOption(opt => opt.setName("user").setDescription("User to blacklist"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to blacklist"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to blacklist"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("add")
+        .setDescription("Add to blacklist")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to blacklist")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to blacklist")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to blacklist")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("remove").setDescription("Remove from blacklist")
-        .addUserOption(opt => opt.setName("user").setDescription("User to remove"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to remove"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to remove"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("remove")
+        .setDescription("Remove from blacklist")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to remove")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to remove")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to remove")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("check").setDescription("Check if a target is blacklisted")
-        .addUserOption(opt => opt.setName("user").setDescription("User to check"))
-        .addRoleOption(opt => opt.setName("role").setDescription("Role to check"))
-        .addChannelOption(opt => opt.setName("channel").setDescription("Channel to check"))
+    .addSubcommand((sub) =>
+      sub
+        .setName("check")
+        .setDescription("Check if a target is blacklisted")
+        .addUserOption((opt) =>
+          opt.setName("user").setDescription("User to check")
+        )
+        .addRoleOption((opt) =>
+          opt.setName("role").setDescription("Role to check")
+        )
+        .addChannelOption((opt) =>
+          opt.setName("channel").setDescription("Channel to check")
+        )
     )
-    .addSubcommand(sub =>
-      sub.setName("list").setDescription("List all blacklisted items")
-        .addStringOption(opt => opt.setName("type").setDescription("Filter by type").addChoices({ name: "User", value: "user" }, { name: "Role", value: "role" }, { name: "Channel", value: "channel" } , { name: "All", value: "all" }))
+    .addSubcommand((sub) =>
+      sub
+        .setName("list")
+        .setDescription("List all blacklisted items")
+        .addStringOption((opt) =>
+          opt
+            .setName("type")
+            .setDescription("Filter by type")
+            .addChoices(
+              { name: "User", value: "user" },
+              { name: "Role", value: "role" },
+              { name: "Channel", value: "channel" },
+              { name: "All", value: "all" }
+            )
+        )
     ),
   async run(interaction) {
     const sub = interaction.options.getSubcommand();
@@ -1911,54 +3759,95 @@ module.exports = {
     const guildId = interaction.guild.id;
 
     if (sub === "list") {
-        const type = interaction.options.getString("type");
-        if (type !== "all") {
+      const type = interaction.options.getString("type");
+      if (type !== "all") {
         const list = await getBlacklist(guildId, type);
 
-        if (!list.length) return interaction.reply({ content: "✅ No blacklisted items found.", flags : 64 });
+        if (!list.length)
+          return interaction.reply({
+            content: "✅ No blacklisted items found.",
+            flags: 64,
+          });
 
         const embed = new EmbedBuilder()
-            .setTitle("🚫 Blacklist")
-            .setColor("Red")
-            .setDescription(list.map(item => `• **${item.type.toUpperCase()}**: <${item.type === 'channel' ? '#' : item.type === 'role' ? '@&' : '@'}${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4096));
-
-        return interaction.reply({ embeds: [embed], flags : 64 });
-        } else {
+          .setTitle("🚫 Blacklist")
+          .setColor("Red")
+          .setDescription(
+            list
+              .map(
+                (item) =>
+                  `• **${item.type.toUpperCase()}**: <${
+                    item.type === "channel"
+                      ? "#"
+                      : item.type === "role"
+                      ? "@&"
+                      : "@"
+                  }${item.id}> (\`${item.id}\`)`
+              )
+              .join("\n")
+              .slice(0, 4000)
+          );
+
+        return interaction.reply({ embeds: [embed], flags: 64 });
+      } else {
         const list = await getBlacklist(guildId);
-        if (!list.length) return interaction.reply({ content: "✅ No blacklisted items found.", flags : 64 });
+        if (!list.length)
+          return interaction.reply({
+            content: "✅ No blacklisted items found.",
+            flags: 64,
+          });
 
         const embeds = [];
-        const roles = list.filter(i => i.type === "role");
-        const users = list.filter(i => i.type === "user");
-        const channels = list.filter(i => i.type === "channel");
+        const roles = list.filter((i) => i.type === "role");
+        const users = list.filter((i) => i.type === "user");
+        const channels = list.filter((i) => i.type === "channel");
 
         if (users.length) {
-            const userEmbed = new EmbedBuilder()
+          const userEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Users")
             .setColor("Red")
-            .setDescription(users.map(item => `• <@${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4096));
-            embeds.push(userEmbed);
+            .setDescription(
+              users
+                .map((item) => `• <@${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(userEmbed);
         }
-        if( roles.length) {
-            const roleEmbed = new EmbedBuilder()
+        if (roles.length) {
+          const roleEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Roles")
             .setColor("Red")
-            .setDescription(roles.map(item => `• <@&${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4096));
-            embeds.push(roleEmbed);
+            .setDescription(
+              roles
+                .map((item) => `• <@&${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(roleEmbed);
         }
-        if( channels.length) {
-            const channelEmbed = new EmbedBuilder()
+        if (channels.length) {
+          const channelEmbed = new EmbedBuilder()
             .setTitle("🚫 Blacklisted Channels")
             .setColor("Red")
-            .setDescription(channels.map(item => `• <#${item.id}> (\`${item.id}\`)`).join("\n").slice(0, 4096));
-            embeds.push(channelEmbed);
+            .setDescription(
+              channels
+                .map((item) => `• <#${item.id}> (\`${item.id}\`)`)
+                .join("\n")
+                .slice(0, 4000)
+            );
+          embeds.push(channelEmbed);
         }
-        return interaction.reply({ embeds, flags : 64 });
+        return interaction.reply({ embeds, flags: 64 });
+      }
     }
-  }
-  
+
     if (!user && !role && !channel) {
-      return interaction.reply({ content: "⚠️ You must provide at least one option (User, Role, or Channel).", flags : 64 });
+      return interaction.reply({
+        content:
+          "⚠️ You must provide at least one option (User, Role, or Channel).",
+        flags: 64,
+      });
     }
     const target = user || role || channel;
     const type = user ? "user" : role ? "role" : "channel";
@@ -1966,18 +3855,25 @@ module.exports = {
 
     if (sub === "add") {
       const success = await addToBlacklist(guildId, type, id);
-      if (success) interaction.reply(`✅ Added **${type}** ${target} to blacklist.`);
-      else interaction.reply(`⚠️ **${type}** ${target} is already blacklisted.`);
+      if (success)
+        interaction.reply(`✅ Added **${type}** ${target} to blacklist.`);
+      else
+        interaction.reply(`⚠️ **${type}** ${target} is already blacklisted.`);
     } else if (sub === "remove") {
       const success = await removeFromBlacklist(guildId, type, id);
-      if (success) interaction.reply(`✅ Removed **${type}** ${target} from blacklist.`);
+      if (success)
+        interaction.reply(`✅ Removed **${type}** ${target} from blacklist.`);
       else interaction.reply(`⚠️ **${type}** ${target} is not blacklisted.`);
     } else if (sub === "check") {
       const isBlocked = await isBlacklisted(guildId, type, id);
-      if (isBlocked) interaction.reply(`🚫 **${type}** ${target} is currently **blacklisted**.`);
-      else interaction.reply(`✅ **${type}** ${target} is **not** blacklisted.`);
+      if (isBlocked)
+        interaction.reply(
+          `🚫 **${type}** ${target} is currently **blacklisted**.`
+        );
+      else
+        interaction.reply(`✅ **${type}** ${target} is **not** blacklisted.`);
     }
-  }
+  },
 };
 ```
 
@@ -2111,6 +4007,224 @@ execute: Function              // 🏃‍♂️ Alternative function to run the
 
 ---
 
+## 🌐 DASHBOARD
+
+The **Dashboard System** is a modern, lightweight web-based control panel for your Discord bot. It provides a beautiful interface to manage your bot, servers, levels, giveaways, and more! 🎛️🚀
+
+**Features:**
+
+- 🔐 **Discord OAuth2 Login** – Secure authentication with Discord.
+- 📊 **Bot Statistics** – View real-time bot stats (servers, users, commands, uptime).
+- 🏠 **Server Management** – Manage servers where you have admin permissions.
+- 📜 **Commands Viewer** – Browse all slash and prefix commands.
+- 🏆 **Level System Management** – View leaderboards, manage user XP and levels.
+- 🎉 **Giveaway Control** – Pause, resume, end, reroll, or delete giveaways.
+- 🦾 **Logging System Control** – Manage log channels, colors, and event toggles.
+- 🚫 **Blacklist Management** – Add/remove users, roles, or channels from blacklist.
+- 🎨 **Modern UI** – Beautiful, responsive design with dark mode support.
+
+> **Note**: This module requires **express**, **express-session**, **passport**, and **passport-discord** packages. | **Note 2**: You must have a **DATABASE** connection for full functionality.
+
+> 💡 **Tip:** You can use Dashboard with the starter function (see [Starter](#starter)) or as a standalone function!
+
+---
+
+<details>
+<summary>Dashboard with Starter ⚙️</summary>
+
+When using with starter, simply add the `dashboard` option to your starter configuration:
+
+```js
+const { starter } = require("djs-builder");
+const { Client, GatewayIntentBits } = require("discord.js");
+
+const client = new Client({
+  intents: Object.keys(GatewayIntentBits).map((a) => GatewayIntentBits[a]),
+});
+
+const starterOptions = {
+  bot: {
+    token: "YOUR_BOT_TOKEN",
+    ownerId: "YOUR_USER_ID",
+  },
+  terminal: true,
+
+  // 🌐 Dashboard Configuration
+  dashboard: {
+    clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
+    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
+    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
+    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
+  },
+
+  // ... other options (Status, database, anticrash, etc.)
+};
+
+await starter(client, starterOptions);
+```
+
+</details>
+
+---
+
+<details>
+<summary>Dashboard Standalone Usage 🔧</summary>
+
+You can use the Dashboard as a **standalone function** without the starter! This is useful if you already have your own bot setup or want more control.
+
+```js
+const { dashboard } = require("djs-builder");
+const { Client, GatewayIntentBits } = require("discord.js");
+
+const client = new Client({
+  intents: Object.keys(GatewayIntentBits).map((a) => GatewayIntentBits[a]),
+});
+
+// 🔑 Login your bot first
+client.login("YOUR_BOT_TOKEN");
+
+client.once("ready", () => {
+  console.log(`✅ Logged in as ${client.user.tag}`);
+
+  // 🌐 Start the Dashboard
+  dashboard(client, {
+    clientSecret: "YOUR_DISCORD_CLIENT_SECRET", // 🔐 Discord Application Client Secret
+    callbackURL: "http://localhost:3000/auth/discord/callback", // 🔗 OAuth2 Callback URL (OPTINAL)
+    sessionSecret: "your-super-secret-key", // 🔒 Session encryption secret
+    port: 3000, // 🌍 Dashboard port (OPTINAL / default: 3000)
+  });
+});
+```
+
+> 💡 **Tip:** When using standalone, make sure your bot is logged in before starting the dashboard!
+
+</details>
+
+---
+
+<details>
+<summary>Dashboard Routes & API 📡</summary>
+
+### 📌 Dashboard Routes
+
+| Route                           | Description                  |
+| ------------------------------- | ---------------------------- |
+| `/`                             | 🏠 Homepage with bot stats   |
+| `/login`                        | 🔐 Login page                |
+| `/dashboard`                    | 📊 Server selection          |
+| `/dashboard/:guildId`           | 🏠 Server overview           |
+| `/dashboard/:guildId/commands`  | 📜 Commands list             |
+| `/dashboard/:guildId/levels`    | 🏆 Level leaderboard         |
+| `/dashboard/:guildId/giveaways` | 🎉 Giveaway management       |
+| `/dashboard/:guildId/logs`      | 🛡️ Logging system management |
+
+---
+
+### 📡 API Endpoints
+
+The dashboard exposes several API endpoints for dynamic data:
+
+```js
+// 📊 Get bot statistics
+GET /api/stats
+
+// 🏠 Get server statistics
+GET /api/:guildId/stats
+
+// 👤 Get user level data
+GET /api/:guildId/user/:userId
+
+// 🔍 Search members
+GET /api/:guildId/members/search?q=query
+
+// 🏆 Level management
+POST /api/:guildId/level/update   // Update user level
+POST /api/:guildId/level/add      // Add XP to user
+POST /api/:guildId/level/reset    // Reset user level
+
+// 🎉 Giveaway actions
+POST /api/:guildId/giveaway/pause
+POST /api/:guildId/giveaway/resume
+POST /api/:guildId/giveaway/end
+POST /api/:guildId/giveaway/reroll
+POST /api/:guildId/giveaway/delete
+
+// �️ Logging system management
+POST /api/:guildId/logs/channel    // Set default log channel
+POST /api/:guildId/logs/toggle     // Enable/disable event type
+POST /api/:guildId/logs/event      // Update event settings (channel, color)
+POST /api/:guildId/logs/reset      // Reset all log settings
+
+// �🚫 Blacklist management
+POST /api/guild/:guildId/blacklist    // Add to blacklist
+DELETE /api/guild/:guildId/blacklist  // Remove from blacklist
+```
+
+</details>
+
+---
+
+<details>
+<summary>Dashboard Options 🔧</summary>
+
+### 🔧 Configuration Options
+
+| Option          | Type     | Required | Description                                          |
+| --------------- | -------- | -------- | ---------------------------------------------------- |
+| `clientSecret`  | `string` | ✅       | 🔐 Your Discord Application Client Secret            |
+| `callbackURL`   | `string` | ✅       | 🔗 OAuth2 redirect URL (must match Discord settings) |
+| `sessionSecret` | `string` | ✅       | 🔒 Secret key for session encryption                 |
+| `port`          | `number` | ❌       | 🌍 Port to run the dashboard (default: 3000)         |
+
+---
+
+### 📁 View Templates
+
+The dashboard uses **EJS** templates located in the `views` folder:
+
+| File            | Description                  |
+| --------------- | ---------------------------- |
+| `index.ejs`     | 🏠 Homepage                  |
+| `login.ejs`     | 🔐 Login page                |
+| `dashboard.ejs` | 📊 Server selection          |
+| `guild.ejs`     | 🏠 Server overview           |
+| `commands.ejs`  | 📜 Commands list             |
+| `levels.ejs`    | 🏆 Level management          |
+| `giveaways.ejs` | 🎉 Giveaway management       |
+| `logs.ejs`      | 🛡️ Logging system management |
+| `404.ejs`       | ❌ Not found page            |
+
+</details>
+
+---
+
+<details>
+<summary>Discord Developer Portal Setup 🛠️</summary>
+
+### 🛠️ How to Get Client ID & Secret
+
+1. Go to [Discord Developer Portal](https://discord.com/developers/applications) 🌐
+2. Create a new application or select existing one 📱
+3. Go to **OAuth2** → **General** 🔐
+4. Copy the **Client ID** and **Client Secret** 📋
+5. Add your **Redirect URL** (e.g., `http://localhost:3000/auth/discord/callback`) ✅
+6. Make sure to add the URL to **Redirects** list 📝
+
+---
+
+### 💡 Tips & Notes
+
+- 🔒 **Keep secrets safe** – Never expose `clientSecret` or `sessionSecret` publicly.
+- 🌐 **Production URL** – Update `callbackURL` when deploying to production.
+- 🗄️ **Database Required** – Level and Giveaway features require MongoDB connection.
+- 🎨 **Customizable** – Edit EJS templates to customize the look and feel.
+- 🔄 **Real-time Stats** – Bot statistics update automatically.
+- 🛡️ **Secure** – Only admins can manage their servers.
+
+</details>
+
+---
+
 ## 💌 Support
 
 We welcome contributions! If you have any suggestions, bug reports, or feature requests, feel free to reach out to us on Discord.
@@ -2119,4 +4233,4 @@ We welcome contributions! If you have any suggestions, bug reports, or feature r
 
 🌐 **Join our Discord:**
 
-[![Discord Banner](https://api.weblutions.com/discord/invite/CS2NRSPyze/)](https://discord.gg/CS2NRSPyze)
+[![Discord Banner](https://api.weblutions.com/discord/invite/uYcKCZk3/)](https://discord.gg/uYcKCZk3)