🎯 Nexus Auto Clicker para Wabbajack

Automatize os downloads do Nexus durante a instalação de modlists no Wabbajack!

Este programa encontra e clica automaticamente no botão "Slow Download" do Nexus Mods, permitindo que você instale modlists grandes no Wabbajack sem precisar ficar clicando manualmente em cada mod.

📋 O que este programa faz?

• Detecta automaticamente o botão "Slow Download" na tela
• Clica sozinho no botão quando aparece
• Funciona em segundo plano - você pode fazer outras coisas
• Evita cliques duplos com sistema de cooldown inteligente
• Interface simples para configurar tudo facilmente

🚀 Como usar (Para iniciantes)

1️⃣ Primeira vez - Instalar o programa

1. Baixe o Python: Vá em https://python.org e baixe a versão mais recente
2. Extraia este programa em uma pasta no seu computador
3. Execute: scripts/instalar.bat (clique duas vezes nele)
4. Aguarde a instalação terminar

2️⃣ Criar template do botão

1. Abra o Nexus no seu navegador
2. Encontre um botão "Slow Download" em qualquer mod
3. Execute: scripts/criar_template.bat
4. Siga as instruções para capturar a imagem do botão

3️⃣ Usar o macro

1. Execute: scripts/iniciar.bat
2. Selecione a imagem do botão que você criou
3. Ajuste as configurações se necessário (valores padrão funcionam bem)
4. Clique em "Iniciar Macro"
5. Abra o Wabbajack e comece a instalação da modlist

⚙️ Configurações recomendadas

• Confiança: 0.8 (funciona na maioria dos casos)
• Intervalo: 1 segundo (velocidade ideal)
• Cooldown: 5 segundos (evita problemas)

🔧 Estrutura do projeto

MacroWabbajack/
├── 📁 src/              # Código principal
│   ├── nexus_autoclicker.py  # Motor do autoclicker
│   └── gui.py               # Interface gráfica
├── 📁 utils/            # Utilitários
│   ├── template_creator.py  # Criador de templates
│   └── criar_exemplo.py     # Cria exemplo de teste
├── 📁 scripts/          # Scripts de execução
│   ├── iniciar.bat         # Inicia o programa
│   ├── criar_template.bat  # Cria template do botão
│   ├── criar_exemplo.bat   # Cria botão de exemplo
│   └── instalar.bat        # Instala dependências
├── 📁 templates/        # Imagens dos botões
└── 📁 logs/            # Logs de execução

🆘 Problemas comuns

"Não encontra o botão"

• Verifique se a imagem do template está boa
• Tente diminuir a confiança para 0.7 ou 0.6
• Crie um novo template com melhor qualidade

"Python não encontrado"

• Instale o Python de https://python.org
• Marque "Add to PATH" durante a instalação

"Clica no lugar errado"

• Configure uma região específica na interface
• Use apenas a área onde o botão aparece

📝 Dependências

• Python 3.7+
• OpenCV (para detecção de imagem)
• PyAutoGUI (para controle do mouse)
• Tkinter (para interface gráfica)

⚠️ Aviso legal

Este programa é apenas para automação pessoal. Use com responsabilidade e respeite os termos de serviço do Nexus Mods.

📞 Suporte

Se tiver problemas:

1. Verifique os logs na pasta logs/
2. Teste com o botão de exemplo (scripts/criar_exemplo.bat)
3. Recrie o template do botão

---

Feito para facilitar a vida dos usuários do Wabbajack! 🎮

2. Método por Linha de Comando

Execute o macro diretamente:

python nexus_autoclicker.py

3. Criação de Templates

Use o utilitário de template para capturar a imagem do botão:

python template_creator.py

Opções disponíveis:

1. Captura interativa - Selecione a área do botão com o mouse
2. Captura por coordenadas - Digite as coordenadas manualmente
3. Teste de template - Verifica se um template funciona na tela atual

Estrutura dos Arquivos

MacroWabbajack/
├── nexus_autoclicker.py    # Classe principal do auto-clicker
├── gui.py                  # Interface gráfica
├── template_creator.py     # Utilitário para criar templates
├── requirements.txt        # Dependências do projeto
├── templates/              # Pasta para armazenar templates (criada automaticamente)
├── logs/                   # Pasta para logs (criada automaticamente)
└── README.md              # Este arquivo

Configuração Avançada

Parâmetros Principais

• Confiança (0.0-1.0): Quão similar o botão deve ser ao template (0.8 recomendado)
• Intervalo de verificação: Tempo entre cada varredura da tela (1s recomendado)
• Cooldown: Tempo mínimo entre cliques (5s evita problemas)
• Região de busca: Área específica da tela para verificar (opcional, melhora performance)

Região de Busca

Para melhor performance, você pode definir uma região específica onde o botão aparece:

clicker.set_search_region(x=500, y=300, width=600, height=400)

Teclas de Emergência

• Tecla 'Q': Para o macro imediatamente
• Mouse no canto superior esquerdo: Failsafe do PyAutoGUI

Logging

O macro gera logs detalhados em logs/nexus_autoclicker_YYYYMMDD_HHMMSS.log contendo:

• Horários de início/parada
• Detecções de botão
• Cliques realizados
• Erros encontrados

Solução de Problemas

Botão não é detectado

1. Verifique o template:

   • Use template_creator.py para criar um novo template
   • Teste o template com a opção 3 do utilitário

2. Ajuste a confiança:

   • Reduza o valor de confiança (ex: de 0.8 para 0.7)
   • Valores muito baixos podem causar falsos positivos

3. Verifique a região:

   • Certifique-se que a região de busca inclui o botão
   • Remova a região para buscar na tela inteira

Performance baixa

1. Use região de busca:

   • Defina uma área menor onde o botão aparece
   • Isso reduz significativamente o processamento

2. Aumente o intervalo:

   • Intervalos maiores (2-3s) consomem menos recursos
   • Para uso normal, 1s é adequado

Cliques múltiplos

1. Aumente o cooldown:
   • Use valores de 5-10 segundos entre cliques
   • Evita cliques desnecessários no mesmo botão

Tecnologias Utilizadas

• OpenCV - Reconhecimento de imagem e template matching
• PyAutoGUI - Controle de mouse e captura de tela
• Tkinter - Interface gráfica
• Threading - Execução em segundo plano
• Keyboard - Detecção de teclas de atalho

Compatibilidade

• Sistema: Windows 10/11
• Python: 3.7+
• Resolução: Funciona em qualquer resolução (com template adequado)
• Temas: Compatível com temas claros e escuros (depende do template)

Avisos Importantes

• Este software é para uso pessoal e educacional
• Use com responsabilidade e respeite os termos de serviço do Nexus Mods
• Teste sempre em um ambiente controlado antes do uso real
• Mantenha backups de templates funcionais

Suporte

Para problemas ou dúvidas:

1. Verifique os logs em logs/
2. Teste o template com template_creator.py
3. Revise as configurações na interface gráfica
4. Certifique-se que todas as dependências estão instaladas

---

Nota: Este macro foi desenvolvido para facilitar o processo de instalação de modlists do Wabbajack, automatizando uma tarefa repetitiva. Use com bom senso e responsabilidade.