🎮 Macro Script for Selection

Script de automação para cliques rápidos em posições específicas da tela, ideal para seleção rápida de personagens em jogos ou automação de tarefas repetitivas.

📦 Instalação

Método Rápido - Executável (.exe) ⭐ RECOMENDADO

1. Execute o MacroClicker.exe da pasta executables/ do repositório
   • Ou da seção Releases do GitHub
2. Execute o arquivo (duplo clique)
3. Pronto! Não precisa instalar nada

Método Alternativo - Código Fonte

1. Certifique-se de ter o Python 3.7+ instalado
2. Baixe o código fonte (ZIP ou clone o repositório)
3. Abra o terminal na pasta auto_clicker e execute:

pip install -r requirements.txt
python macro_gui.py

🚀 Como Usar

📦 Método 1: Executável (.exe) - RECOMENDADO

Para usuários que não querem instalar Python:

1. Baixe o arquivo MacroClicker.exe da pasta executables/ deste repositório
   • Ou da seção Releases do GitHub
2. Execute o arquivo .exe (duplo clique)
3. Pronto! Não precisa instalar nada

Para desenvolvedores gerarem o executável:

cd auto_clicker
build_exe.bat

O executável será gerado automaticamente em executables/MacroClicker.exe e também em auto_clicker/dist/MacroClicker.exe

🖥️ Método 2: Interface Gráfica (Python)

Execute a interface gráfica para configurar tudo visualmente:

cd auto_clicker
python macro_gui.py

Ou use o arquivo iniciar.bat (duplo clique no Windows).

Recursos da GUI:

• ✅ Captura de posição do mouse em tempo real
• ✅ Configuração de tecla de ativação (padrão: F6)
• ✅ Ajuste do número de cliques
• ✅ Seleção do tipo de clique (esquerdo/direito/meio)
• ✅ Botão de teste para verificar antes de usar
• ✅ Controles de iniciar/parar intuitivos
• ✅ Sistema de atualização automática - Verifica novas versões no GitHub
• ✅ Variação aleatória - Evita detecção com cliques em posições e timing variados
• ✅ Opção de desinstalação - Remove arquivos e atalhos do sistema

📝 Método 3: Script de Linha de Comando

Para usuários avançados que preferem configuração manual:

cd auto_clicker
python macro_clicker.py

⚠️ Segurança

• Failsafe ativo: Mova o mouse rapidamente para o canto superior esquerdo da tela para parar o script em emergência
• O script usa pyautogui.FAILSAFE = True por padrão

🎯 Dicas

• Para cliques mais rápidos em sequência, aumente o número de cliques
• Para jogos, você pode precisar executar como Administrador
• Use o botão "Testar Clique" na GUI antes de iniciar o macro
• A GUI permite capturar a posição do mouse sem precisar anotar coordenadas manualmente
• Tecla padrão: F6 (pode ser alterada nas configurações)
• O sistema verifica atualizações automaticamente ao iniciar
• Use o botão "🔄 Verificar Atualizações" para verificar manualmente

✨ Novas Funcionalidades

🔄 Sistema de Atualização Automática

• Verifica automaticamente novas versões no GitHub ao iniciar
• Notifica quando há atualização disponível
• Abre o navegador automaticamente para download
• Botão manual para verificar atualizações a qualquer momento

🎲 Variação Aleatória Anti-Detecção

• Variação de posição: ±3 pixels em X e Y para cada clique
• Variação de timing: Delay aleatório entre 0.04s e 0.12s entre cliques
• Torna o padrão de cliques menos detectável por sistemas anti-bot
• Mantém precisão enquanto evita detecção

🗑️ Desinstalação

• Botão de desinstalação na interface
• Remove atalhos da área de trabalho
• Limpa arquivos de configuração
• Instruções claras para remoção completa

📁 Estrutura do Projeto

Macro Script for character selection/
├── executables/
│   └── MacroClicker.exe      # Executável pronto para download ⭐
├── auto_clicker/
│   ├── macro_gui.py          # Interface gráfica com atualização automática
│   ├── macro_clicker.py      # Script de linha de comando
│   ├── get_mouse_position.py # Utilitário para capturar coordenadas
│   ├── VERSION.txt           # Arquivo de controle de versão
│   ├── requirements.txt      # Dependências Python
│   ├── build_exe.py          # Script para gerar executável
│   ├── build_exe.bat         # Atalho para gerar executável (Windows)
│   ├── MacroClicker.spec     # Configuração do PyInstaller
│   ├── iniciar.bat           # Atalho para iniciar a GUI (Windows)
│   ├── criar_atalho_desktop.py # Script para criar atalho
│   ├── criar_atalho_desktop.bat # Atalho para criar atalho
│   ├── Imgs/
│   │   ├── icon_macro_clicker.png # Ícone PNG
│   │   └── icon_macro_clicker.ico # Ícone ICO (gerado automaticamente)
│   └── README.md             # Documentação detalhada
├── GUIA_INSTALACAO.md        # Guia completo de instalação
└── README.md                 # Este arquivo

🔧 Requisitos

Para usar o executável (.exe)

• ✅ Nenhum requisito! Apenas Windows 7 ou superior
• ✅ Não precisa instalar Python

Para executar o código fonte

• Python 3.7 ou superior
• Windows, Linux ou macOS
• Bibliotecas: pyautogui, keyboard (instaladas via pip install -r requirements.txt)

Para gerar o executável

• Python 3.7 ou superior
• PyInstaller (instalado automaticamente pelo build_exe.bat)

📝 Licença

Este projeto é fornecido "como está" para uso pessoal e educacional.

📚 Documentação Adicional

• 📥 Guia de Instalação Completo - Passo a passo detalhado para iniciantes
• 🔨 Guia de Build - Como gerar o executável

🤝 Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.