discordarch

1.2.1 • Public • Published

DiscordArch

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.

Instalação

Instale a biblioteca usando o npm:

npm install discordarch

Começando

    1. 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.
    1. Configuração básica: Configure um arquivo principal (bot.js) para iniciar o cliente Discord e utilizar o DiscordArch.

Exemplo de Uso

1. Inicialização do Bot

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

2. Criando Comandos

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!

3. Criando Eventos

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.

4. Forma diferente de construir uma embed

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.

`

Package Sidebar

Install

npm i discordarch

Weekly Downloads

6

Version

1.2.1

License

MIT

Unpacked Size

1.62 MB

Total Files

345

Last publish

Collaborators

  • vnmegumin