O Izuko Bot VIP v1.5 é um bot multifuncional para WhatsApp, desenvolvido em Node.js, projetado para administrar e moderar grupos, além de oferecer uma vasta gama de funcionalidades de entretenimento e utilidade para os membros. Sua arquitetura é modular, permitindo a fácil adição e manutenção de comandos e sistemas.
O bot utiliza a biblioteca @whiskeysockets/baileys para se conectar à API do WhatsApp, garantindo uma comunicação estável e eficiente. A persistência de dados, como configurações de grupos, rankings, advertências e outros, é realizada através de arquivos JSON armazenados localmente no diretório banco de dados, funcionando como um sistema de banco de dados simples e baseado em arquivos.
| Tecnologia | Propósito |
|---|---|
| Node.js | Ambiente de execução para o bot. |
| @whiskeysockets/baileys | Biblioteca principal para a conexão com o WhatsApp. |
| Axios | Cliente HTTP para realizar requisições a APIs externas (ex: GPT, upload de mídias). |
| Chalk | Estilização de logs no console para melhor legibilidade. |
| Fluent-ffmpeg | Manipulação e conversão de mídias (áudio e vídeo). |
| Moment-timezone | Gerenciamento de datas e fusos horários. |
| Node-cron | Agendamento de tarefas (cron jobs). |
| Pino | Logger para registrar eventos e depurar o código. |
A estrutura do projeto é organizada para separar a lógica principal, os comandos, as configurações e os dados.
Izuko-Bot-VIP-V1.5/
├── commands/ # Contém todos os arquivos de comandos individuais.
├── banco de dados/ # Armazena os arquivos JSON que funcionam como banco de dados.
│ ├── admin_status/ # (Exemplo) Status de administrador em grupos.
│ ├── advertencias.json # Registros de advertências.
│ └── ... # Outros arquivos de configuração e dados.
├── escanear/ # Módulos para monitoramento (ex: entrada de membros).
│ └── scanner.js
├── settings/ # Configurações e bibliotecas de suporte.
│ ├── lib/ # Módulos de lógica de negócios (ranking, antilink, etc.).
│ └── settings.json # Configurações globais do bot (prefixo, dono, etc.).
├── node_modules/ # Dependências do Node.js.
├── main.js # Ponto de entrada principal da aplicação.
├── package.json # Define os metadados do projeto e as dependências.
└── start.sh # Script de inicialização.
O arquivo main.js é o coração do bot. Ele é responsável por:
Carrega todas as dependências necessárias, lê e carrega todos os arquivos de comando do diretório /commands para um Map do JavaScript.
Inicializa a conexão com o WhatsApp usando makeWASocket e gerencia a autenticação via código de pareamento.
Monitora eventos como connection.update, messages.upsert e group-participants.update.
Cada comando é um módulo Node.js que exporta um objeto com uma estrutura padronizada. Isso torna o bot extensível e fácil de manter.
Exemplo de um comando simples (ping.js):
module.exports = {
name: 'ping',
aliases: [], // Apelidos para o comando
async execute({ lux, msg, from }) { // Função principal
const latencia = (Date.now() / 1000) - msg.messageTimestamp;
await lux.sendMessage(from, {
text: `*Latência:* ${latencia.toFixed(3)} segundos`
}, { quoted: msg });
}
};
| Propriedade | Descrição |
|---|---|
name |
O nome principal do comando, usado para invocá-lo. |
aliases |
Uma lista de nomes alternativos (apelidos) para o mesmo comando. |
execute |
A função assíncrona que contém a lógica do comando. Recebe um objeto de contexto com todas as ferramentas e informações da mensagem. |
isKeyword |
(Opcional) Se true, o comando é acionado por uma palavra-chave específica, sem a necessidade de prefixo. |
Um dos pilares do Izuko Bot é seu robusto sistema de moderação, projetado para manter a ordem e a segurança nos grupos.
Este sistema permite diferentes níveis de restrição contra o envio de links no grupo. Cada comando ativa um nível de punição diferente, oferecendo flexibilidade para os administradores.
| Nível | Comando | Ação |
|---|---|---|
| 1 | &anti-link |
Apaga a mensagem com o link. |
| 2 | &anti-link2 |
Aplica uma advertência ao usuário. |
| 3 | &anti-link3 |
Remove o usuário do grupo. |
| 4 | &anti-link4 |
Bane o usuário (remove permanentemente). |
| 5 | &anti-link5 |
Silencia (muta) o usuário. |
O bot implementa um sistema de gamificação para incentivar a participação dos membros nos grupos, baseado em XP, pontos e patentes.
Os membros ganham XP ao interagir no grupo (enviando mensagens), com um cooldown de 2 minutos para evitar flood.
Ao atingir 100 XP, o XP acumulado é automaticamente convertido em Pontos (200 pontos por XP).
Ao acumular 3000 pontos, o membro sobe de nível, alcançando uma nova patente. O bot anuncia a promoção no grupo.
O bot oferece uma variedade de jogos e comandos interativos para engajar os membros do grupo.
Permite que dois jogadores disputem uma partida de Jogo da Velha diretamente no chat do grupo.
Um jogo de caça-níqueis onde os usuários podem apostar pontos para tentar ganhar mais.
Aposta pontos em um jogo de cara ou coroa com chance de dobrar a aposta.
Inicia uma rodada do jogo "Eu Nunca" com perguntas aleatórias do banco de dados.
Exibe o menu principal do bot com todos os comandos disponíveis, informações sobre o bot e o ping atual.
Verifica a latência do bot, mostrando o tempo de resposta em segundos.
Converte uma imagem, vídeo ou GIF em uma figurinha (sticker) do WhatsApp.
Converte uma figurinha (sticker) de volta para uma imagem.
Cria uma figurinha animada (&attp) ou estática (&ttp) a partir de um texto.
Realiza operações matemáticas básicas entre dois números.
Remove um membro do grupo. O dono do bot não pode ser banido.
Promove um membro a administrador ou remove os privilégios de administrador.
Marca todos os membros do grupo em uma mensagem.
Abre ou fecha o grupo para que apenas administradores possam enviar mensagens.
Apaga uma mensagem do grupo (responda à mensagem que deseja apagar).
Altera a descrição, nome ou foto de perfil do grupo.
Obtém o link de convite do grupo ou redefine o link (invalida o anterior).
Agenda o fechamento do grupo para um horário específico.
Inicia uma votação no grupo com múltiplas opções.
Ativa ou desativa a proteção Anti-Link com diferentes níveis de punição (apagar, advertir, remover, banir, mutar).
Ativa ou desativa a proteção Anti-Flood (previne spam de mensagens).
Ativa ou desativa a proteção Anti-Imagem (impede o envio de imagens).
Silencia um membro por um período determinado ou permanentemente.
Remove o silenciamento de um membro.
Aplica uma advertência formal a um membro. Ao atingir 3 advertências, o usuário é banido automaticamente.
Consulta o número de advertências de um membro ou remove todas as advertências.
Ativa ou desativa o sistema de boas-vindas para novos membros.
Define a mensagem de boas-vindas personalizada. Use @user para mencionar o novo membro e @grupo para o nome do grupo.
Consulta o nível, patente e pontos de um membro.
Exibe o ranking geral dos membros do grupo ordenado por pontuação.
Consulta seu XP atual acumulado.
(Admin) Adiciona pontos ou XP manualmente a um membro.
Converte seu XP acumulado em pontos seguindo a taxa de conversão configurada.
Ativa ou desativa o sistema de ranking no grupo.
(Admin) Cria um backup do sistema de ranking ou restaura a partir de um backup.
Inicia um jogo da velha contra outro jogador.
Faz uma jogada no jogo da velha ativo.
Cancela o jogo da velha ativo sem declarar vencedor.
Joga cara ou coroa apostando pontos. Se acertar, ganha o dobro; se errar, perde os pontos.
Joga no cassino (caça-níqueis) apostando pontos. Dependendo da combinação, pode ganhar múltiplos da aposta.
Inicia uma rodada do jogo "Eu Nunca" com perguntas aleatórias do banco de dados.
Baixa o áudio de um vídeo do YouTube a partir de um link ou termo de busca.
Baixa um vídeo do YouTube a partir de um link ou termo de busca.
Baixa vídeos e fotos do Instagram.
Faz o download de arquivos do Mediafire ou MEGA.
Converte um vídeo em áudio MP3.
Faz upload de uma mídia para o Catbox ou Google Drive e retorna o link.
Edita uma imagem usando inteligência artificial com base em um prompt.
Ativa ou desativa o bot em um grupo específico.
Reinicia o bot, recarregando todas as configurações.
Conversa com uma IA (GPT) no privado.
Altera o prefixo dos comandos ou exibe o prefixo atual.
Faz o bot entrar em um grupo através de um link de convite.
Faz o bot sair automaticamente de grupos inativos.
O bot pode ser facilmente customizado através do arquivo settings/settings.json e de outros arquivos de configuração.
Este é o arquivo de configuração principal, onde você pode definir os parâmetros essenciais do bot.
{
"prefix": "&",
"ownerNumber": "SEU_NUMERO@lid",
"botLid": "NUMERO_DO_BOT@lid",
"nomeBot": "Izuko Privat",
"nomeDono": "Seu Nome",
"versao": "1.5"
}
| Chave | Descrição |
|---|---|
prefix |
O caractere usado para invocar os comandos (ex: &menu). |
ownerNumber |
O JID (ID do WhatsApp) do dono do bot. Garante acesso a comandos restritos. |
botLid |
O JID do próprio bot. |
nomeBot |
O nome do bot que aparecerá em mensagens como o menu. |
nomeDono |
O nome do dono que aparecerá em mensagens. |
versao |
A versão atual do bot. |
.js na pasta /commands seguindo a estrutura de comando padrão./commands.banco de dados/menu img e banco de dados/audio menu. O bot selecionará um aleatoriamente ao executar o comando &menu.O Izuko Bot VIP v1.5 é uma solução poderosa e flexível para gerenciamento de grupos no WhatsApp. Sua arquitetura modular facilita a manutenção e a expansão com novas funcionalidades. A combinação de ferramentas de moderação, sistemas de engajamento e comandos de utilidade o torna um assistente completo para qualquer comunidade online.