multi-discord.js

Run multiple discord.js bots in a single Node.js process, where each bot lives in its own folder with its own code.

Features

• Run multiple bots from one config file.
• Works with JavaScript and TypeScript bot files.
• CLI starter to scaffold a 3-bot project.
• Uses latest discord.js v14 in templates.

Install

npm install multi-dc discord.js

Quick Start

npx multi-dc init --dir ./my-bots --lang ts
cd my-bots
npm install
npm run dev

Set env vars before running:

• TKN1
• TKN2
• TKN3

Config

Create multi-discord.config.ts or multi-discord.config.js:

import { defineMultiBotConfig } from "multi-dc";

export default defineMultiBotConfig({
  envFile: ".env",
  botsBasePath: "bots",
  onError: "continue",
  bots: [
    { name: "bot1", path: "bot1", entry: "src/bot.ts", tokenEnv: "TKN1" },
    { name: "bot2", path: "bot2", entry: "src/bot.ts", tokenEnv: "TKN2" },
    { name: "bot3", path: "bot3", entry: "src/bot.ts", tokenEnv: "TKN3" },
  ],
});

Optional config fields:

• envFile: Path to a .env file (relative to config file location or absolute).
• botsBasePath: Base folder for all bot path values.

Each bot module should export createBotClient or a default function returning a discord.js Client.

CLI

multi-dc run [--config <file>]
multi-dc init [--dir <folder>] [--lang ts|js]