Next generation discord bot template
A discord.js bot template powered by TypeScript and a local database.
DJSKit is a template to make your own discord bots. DJSKit uses discord.js v14 with a local json key-value database, to make it easy for you to get started.
DJSKit was a private thing at first, as I didn't want to write a handler everytime I made a new discord bot.
I've been working on DJSKit for the past 3 years, as I started making discord bots. Since then, I've always been working on features. I'm pretty sure DJSKit has same features that you've never seen anywhere else.
- Slash Commands Handler - Automatic registration and execution of Discord slash commands with full TypeScript support
- Autocomplete - Slash command options with live suggestions via an
autocompletehandler - Context Menu Commands - Message and user context menu commands (right-click > Apps) in
src/context/Messageandsrc/context/User - Message Commands Handler - Traditional prefix-based commands with flexible argument parsing
- Interactive Components & Arguments - Advanced button and modal interactions with sophisticated parameter / arguments system
- Event Handling System - Modular event system supporting both one-time and recurring events
- Local JSON Database - Built-in DotDB integration for persistent data storage without external dependencies
- Custom Prefix Support - Commands can define their own prefixes (e.g.,
$,!,>) independently
- TypeScript Support - Full TypeScript implementation with strict typing and modern ES2024 features
- Error Handling & Logging - Comprehensive error catching with chalk-colored console output
- Dev Mode -
DEV_MODE=trueregisters commands only to your dev server,DEV_MODE=falseregisters them globally - Status Rotations - Automatic bot presence updates with customizable rotation intervals
- Node.js (v22 or higher)
- Discord Application with Bot Token
- Basic knowledge of TypeScript/JavaScript
Create a new bot with the setup walkthrough (bot token, prefix, dev server, package.json, README):
npm create djskitPass -y to skip the prompts, or --help to see all options for non-interactive setups.
-
Clone the repository
git clone https://github.com/NZ-Linix/djskit.git cd djskit -
Install dependencies
npm install
-
Configure environment
cp .env.example .env
Edit
.envto add your Discord bot token and pick a mode:CLIENT_TOKEN = "[ YOUR CLIENT TOKEN HERE ]" DEV_MODE = false
With
DEV_MODE = true, commands are registered only to the dev server (devGuildId) and message commands only respond there. WithDEV_MODE = false, everything is global, even if adevGuildIdis set. -
Configure bot settings Edit
src/config.tsto customize:- Dev server ID (
devGuildId, used whenDEV_MODE = true) - Message command prefix
- Status rotations
- Dev server ID (
npm startor
tsx .Alternatively, on UNIX operating systems you can use the start.sh via sh start.sh