Skip to content

An advanced discord bot template made with TypeScript.

License

Notifications You must be signed in to change notification settings

BUR4KBEY/ts-discord-bot

Repository files navigation

Typescript Discord Bot

🌟 About

This is an advanced discord bot template made with TypeScript.

You can easily create more advanced, complex systems with this template.

📜 Features

  • Easy to develop advanced and complex systems
    • Because you have access to everything. You can change everything whatever you want.
  • Command handler with error handling (src/classes/CommandHandler.ts)
    • Your bot doesn't crash on errors anymore. Errors will be logged to console.
  • Cooldown, permission and nsfw channel checking on commands
    • You can set up cooldowns, required permissions and requiring nsfw channel for each command uniquely.
  • Auto command & event registration and checking (src/classes/Registry.ts)
    • You don't have to spend time with defining commands and events manually.
  • Beautiful, detailed console logs (src/classes/Logger.ts)
    • More beautiful, more readable. Thats good right?
  • Full customizable discord client (src/structures/DiscordClient.ts)
    • You can easily add properties to client.

🤖 Prepared Commands

  • Dynamic help command

    • You can get command list with groups (help)
    • You can get detailed information about a command (help [command-name])
    • This command renders all your commands dynamically. You don't have to waste time about documenting commands.
    • This command shows command list to users by their permissions. Forexample developer commands won't shown in normal user's help command and they can't see detailed information about it.
    • Disabled commands won't shown in help command and users (developers included) can't see detailed information about it.
  • Reboot command (Developer command by default)

    • You don't have to reboot your bot on console. You can reboot by using this command. (reboot)
    • These events happen when reboot command run:
      • Bot stops
      • Resetting events, commands, command groups and cooldowns
      • Reregistering events and commands
      • Starting the bot again

❓ What Is The Developer Permission

  • You can create commands just usable for developers
  • Developers doesn't affected from:
    • Cooldowns
    • Permission Checking
    • NSFW Channel Checking

📥 Installation

You can use npm instead of yarn but i recommended to use yarn.

yarn install

⚙️ Setting Up

  • Rename .env.example to .env and fill it.
  • Open src/index.ts and set up moment-timezone for your locale.

🤖 Running The Bot

  • Without Building
    • Type yarn dev to run.
  • With Building
    • Type yarn build to build the project.
    • Type yarn start to run the builded project.

📌 Important

You can change client intents from src/client.ts.


🛠️ Creating Commands & Events

Commands

  • Create a new file to src/commands. (You can create files in directories)
  • Open your file.
  • Add command template.
import { Message } from 'discord.js';

import Command from '../../structures/Command';
import DiscordClient from '../../structures/DiscordClient';

export default class ExampleCommand extends Command {
    constructor(client: DiscordClient) {
        super(client, {
            name: 'example',
            group: 'Developer',
            description: 'An example command.',
            require: {
                developer: true
            }
        });
    }

    async run(message: Message, args: string[]) {
        await message.reply('Wow, example command working!');
    }
}

Events

  • Create a new file to src/events. (You can create files in directories)
  • Open your file.
  • Add event template.
import { GuildMember } from 'discord.js';

import DiscordClient from '../structures/DiscordClient';
import Event from '../structures/Event';

export default class GuildMemberAddEvent extends Event {
    constructor(client: DiscordClient) {
        super(client, 'guildMemberAdd');
    }

    async run(member: GuildMember) {
        console.log(`${member.user.tag} joined to ${member.guild.name}.`);
    }
}

You can check event parameters from discord.js.org.


⏰ Cancelling Cooldown

If you want to cancel adding command cooldown to user:

  • Open your command file

  • Add this parameter to run function:

    cancelCooldown: () => void

    It should looks like that:

    async run(message: Message, args: string[], cancelCooldown: () => void)
  • Call cancelCooldown function where you want to cancelling cooldown.

☕ Support

If you find this project useful and would like to support me, you can do so by visiting my website.

Buy me a coffee