bonktools

Pour commencer

Introduction

Ce qu'est bonktools, quand l'utiliser et comment il est organisé.

bonktools est une bibliothèque TypeScript qui se connecte à bonk.io directement via le protocole du jeu (Socket.IO), sans ouvrir de navigateur. Avec elle, vous créez des salons, contrôlez les équipes et les joueurs, réagissez aux événements et gardez un salon actif 24 heures sur 24.

Pourquoi elle existe

Automatiser bonk.io avec Puppeteer exige un navigateur complet par salon, un écran virtuel sous Linux et une automatisation fragile de l'interface. bonktools remplace tout cela par une connexion légère : chaque salon n'est qu'un socket, et tout le comportement (événements, équipes, reconnexion) est du code TypeScript typé.

Ce que vous pouvez faire

  • Créer des salons et les rejoindre comme hôte, joueur ou spectateur.
  • Réagir aux événements de joueurs, de chat, d'équipes et de parties.
  • Déplacer des joueurs entre les équipes, verrouiller les équipes et modérer (kick/ban).
  • Détecter les joueurs AFK par le mouvement et par le chat.
  • Démarrer et arrêter des parties, avec l'état initial correct pour chaque carte.
  • Garder plusieurs salons actifs avec un seul compte, avec reconnexion automatique.

Comment le projet est organisé

ÉlémentCe que c'est
bonktools (npm)La bibliothèque. Trois couches : BonkTransport, BonkRoom et BonkSession.
Salon 24h/24 (apps/bonk-room)Un bot de football de référence construit uniquement avec la bibliothèque. Voir Salon 24h/24 de référence.
ProtocoleToute la rétro-ingénierie est documentée dans Le protocole de bonk.io.
text
BonkSession       pool de salons, authentification partagée, throttle
  └── BonkRoom    état, événements typés, reconnexion, équipes, verrou, anti-AFK
        └── BonkTransport   Socket.IO v2 (EIO=3) + TLS
              └── bonk.io

Prochaines étapes