Update README.md

README.md

@@ -1,31 +1,98 @@
-# 🛡️ WIP Dungeon Organizer Bot — by kl3z
+🧙 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.
 
-Bot para Discord criado para a comunidade **Work-in-Progress (WIP)**, que permite aos jogadores de **World of Warcraft** organizarem-se automaticamente em grupos para dungeons, de forma prática e interativa.
+⚙️ Funcionalidades principais
+🎯 Criação de Grupos com embed interativo que mostra:
 
----
+Dungeon escolhida
 
-## ✨ Funcionalidades
+Nível da chave (+X)
 
-- 🎭 **Reações por role** – jogadores escolhem ser:
+Data e hora da marcação
-  - 🛡️ **Tank**
-  - 💚 **Healer**
-  - ⚔️ **DPS**
 
-- 📊 **Limites automáticos por role**:
+Lista dinâmica de jogadores por role e classe
-  - 1 Tank, 1 Healer e 3 DPS por grupo.
 
-- 🧙 **Seleção de classes** com dropdowns personalizados, incluindo ícones das classes.
+🧩 Inscrição por Role (Tank, Healer, DPS) com limite automático:
 
-- 🏰 **Escolha da dungeon e dificuldade da mesma** (de 0 a 20+) via menus interativos.
+1 Tank
 
-- 📅 **Definição de data e hora** através de modal intuitivo.
+1 Healer
 
-- ♻️ **Atualização dinâmica** do embed com os inscritos e respetivas classes.
+3 DPS
 
----
+🧙 Escolha de Classe apenas após escolher a role, com ícones e nomes específicos de cada especialização.
 
-## ⚙️ Comando principal
+⛔ Sistema de bloqueio por jogador:
 
-```bash
+Apenas um jogador pode inscrever-se de cada vez.
-!criargrupo
+
+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.