Download the PHP package lucasgiovanni/laravel-discord-bot-installer without Composer

Laravel Discord Bot Installer

Um pacote Laravel completo para instalação e gerenciamento de bots do Discord de forma simples e rápida.

Recursos

• 🚀 Instalação automatizada com um único comando
• 💬 Suporte completo a eventos do Discord (mensagens, novos membros, reações, interações)
• ⚙️ Sistema de configuração flexível
• 🔌 Sistema de comandos personalizáveis e middleware
• 📊 Sistema de logs para monitoramento do bot
• 🛠️ Compatível com Laravel 12+
• 🛡️ Sistema de moderação (banimentos, avisos, expulsões)
• ⏰ Sistema de lembretes e mensagens agendadas
• 📈 Sistema de níveis e experiência
• 📦 Suporte a módulos/plugins
• 🌐 Suporte a múltiplos idiomas
• 🧠 Sistema de cache para otimização
• 🔄 Integração com APIs externas
• 📝 Editor de embeds visual
• 🚥 Suporte a slash commands
• 🔁 Processamento assíncrono via filas
• 📊 Sistema de telemetria opcional
• 🎭 Sistema de reaction roles automático
• 🧩 Componentes interativos (botões, menus dropdown)
• 🎫 Sistema de tickets/suporte
• 📊 API de estatísticas para integração
• 💰 Sistema de economia virtual com loja
• 🤖 Integrações com IA para moderação e respostas
• 👋 Gerador de imagens de boas-vindas
• 🛡️ Sistema avançado de auto-moderação
• 🎁 Sistema completo de giveaways e sorteios
• 📆 Eventos temporários com RSVP
• 🎯 Configurações específicas por servidor
• 🪝 Webhooks customizáveis
• 📊 Sistema de votação avançado com gráficos

Requisitos

• PHP 8.2 ou superior
• Laravel 12.x
• Conta no Discord e um bot criado no Discord Developer Portal

Instalação

1. Instale o pacote via Composer

2. Execute o comando de instalação

Este comando irá:

• Publicar os arquivos de configuração
• Configurar as variáveis de ambiente necessárias
• Criar pastas e arquivos necessários

3. Configure seu bot

Edite o arquivo .env e adicione seu token do bot Discord:

Ou configure durante a instalação quando solicitado.

4. Execute as migrações (Opcional)

Para utilizar os recursos avançados como sistema de níveis, advertências e lembretes, execute:

Configuração

Você pode personalizar o comportamento do bot editando o arquivo config/discordbot.php.

Configurações principais:

Sistema de Middleware:

O pacote agora inclui um sistema de middleware para processar comandos:

Sistema de Níveis:

Configure o sistema de níveis e experiência:

Adicionando comandos personalizados:

Uso

Iniciando o bot

Para modo debug:

Comandos padrão

O bot vem com vários comandos padrão:

Comandos básicos:

• !ping - Verificar se o bot está online e mostra a latência
• !help - Mostra a lista de comandos disponíveis

Comandos de moderação:

• !ban - Bane um usuário do servidor
• !kick - Expulsa um usuário do servidor
• !mute - Silencia um usuário
• !warn - Dá uma advertência a um usuário
• !infractions - Mostra as infrações de um usuário

Comandos utilitários:

• !remind - Define um lembrete
• !poll - Cria uma enquete
• !role - Gerencia cargos auto-atribuíveis

Lembretes agendados

Para criar um lembrete:

Sistema de níveis e XP

O bot agora rastreia a atividade dos usuários e concede XP automaticamente. Para ver o seu nível ou o ranking:

Slash Commands

O bot suporta slash commands. Para registrar comandos, execute:

Sistema de Reaction Roles

Configure reaction roles para permitir que membros obtenham cargos ao reagir a mensagens:

Você também pode usar o comando:

Sistema de Tickets

Para utilizar o sistema de tickets:

Sistema de Economia

O bot inclui um sistema completo de economia virtual:

Giveaways

Para criar sorteios no servidor:

Eventos

Para gerenciar eventos temporários:

Componentes Interativos

O bot suporta botões, menus dropdown e outros componentes interativos da API do Discord:

Auto-Moderação

Configure regras de auto-moderação para seu servidor:

Middleware

Use o sistema de middleware para filtrar comandos:

Módulos e plugins

Você pode estender o bot com módulos:

1. Crie um módulo em app/DiscordModules/MeuModulo
2. Crie um service provider para o módulo
3. Registre-o em config/discordbot.php

Traduções e suporte multi-idioma

O bot suporta múltiplos idiomas:

Comandos Artisan

• php artisan bot:install - Instala e configura o bot
• php artisan bot:run - Inicia o bot
• php artisan bot:create-command {nome} - Cria um novo comando para o bot
• php artisan bot:create-slash-command {nome} - Cria um novo slash command
• php artisan bot:process-reminders - Processa lembretes pendentes
• php artisan bot:cleanup-warnings - Limpa advertências expiradas
• php artisan bot:publish-module {nome} - Publica um módulo
• php artisan bot:generate-welcome-image - Gera template de imagem de boas-vindas
• php artisan bot:register-reaction-roles - Sincroniza reaction roles
• php artisan bot:process-giveaways - Processa sorteios ativos

API de Estatísticas

O pacote fornece uma API de estatísticas que pode ser consumida pelo seu aplicativo Laravel:

Webhooks Customizáveis

Crie webhooks para integrar o Discord com outros sistemas:

Criando comandos personalizados

1. Crie uma classe para seu comando:

2. Registre o comando no arquivo config/discordbot.php:

Eventos do Discord

O pacote suporta os seguintes eventos do Discord:

• MESSAGE_CREATE - Quando uma mensagem é enviada
• GUILD_MEMBER_ADD - Quando um novo membro entra no servidor
• REACTION_ADD - Quando uma reação é adicionada a uma mensagem
• INTERACTION_CREATE - Quando uma interação (slash command, botão) ocorre
• GUILD_MEMBER_REMOVE - Quando um membro sai do servidor
• VOICE_STATE_UPDATE - Quando alguém entra/sai de um canal de voz
• PRESENCE_UPDATE - Quando o status de um usuário muda

Você pode ativar/desativar eventos específicos no arquivo de configuração.

Usando a Facade

Para acessar as funcionalidades do bot em qualquer lugar do seu aplicativo:

Integrações com APIs externas

O pacote suporta integrações com:

• GitHub (webhooks e notificações)
• YouTube (notificações de novos vídeos)
• Spotify (status e informações)
• Twitch (notificações ao vivo)
• OpenAI (respostas inteligentes e moderação de conteúdo)
• Tenor/Giphy (GIFs)
• IMDB (informações de filmes e séries)
• Steam (informações de jogos e perfis)

Configure na seção integrations do arquivo de configuração.

Logs e Monitoramento

O bot registra informações no arquivo storage/logs/discordbot.log. Você pode configurar o nível de log no .env:

Agora também é possível enviar logs para um canal do Discord ou armazenar no banco de dados:

Processamento assíncrono

Operações pesadas são executadas em segundo plano usando filas:

Sharding para bots grandes

Para bots em muitos servidores, ative o sharding:

Contribuindo

Contribuições são bem-vindas! Por favor, sinta-se à vontade para submeter um Pull Request.

Licença

Este pacote é open-source e está disponível sob a licença MIT.

Créditos

• Lucas Giovanni
• Todos os Contribuidores

Este pacote utiliza a biblioteca Discord-PHP para interagir com a API do Discord.