Files
WIPdiscordbot/README.md
T
2025-08-01 14:23:10 +01:00

100 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#🧙 World of Warcraft Dungeon Group Bot (WoW LFG Bot)
Este é um bot desenvolvido em Python com discord.py, desenhado para automatizar e organizar a criação de grupos de dungeons míticas+ (Mythic+) no Discord, facilitando a marcação, inscrição e gestão de jogadores segundo as suas roles e classes no World of Warcraft.
##⚙️ Funcionalidades principais
🎯 Criação de Grupos com embed interativo que mostra:
Dungeon escolhida
Nível da chave (+X)
Data e hora da marcação
Lista dinâmica de jogadores por role e classe
🧩 Inscrição por Role (Tank, Healer, DPS) com limite automático:
1 Tank
1 Healer
3 DPS
🧙 Escolha de Classe apenas após escolher a role, com ícones e nomes específicos de cada especialização.
⛔ Sistema de bloqueio por jogador:
Apenas um jogador pode inscrever-se de cada vez.
O processo de escolha de role é bloqueado até que a classe seja selecionada.
🏰 Seleção de Dungeon e Dificuldade com menus suspensos (SelectDropdown)
Apenas configurável uma vez
O título do post (thread) é atualizado com a dungeon e dificuldade
📆 Definição de Data e Hora com Modal
Garante que os grupos sejam marcados para o futuro
🧹 Autoapagamento do Post
O post do grupo é automaticamente apagado 30 minutos após a hora marcada
📬 Criação de Posts no canal de fórum
Permite criar threads com nomes customizados e eliminar menus após uso
💡 Tecnologias utilizadas
discord.py (API de bots do Discord)
python-dotenv (Gestão de tokens e variáveis de ambiente)
asyncio (tarefas agendadas como apagar post)
datetime (gestão de datas e marcações)
Discord UI components (botões, dropdowns, modals)
🚀 Como usar
Cria um servidor com canal do tipo fórum chamado lfg
Usa o comando /criargrupo ou !criargrupo para iniciar um novo grupo
Os jogadores devem escolher a role → classe → e ficam inscritos
Dungeon, dificuldade e data são definidas com menus intuitivos
O grupo é removido automaticamente 30 minutos após a hora da run
📌 Exemplo visual
plaintext
Copy
Edit
Dungeon: The Dawnbreaker
Dificuldade: 12
Marcação: 08/08/2025 às 21:30
🛡️ Tank
- João (Protection Paladin)
💚 Healer
- Maria (Restoration Druid)
⚔️ DPS
- Ana (Fire Mage)
- Rui (Outlaw Rogue)
- Pedro (Marksmanship Hunter)
🔐 Segurança
O bot respeita os limites de cada role
Impede que mais do que um jogador escolha role em simultâneo
Elimina interações após uso para evitar spam
👨‍💻 Desenvolvido por
Kl3z este projeto é open-source e pode ser adaptado para qualquer comunidade WoW.