Skip to content

Template moderno em TypeScript para bots Discord com discord.js v14, incluindo comandos, subcomandos e eventos

License

Notifications You must be signed in to change notification settings

mitsukiie/Discord-Base-Typescript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Discord.js Bot Template

discord.js version license


⚡ Discord.js v14 Typescript Base

Um template moderno e flexível para criação de bots com discord.js v14 usando TypeScript. Este é o sucessor do repositório djs-template.


✨ Características

  • 📂 Slash Command Handler (suporte a comandos globais e de guilda)
  • 🧩 Subcommand Groups (suporte a subcomandos)
  • 🎯 Event Handler (eventos organizados automaticamente)
  • ⚙️ Configuração personalizável no settings.ts
  • 📝 Exemplos prontos para servir de base

🚀 Instalação

Pré-requisitos

  • Bun instalado

Instale as dependências:

bun install

Configure o .env

Crie um arquivo .env no diretório raiz com as credenciais do bot. Você pode usar o arquivo example.env como referência.


⚙️ Configuração

Toda a configuração do bot é feita em src/settings.ts.

🔹 Logs do terminal

Você pode controlar a forma como os logs são exibidos:

terminal: {
  // Modo dos logs: "minimalista" (simples) ou "informativo" (detalhado)
  mode: 'minimalista',

  // Logs de comandos
  showSlashCommandsFiles: false,    // Mostra cada arquivo de comando carregado
  showSlashCommandsRegistred: true, // Mostra quando comandos são registrados na API

  // Logs de eventos
  showEventsFiles: false,           // Mostra cada arquivo de evento carregado
  showEventsRegistred: true,        // Mostra quando eventos são registrados no client
}

🔹 Comandos globais e de servidor

Você pode optar por registrar comandos apenas em um servidor específico:

bot: {
  guildID: [], // Vazio por padrão, adicione o id para registrar comando nesse servidor
}

▶️ Execução

Inicie o bot facilmente com:

bun start

O Bun compila e executa automaticamente, sem precisar rodar tsc manualmente.


📂 Exemplos incluídos

Este template já vem com alguns exemplos para guiar você:

  • src/commands/utils/ping.ts → comando /ping
  • src/commands/utils/fruit.ts → comando com autocomplete
  • src/commands/utils/user/ban.ts → subcomando /user ban
  • src/commands/responders/ → responders + modo de uso (README.md)
  • src/events/client/ready.ts → evento ready

🛠️ Sobre este template

Este projeto está em constante evolução e será expandido com o tempo. Se encontrar algum problema ou tiver sugestões, sinta-se à vontade para abrir uma issue.


🔹 Desenvolvedor: @mitsukiie

GitHub Discord LinkedIn Email

About

Template moderno em TypeScript para bots Discord com discord.js v14, incluindo comandos, subcomandos e eventos

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published