Primeros pasos
Introducción
BonkTools ahora es un proyecto abierto: todo lo que usamos en nuestras salas, explicado para que crees la tuya.
BonkTools mantuvo salas de fútbol 24 horas al día en bonk.io: sala de pick con capitanes, marcador automático, replays en el sitio, integración con Discord y salas contra una inteligencia artificial entrenada por nosotros.
Ahora el proyecto cambió de enfoque. En lugar de mantener nuestras salas, abrimos lo que aprendimos para que cualquiera cree la suya: la biblioteca, una sala de ejemplo completa, el modelo de la IA listo para descargar y el paso a paso para entrenar tu propia IA.
Qué encontrarás aquí
La documentación tiene dos pestañas (arriba de la barra lateral):
| Pestaña | Para qué |
|---|---|
| Salas | Instalar la biblioteca y montar tu sala: estructura del proyecto, sistema de pick, comandos y admins, grabación de partidas, Discord y cómo mantenerla en línea 24/7. Más la referencia completa de la biblioteca. |
| Inteligencia Artificial | Cómo funciona nuestra IA, descargar el modelo, poner la IA en tu sala y entrenar tu propia IA desde cero. |
Por dónde empezar
- ¿Nunca programaste un bot de bonk? Empieza por Instalación y primer bot: en 5 minutos tienes una sala respondiendo
!ping. - ¿Quieres una sala completa? Ve directo a Tu sala, paso a paso. Tiene un proyecto listo para descargar, y cada página siguiente explica una parte.
- ¿Quieres una IA jugando? Descarga el modelo listo y sigue Poner la IA en tu sala.
Cómo encajan las piezas
tu sala (tu código: pick, comandos, rec, Discord, IA...)
└── bonktools (biblioteca, npm)
BonkSession varias salas, reconexión, una sola cuenta
└── BonkRoom estado, eventos, equipos, lock, anti-AFK
└── BonkTransport conexión con el servidor de bonk.io
ScoreTracker / PhysicsSimulator la física REAL del juego, sin navegadorLa biblioteca habla con bonk.io directamente por el protocolo del juego, sin abrir un navegador: cada sala es solo una conexión ligera. El ScoreTracker ejecuta la física del propio juego para saber el marcador, y es la misma física que usamos para entrenar la IA.
Qué necesitas saber antes
- TypeScript/JavaScript básico. Los ejemplos están en TypeScript y corren con Node.js 20 o más reciente.
- Python básico, solo si vas a entrenar tu propia IA.
- Una cuenta de bonk.io es recomendable para salas que quedan en línea (como invitado también funciona, con limitaciones).