Introdução

O bonktools é uma biblioteca TypeScript que conecta ao bonk.io diretamente pelo protocolo do jogo (Socket.IO), sem abrir um navegador. Com ele cria salas, controla equipas e jogadores, reage a eventos e mantém uma sala funcionando 24 horas por dia.

Por que existe

Automatizar o bonk.io com Puppeteer exige um navegador completo por sala, com ecrã virtual no Linux e automação de interface frágil. O bonktools troca isso por uma conexão leve: cada sala é só um socket, e todo o comportamento (eventos, equipas, reconexão) é código TypeScript tipado.

O que dá para fazer

• Criar e entrar em salas como host, jogador ou espectador.
• Reagir a eventos de jogadores, chat, equipas e partidas.
• Mover jogadores entre equipas, bloquear as equipas e moderar (kick/ban).
• Detetar jogadores AFK por movimento e por chat.
• Iniciar e parar partidas, com o estado inicial correto para cada mapa.
• Manter várias salas vivas com uma única conta, com reconexão automática.

Como o projeto se organiza

BonkSession       pool de salas, autenticação compartilhada, throttle
  └── BonkRoom    estado, eventos tipados, reconexão, equipas, lock, anti-AFK
        └── BonkTransport   Socket.IO v2 (EIO=3) + TLS
              └── bonk.io

Próximos passos

• Instalação e primeiro bot: Execute seu primeiro bot em minutos.
• Criar e entrar em salas: todas as opções.
• Estado e eventos: reaja ao que acontece na sala.