🤖 DBI - Discord Bot Infrastructure

The most advanced, modern, and developer-friendly Discord.js v14 bot infrastructure.

Getting Started • Features • Documentation • Examples

✨ Features

| Feature | Description | |---------|-------------| | 🎯 Slash Commands | Full support with 14 option types, autocomplete, and subcommands | | 🔘 Components | Buttons, Select Menus (5 types), and Modals with built-in state management | | 🌍 Localization | Multi-language support for both content and command translations | | 📨 Events | Discord events, custom events, and internal DBI events | | 💬 Message Commands | Automatic slash command emulation from prefix commands | | 🔗 Reference System | Pass complex data through component interactions | | 🚀 Multi-Client | Run multiple bots with namespace isolation | | ⚡ Hybrid Sharding | Scale to millions of servers with discord-hybrid-sharding | | 🎨 Svelte Components | Build reactive Discord UIs with Svelte 5 (HTMLComponentsV2) | | 🔄 Hot Reloading | Update features without restarting your bot | | 🛡️ Rate Limiting | Built-in rate limit management per user/channel/guild | | 📝 TypeScript | Full type safety with intelligent autocomplete |

📦 Installation

npm install @mostfeatured/dbi discord.js

🚀 Quick Start

1. Create DBI Instance

// dbi.js
const { createDBI } = require("@mostfeatured/dbi");

const dbi = createDBI("my-bot", {
  strict: true,
  discord: {
    token: process.env.DISCORD_TOKEN,
    options: { intents: ["Guilds"] }
  },
  defaults: {
    locale: { name: "en" },
    directMessages: false
  }
});

module.exports = dbi;

2. Define Features

// src/commands/ping.js
const dbi = require("../dbi");

dbi.register(({ ChatInput }) => {
  ChatInput({
    name: "ping",
    description: "Check bot latency",
    onExecute({ interaction, dbi }) {
      interaction.reply(`🏓 Pong! ${dbi.client().client.ws.ping}ms`);
    }
  });
});

3. Start Bot

// index.js
const { Utils } = require("@mostfeatured/dbi");
const dbi = require("./dbi");

(async () => {
  await Utils.recursiveImport("./src");
  await dbi.load();
  await dbi.login();
  console.log(`✅ Logged in as ${dbi.client().client.user.tag}`);
})();

4. Publish Commands

// publish.js
const { Utils } = require("@mostfeatured/dbi");
const dbi = require("./dbi");

(async () => {
  await Utils.recursiveImport("./src");
  await dbi.load();
  await dbi.publish("Global"); // or dbi.publish("Guild", "GUILD_ID")
  await dbi.unload();
  console.log("✅ Commands published!");
})();

💡 Examples

Slash Command with Options

dbi.register(({ ChatInput, ChatInputOptions }) => {
  ChatInput({
    name: "greet",
    description: "Greet a user",
    options: [
      ChatInputOptions.user({
        name: "target",
        description: "User to greet",
        required: true
      }),
      ChatInputOptions.string({
        name: "message",
        description: "Custom message"
      })
    ],
    onExecute({ interaction }) {
      const user = interaction.options.getUser("target");
      const message = interaction.options.getString("message") || "Hello!";
      interaction.reply(`${message}, ${user}!`);
    }
  });
});

Button with Reference Data

const Discord = require("discord.js");

dbi.register(({ ChatInput, Button }) => {
  ChatInput({
    name: "shop",
    description: "View the shop",
    onExecute({ interaction, dbi }) {
      interaction.reply({
        content: "🛒 Welcome to the shop!",
        components: [{
          type: Discord.ComponentType.ActionRow,
          components: [
            dbi.interaction("buy-item").toJSON({
              overrides: { label: "Buy Sword - 100g" },
              reference: { data: ["sword", 100] }
            })
          ]
        }]
      });
    }
  });

  Button({
    name: "buy-item",
    options: { style: Discord.ButtonStyle.Primary },
    onExecute({ interaction, data }) {
      const [item, price] = data;
      interaction.reply(`✅ You bought **${item}** for **${price}g**!`);
    }
  });
});

Multi-Language Support

dbi.register(({ Locale, ChatInput }) => {
  Locale({
    name: "en",
    data: {
      greeting: "Hello, {0}!",
      farewell: "Goodbye!"
    }
  });

  Locale({
    name: "tr",
    data: {
      greeting: "Merhaba, {0}!",
      farewell: "Hoşça kal!"
    }
  });

  ChatInput({
    name: "hello",
    description: "Say hello",
    onExecute({ interaction, locale }) {
      const greeting = locale.user.data.greeting(interaction.user.username);
      interaction.reply(greeting);
    }
  });
});

📚 Documentation

Comprehensive documentation is available in the docs folder:

| Document | Description | |----------|-------------| | Getting Started | Installation, setup, and project structure | | Chat Input | Slash commands, options, and autocomplete | | Components | Buttons, select menus, and modals | | Events | Discord events, custom events, DBI events | | Localization | Multi-language support | | Advanced Features | Message commands, sharding, multi-client | | Svelte Components | HTMLComponentsV2 with Svelte 5 | | API Reference | Complete API documentation |

🏗️ Project Structure

my-bot/
├── dbi.js           # DBI configuration
├── index.js         # Bot entry point
├── publish.js       # Command publisher
└── src/
    ├── commands/    # Slash commands
    ├── components/  # Buttons, modals, menus
    ├── events/      # Event handlers
    └── locales/     # Language files

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

📄 License

GPL-3.0 © TheArmagan

"There will always be something free and valuable on earth."

Made with ❤️ by TheArmagan