O BotBanana é um framework hiper-modular desenvolvido em Node.js e Discord.js. Ele transforma servidores do Discord em comunidades altamente engajadas através de economia virtual, auto-roles por atividade, IA integrada, RPG de mesa interativo e assaltos PVP.
Movimentamos toda a documentação avançada para a nossa Wiki! Consulte os links abaixo para masterizar o bot:
- 🏠 Página Inicial da Wiki: Explore todos os guias e manuais de recursos do bot.
- 🏗️ Arquitetura de Software: Descubra como a engine do bot funciona sob o capô, os 8 domínios e a infraestrutura do banco de dados (ideal para desenvolvedores).
- 🚀 Guia de Deploy Automático: Manuais detalhados para rodar o bot no PM2, no Docker Compose, ou automatizar atualizações pelo GitHub Actions na sua VPS Linux.
- 🏆 Auto Roles & Conquistas Automáticas: Atribuição automática de cargos por XP de texto, tempo em chamadas de voz e atividade semanal.
- 💰 Economia & Banco Virtual: Sistema de saldo, transferências, Mercado Global e Bolsa de Valores de Itens.
- 🥷 Sistema de Assaltos & Prisão: Comando
!roubarPvP, itens estratégicos defensivos/ofensivos (Escudo de Espinhos) e sistema de fiança. - ⚔️ Guerras de Servidores (Raids): Disputa estratégica e roubos massivos interservidores (Cross-Guild).
- 🐉 World Boss & Mini Boss: Lutas contra monstros de fase, ranking de dano cooperativo, e forja de armas.
- 🍌 Menu Hub Central (
!menu): Navegação fluida com UI limpa via Message Components (Select Menus e botões interativos). - 🎬 Integração IA e Voz: Integração robusta com a API do Gemini e da OpenAI, Geração de imagens via Stable Diffusion (Forge) e envio automático de clipes (Reels) usando Edge-TTS e Google WaveNet.
Se você é desenvolvedor e quer rodar o bot no seu PC para testar, siga os passos abaixo:
- Node.js:
>= 18.0.0 - Aplicação criada no Discord Developer Portal com a intent GUILD_MEMBERS ativada.
# 1. Clone o projeto e entre na pasta
git clone https://github.com/dreyvinixz/bot-banana.git
cd bot-banana
# 2. Instale os pacotes e dependências
npm ci
# 3. Defina seus tokens e credenciais
cp .env.example .env
# 4. (Opcional) Valide a integridade do código com nossa suíte automatizada de testes
npm test
# 5. Inicialize a engine
npm startDistribuído sob a licença MIT.
Desenvolvido por dreyvinixz & Comunidade Caberé.