InviteTracker

O que é a classe InviteTracker?

A classe InviteTracker é usada para monitorar e gerenciar os convites enviados para um servidor no Discord. Ela permite rastrear quais convites foram usados por novos membros e envia mensagens de boas-vindas personalizadas aos usuários, incluindo informações sobre quem os convidou.

Configurando a Classe

Para usar a classe InviteTracker, você precisa passar o bot como argumento ao instanciá-la. Ela usa a API do Discord para obter e atualizar as informações de convite.


// Exemplo de configuração
const { InviteTracker, Bot} = require('simple-discord-lib');
const bot = new Bot("token")
bot.connect();

const inviteTracker = new InviteTracker(bot);
    

Usando a Classe

Criando o Arquivo JSON de Convites

Use o método createInviteJSON para criar um arquivo invites.json para um servidor específico. Esse arquivo irá armazenar os convites e informações relacionadas.


// Criando o arquivo JSON de convites
inviteTracker.createInviteJSON('guild_id', './', 'invites.json');
      

Obtendo Convites da Guilda

Use o método getGuildInvites para buscar os convites atuais de uma guilda.


// Obtendo os convites de uma guilda
const invites = await inviteTracker.getGuildInvites('guild_id');
console.log(invites);
      

Rastreando Convites Usados

Use o método trackInvites para rastrear qual convite foi usado por um membro ao entrar no servidor e para atualizar a contagem de convites do usuário.


// Rastreando o convite usado por um membro
inviteTracker.trackInvites(member);
      

Carregando Dados de Convites

O método loadInviteData carrega os dados de convites armazenados no arquivo JSON para um servidor específico.


// Carregando os dados de convites
const inviteData = inviteTracker.loadInviteData('guild_id');
console.log(inviteData);
      

Atualizando a Contagem de Convites

Use o método updateInviteCount para atualizar o número de convites usados por um usuário específico.


// Atualizando a contagem de convites de um usuário
inviteTracker.updateInviteCount('guild_id', 'user_id');
      

Enviando uma Mensagem de Boas-Vindas

O método sendWelcomeMessage envia uma mensagem personalizada de boas-vindas para o canal escolhido, mencionando quem convidou o novo membro.


// Enviando uma mensagem de boas-vindas
inviteTracker.sendWelcomeMessage(member, inviterTag);
      

Monitorando Convites

O método monitorInvites monitora e atualiza os convites de um servidor, verificando se houve alterações nas quantidades de usos dos convites.


// Monitorando e atualizando convites
inviteTracker.monitorInvites('guild_id', invitesData);
      

Configurando a Mensagem de Boas-Vindas

Use o método setWelcomeMessage para configurar a mensagem de boas-vindas e o canal onde ela será enviada.


// Configurando a mensagem de boas-vindas
inviteTracker.setWelcomeMessage('guild_id', 'Nova mensagem', 'channel_id');
      

Monitorando e Atualizando Convites

A classe permite monitorar o uso de convites em tempo real, atualizando os dados de convites armazenados sempre que um novo membro entra no servidor, e possibilita a personalização das mensagens de boas-vindas com informações sobre quem convidou o usuário.


// Iniciando o rastreamento e monitoramento de convites
inviteTracker.trackInvites(member);