Simple Discord Bot

TypeScript Discord.js framework - Simple, powerful, framework-ready. Built for developers who want clean bot architecture.

✨ Features :

• Fully compatible with discordjs
• Include the DiscordInterationManager package
• Simple Log package
• Provides easy Managers to avoid repetitive code everywhere
• Simple yet powerful builders (Embeds, Modals, SelectMenus, Components, Buttons) that rely on discord.js for full compatibility

Don't forget to check the wiki

🧩 Starting a new bot ?

Don't start from an empty folder : the DiscordBotTemplate is a ready-to-use project built on this framework. Login, logging, modules, interaction routing and slash command deployment are already wired, you only fill in your ids.

It has its own wiki too, and a feat/multi-bot branch for several bots living in one repository.

Installation

  npm i @spatulox/simplediscordbot

Quick Start

Env Variables:

DISCORD_BOT_TOKEN="" // Your bot Token

You also need to set up this env var :

DISCORD_BOT_CLIENTID="" // You bot ClientID

import {Bot, BotConfig, SimpleColor, Time} from "@spatulox/simplediscordbot";
import {Client, Events, GatewayIntentBits} from "discord.js";

const client = new Client({
    intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
});

const config: BotConfig = {
    defaultSimpleColor: SimpleColor.blue,
    botName: "Simple Discord Bot",
    log: {
        info: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
        error: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
        warn: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
        debug: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: false},
    }
};

const bot = new Bot(client, config);

bot.client.on(Events.ClientReady, async () => {
    Bot.setRandomActivity(randomActivityList, Time.minute.MIN_10.toMilliseconds());
    console.log("Bot ready! ✨");
});