Introducción

bonktools es una biblioteca TypeScript que se conecta a bonk.io directamente por el protocolo del juego (Socket.IO), sin abrir un navegador. Con ella creas salas, controlas equipos y jugadores, reaccionas a eventos y mantienes una sala funcionando las 24 horas.

Por qué existe

Automatizar bonk.io con Puppeteer exige un navegador completo por sala, una pantalla virtual en Linux y una automatización frágil de la interfaz. bonktools lo sustituye por una conexión ligera: cada sala es solo un socket, y todo el comportamiento (eventos, equipos, reconexión) es código TypeScript tipado.

Qué puedes hacer

• Crear y entrar en salas como host, jugador o espectador.
• Reaccionar a eventos de jugadores, chat, equipos y partidas.
• Mover jugadores entre equipos, bloquear los equipos y moderar (kick/ban).
• Detectar jugadores AFK por movimiento y por chat.
• Iniciar y detener partidas, con el estado inicial correcto para cada mapa.
• Mantener varias salas vivas con una sola cuenta, con reconexión automática.

Cómo está organizado el proyecto

BonkSession       pool de salas, autenticación compartida, throttle
  └── BonkRoom    estado, eventos tipados, reconexión, equipos, bloqueo, anti-AFK
        └── BonkTransport   Socket.IO v2 (EIO=3) + TLS
              └── bonk.io

Próximos pasos

• Instalación y primer bot: ejecuta tu primer bot en minutos.
• Crear y entrar en salas: todas las opciones.
• Estado y eventos: reacciona a lo que ocurre en la sala.