🤖 Automação e Análise de Dados para Crash Games (SpaceMan)

⚠️ Status do Projeto: Arquivado/Código Perdido. Este repositório documenta a lógica e arquitetura de dois scripts independentes desenvolvidos em Python para automação (RPA) e análise estatística no jogo SpaceMan.

🎯 O Objetivo

O projeto consistia em duas ferramentas distintas: uma focada na coleta massiva de dados para identificar padrões de horário (RTP) e outra focada na execução de ordens baseadas em grupos de sinais (Telegram), com validação de lucratividade antes do risco real.

📂 Estrutura do Projeto

O sistema era composto por dois scripts que operavam separadamente:

🐍 Script 1: O "Observador" (Data Logger)

Focado puramente em estatística e monitoramento 24/7.

• Função: Monitorar a tela do jogo continuamente.
• Lógica:
  • Identificava o momento do "Crash" via Visão Computacional.
  • Verificava se o multiplicador atingiu um alvo pré-definido (ex: 1.5x).
  • Registrava em log: Horário | Multiplicador Final | Resultado (Win/Loss).
• Objetivo: Criar uma base de dados histórica para identificar os melhores horários para operar.

🐍 Script 2: O "Executor" (Bot de Sinais)

Focado na interação com APIs de mensagens e execução de estratégias.

• Integração via Telethon: Ao invés de ler a tela, o script conectava-se diretamente à API do Telegram usando a biblioteca Telethon. Isso permitia "escutar" novas mensagens no grupo VIP em tempo real (baixa latência) usando eventos assíncronos (events.NewMessage).
• Gestão de Banca (Martingale):
  • Entrava na rodada instantaneamente ao receber o payload da mensagem.
  • Se perdesse, dobrava a aposta na próxima (até o limite de 3 tentativas).
  • Se ganhasse, resetava o valor para a aposta inicial.
• Modo "Paper Trading" (Simulação):
  • O script possuía uma funcionalidade de segurança controlada via Feature Toggle (comentando a linha de execução).
  • Modo Ativo: O bot clicava e apostava dinheiro real.
  • Modo Passivo: O bot processava o sinal, calculava o resultado teórico e gerava um log de "Lucro Simulado", permitindo validar a assertividade do grupo no dia sem arriscar capital.

🧠 Fluxo de Decisão (Script Executor)

1. Event Listener (Telethon): A API dispara um evento ao detectar nova mensagem: {"text": "Entrar agora", "chat_id": 12345}.
2. Verificação de Modo: A flag de execução está ativa?
   • Se Inativa: Loga no console: "Sinal recebido. Teria apostado R$ 2,00". Monitora o resultado e conclui: "Teria sido WIN".
   • Se Ativa: Dispara o PyAutoGUI para mover o mouse e confirmar a aposta.
3. Execução:
   • Tentativa 1: Aposta Base. (Loss? ❌) -> Calcula o dobro.
   • Tentativa 2: Aposta Dobrada. (Win? ✅) -> Para e aguarda próximo sinal.

🛠 Stack Tecnológica

• Linguagem: Python (AsyncIO).
• Integração: Telethon (Cliente API do Telegram) para leitura de eventos em tempo real.
• Visão Computacional: OpenCV (para ler os multiplicadores na tela do jogo e validar o resultado).
• Automação: PyAutoGUI (para controle de input no jogo).
• Lógica: Algoritmos de progressão geométrica (Martingale) e tratamento de dados.

💡 Aprendizados Chave

• Programação Assíncrona: Uso de async/await com Telethon para gerenciar eventos de chat sem bloquear o loop principal do bot.
• Feature Toggles: Implementação manual de chaves de funcionalidade para testes seguros em produção ("Paper Trading").
• Análise de Viabilidade: Uso de dados simulados para validar a eficiência de terceiros antes de comprometer recursos financeiros.

---

Documentação reconstruída por Murilo