📕 Bot de Advertência Discord - Flextor Network

📌 Visão Geral

Este bot foi desenvolvido para servidores Discord que necessitam de uma ferramenta automatizada para advertências e banimentos. Ele permite aplicar advertências verbais ou formais e pode escalar automaticamente as punições com base em reincidência.

💡 Ideal para comunidades que desejam manter disciplina com registro e feedback transparente aos membros.

⚙️ Funcionalidades

Advertência verbal e formal, com registro no banco de dados.
Banimento, com registro no banco de dados.
Sistema de punições automáticas baseado no histórico do usuário.
Suporte a botões interativos e modais para interface intuitiva.
Uso de embeds padronizados para avisos claros.
Banco de dados SQLite embutido (warnings.db).
Sistema de permissão por cargo: apenas moderadores autorizados podem punir.
Registro persistente mesmo após reinício do bot.

🛠️ Configuração

1. Instalar Dependências

Na pasta do bot, execute:

npm install

2. Configurar Token do Bot

Crie um arquivo chamado .env na raiz do projeto com o seguinte conteúdo:

DISCORD_TOKEN=SEU_TOKEN_DO_BOT_AQUI

3. Executar o Bot

node index.js

Ao iniciar, o bot conecta ao Discord e cria (caso não exista) o banco de dados warnings.db.

🧠 Funcionamento Interno

Estrutura de Banco de Dados

Tabela: warnings

user_id

adv

verbal

ID do usuário

Nº de advertências formais

Nº de advertências verbais

Como Funcionam as Advertências

O moderador interage com um botão no Discord.
Um modal se abre para inserir o motivo.
A ação é registrada em warnings.db.
O bot responde com um embed indicando a advertência.
Após atingir determinados níveis de advertência, ações automáticas podem ser tomadas (como banimento).

🧩 Permissões

const SPECIAL_ROLE_ID = 'ID';

Altere esse valor conforme o cargo moderador do seu servidor.

ADV_CHANNEL_ID = ID DO CANAL

Altere esse valor conforme o canal do discord.

BAN_CHANNEL_ID = ID DO CANAL

Altere esse valor conforme o canal do discord.

COMMAND_CHANNEL_ID = ID DO CANAL

Altere esse valor conforme o canal do discord.

ADV_VERBAL_ROLE = IID DO CARG