DiscordArch
é uma biblioteca para facilitar o desenvolvimento de bots no Discord usando decorators para comandos e eventos, além de utilitários para envio de mensagens e embeds. Ideal para quem deseja um código organizado e de fácil manutenção.
Instale a biblioteca usando o npm:
npm install discordarch
Começando
-
- Crie o seu bot: Primeiro, você precisará de um bot registrado no Discord e do seu token. Coloque o token no lugar indicado no código a seguir.
-
- Configuração básica: Configure um arquivo principal (bot.js) para iniciar o cliente Discord e utilizar o DiscordArch.
Exemplo de Uso
No arquivo src/bot.js, configure o bot e registre os comandos e eventos que deseja utilizar.
const { Client, GatewayIntentBits } = require('discord.js');
const { DiscordArch } = require('discordarch');
const PingCommand = require('./commands/ping');
const ReadyEvent = require('./events/ready');
const client = new Client({
intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages],
});
const discordArch = new DiscordArch(client);
// Inicialize o bot
discordArch.init();
// Registre os comandos e eventos
discordArch.registerCommand(new PingCommand());
discordArch.registerEvent(new ReadyEvent());
client.login('YOUR_BOT_TOKEN'); // Substitua pelo seu token do bot
Para criar um comando, você utiliza o decorator @Command. Aqui está um exemplo básico de um comando ping.
Arquivo: src/commands/ping.js
const { Command } = require('discordarch');
class PingCommand {
@Command('ping', 'Responde com Pong!')
async execute(interaction) {
await interaction.reply('Pong!');
}
}
module.exports = PingCommand;
-
Nome do Comando: ping
-
Descrição: Responde com Pong!
Você pode utilizar o decorator @Event para registrar eventos do Discord, como ready, messageCreate, entre outros.
Arquivo: src/events/ready.js
const { Event } = require('discordarch');
class ReadyEvent {
@Event('ready')
execute(client) {
console.log(`Bot iniciado como ${client.user.tag}`);
}
}
module.exports = ReadyEvent;
Este evento ready será chamado quando o bot for iniciado com sucesso e estiver online.
O MessageHelper oferece métodos para facilitar o envio de mensagens e criação de embeds.
Enviando uma Mensagem Simples
const { MessageHelper } = require('discordarch');
// No seu comando ou evento
MessageHelper.sendTextMessage(channel, 'Olá, mundo!');
//Enviando um Embed
//O MessageHelper permite a criação de embeds personalizados com campos como cor, título, descrição, imagem, entre outros.
const { MessageHelper } = require('discordarch');
No seu comando ou evento
MessageHelper.sendEmbedMessage(channel, {
color: '#ff0000',
title: 'Título do Embed',
description: 'Descrição do Embed',
footer: 'Footer aqui',
fields: [
{ name: 'Campo 1', value: 'Valor do campo 1', inline: true },
{ name: 'Campo 2', value: 'Valor do campo 2', inline: true },
],
timestamp: true,
});
` Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e enviar pull requests para melhorar o DiscordArch.
Licença
Distribuído sob a licença MIT. Consulte LICENSE para mais informações.
`