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) :
| Onglet | Pour quoi faire |
|---|---|
| Salons | Installer 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 artificielle | Comment 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
- Jamais programmé de bot bonk ? Commencez par Installation et premier bot : en 5 minutes vous avez un salon qui répond à
!ping. - 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.
- 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
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 navigateurLa 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).