Skip to content

Ismaelbrendo/StudyBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📚 StudyBot - Bot de Controle de Estudos para Discord

Bot para Discord desenvolvido para gerenciar e monitorar canais de estudo, promovendo produtividade através de rankings, controle de horas e sistema de premiações.

✨ Funcionalidades

Monitoramento de Estudo

  • Registro automático de horas de estudo por membro
  • Controle de entrada e saída dos canais de voz
  • Histórico detalhado de sessões de estudo

Sistema de Rankings

  • Ranking semanal, mensal e geral
  • Visualização de top usuários por tempo de estudo
  • Estatísticas individuais e do servidor

Controle de Câmera e Tela

  • Verificação obrigatória de câmera em canais específicos
  • Detecção de compartilhamento de tela
  • Remoção automática de usuários que não cumprem requisitos
  • Sistema de avisos antes da remoção

Sistema de Premiações

  • Badges e conquistas personalizáveis
  • Sistema de pontos e recompensas
  • Premiações configuráveis por administradores
  • Reconhecimento de marcos de estudo

🚀 Instalação

Pré-requisitos

  • Python 3.8 ou superior
  • Conta de desenvolvedor Discord
  • Servidor Discord com permissões de administrador

Passos

  1. Clone o repositório git clone https://github.com/seu-usuario/studybot.git cd studybot

text

  1. Instale as dependências pip install -r requirements.txt

text

  1. Configure o arquivo .env DISCORD_TOKEN=seu_token_aqui DATABASE_URL=sqlite:///studybot.db

text

  1. Execute o bot python main.py

text

⚙️ Configuração

Comandos de Administração

  • /setup - Configuração inicial do bot no servidor
  • /set_study_channel - Define canais de estudo
  • /set_camera_required - Ativa requisito de câmera
  • /set_rewards - Configura sistema de premiações

Comandos de Usuário

  • /stats - Visualiza suas estatísticas
  • /ranking - Exibe ranking do servidor
  • /my_hours - Mostra seu tempo total de estudo
  • /leaderboard - Rankings semanal/mensal

📊 Estrutura do Banco de Dados

O bot utiliza SQLite para armazenar:

  • Sessões de estudo por usuário
  • Configurações do servidor
  • Sistema de pontos e conquistas
  • Histórico de avisos e remoções

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se livre para:

  1. Fazer fork do projeto
  2. Criar uma branch para sua feature
  3. Commit suas mudanças
  4. Push para a branch
  5. Abrir um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📧 Suporte

Para dúvidas ou sugestões, abra uma issue no GitHub ou entre em contato através do servidor de suporte.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors