Skip to content
NZ-LinixPublic

About

Discord.js Kit: TypeScript discord bot handler.

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

DJSKit v14

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.


FEATURES

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.

Core Features

  • Slash Commands Handler - Automatic registration and execution of Discord slash commands with full TypeScript support
  • Autocomplete - Slash command options with live suggestions via an autocomplete handler
  • Context Menu Commands - Message and user context menu commands (right-click > Apps) in src/context/Message and src/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

Developer Experience

  • TypeScript Support - Full TypeScript implementation with strict typing and modern ES2024 features
  • Error Handling & Logging - Comprehensive error catching with chalk-colored console output

Advanced Features

  • Dev Mode - DEV_MODE=true registers commands only to your dev server, DEV_MODE=false registers them globally
  • Status Rotations - Automatic bot presence updates with customizable rotation intervals

GETTING STARTED

Prerequisites

  • Node.js (v22 or higher)
  • Discord Application with Bot Token
  • Basic knowledge of TypeScript/JavaScript

Quick Start

Create a new bot with the setup walkthrough (bot token, prefix, dev server, package.json, README):

npm create djskit

Pass -y to skip the prompts, or --help to see all options for non-interactive setups.

Manual Installation

  1. Clone the repository

    git clone https://github.com/NZ-Linix/djskit.git
    cd djskit
  2. Install dependencies

    npm install
  3. Configure environment

    cp .env.example .env

    Edit .env to 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. With DEV_MODE = false, everything is global, even if a devGuildId is set.

  4. Configure bot settings Edit src/config.ts to customize:

    • Dev server ID (devGuildId, used when DEV_MODE = true)
    • Message command prefix
    • Status rotations

Running the Bot

npm start

or

tsx .

Alternatively, on UNIX operating systems you can use the start.sh via sh start.sh

About

Discord.js Kit: TypeScript discord bot handler.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages