Pour commencer

Introduction

BonkTools est désormais un projet ouvert : tout ce que nous utilisions dans nos salons, expliqué pour que vous créiez le vôtre.

BonkTools a fait tourner des salons de football 24 heures sur 24 sur bonk.io : salon de pick avec capitaines, score automatique, replays sur le site, intégration Discord et salons contre une intelligence artificielle que nous avons entraînée nous-mêmes.

Aujourd'hui le projet change de cap. Au lieu de maintenir nos salons, nous ouvrons ce que nous avons appris pour que chacun crée le sien : la bibliothèque, un salon d'exemple complet, les modèles d'IA prêts à télécharger et le pas à pas pour entraîner votre propre IA.

Ce que vous trouverez ici

La documentation a deux onglets (en haut de la barre latérale) :

OngletPour quoi faire
SalonsInstaller la bibliothèque et monter votre salon : structure du projet, système de pick, commandes et admins, enregistrement des matchs, Discord et le garder en ligne 24h/24. Plus la référence complète de la bibliothèque.
Intelligence artificielleComment fonctionne notre IA, télécharger les modèles, mettre l'IA dans votre salon et entraîner votre propre IA de zéro.

Par où commencer

  1. Jamais programmé de bot bonk ? Commencez par Installation et premier bot : en 5 minutes vous avez un salon qui répond à !ping.
  2. Vous voulez un salon complet ? Allez directement à Votre salon, pas à pas. Il y a un projet prêt à télécharger, et chaque page suivante en explique une partie.
  3. Vous voulez une IA qui joue ? Téléchargez un modèle prêt et suivez Mettre l'IA dans votre salon.

Comment les pièces s'emboîtent

text
votre salon (votre code : pick, commandes, rec, Discord, IA...)
  └── bonktools (bibliothèque, npm)
        BonkSession     plusieurs salons, reconnexion, un seul compte
          └── BonkRoom  état, événements, équipes, verrou, anti-AFK
                └── BonkTransport   connexion au serveur de bonk.io
        ScoreTracker / PhysicsSimulator   la VRAIE physique du jeu, sans navigateur

La bibliothèque parle à bonk.io directement via le protocole du jeu, sans ouvrir de navigateur : chaque salon n'est qu'une connexion légère. Le ScoreTracker exécute la physique du jeu lui-même pour connaître le score, et c'est la même physique que nous utilisons pour entraîner l'IA.

Ce qu'il faut savoir avant

  • Bases de TypeScript/JavaScript. Les exemples sont en TypeScript et tournent sur Node.js 20 ou plus récent.
  • Bases de Python, seulement si vous entraînez votre propre IA.
  • Un compte bonk.io est recommandé pour les salons qui restent en ligne (en invité ça marche aussi, avec des limites).