Começando
Introdução
A BonkTools agora é um projeto aberto: tudo o que usamos nas nossas salas, ensinado para você criar a sua.
A BonkTools manteve salas de football 24 horas por dia no bonk.io: sala de pick com capitães, marcador automático, replays no site, integração com o Discord e salas contra uma inteligência artificial treinada por nós.
Agora o projeto mudou de foco. Em vez de manter as nossas salas, abrimos o que aprendemos para que qualquer pessoa crie a sua: a biblioteca, uma sala de exemplo completa, o modelo da IA pronto para descarregar e o passo a passo para treinar a sua própria IA.
O que você encontra aqui
A documentação tem duas abas (no topo da barra lateral):
| Aba | Para quê |
|---|---|
| Salas | Instalar a biblioteca e montar a sua sala: estrutura do projeto, sistema de pick, comandos e admins, gravação de partidas, Discord e como deixar no ar 24/7. Mais a referência completa da biblioteca. |
| Inteligência Artificial | Como a nossa IA funciona, descarregar o modelo, colocar a IA na sua sala e treinar a sua própria IA do zero. |
Por onde começar
- Nunca programou um bot de bonk? Comece pela Instalação e primeiro bot: em 5 minutos você tem uma sala respondendo
!ping. - Quer uma sala completa? Vá direto para Sua sala, passo a passo. Ela tem um projeto pronto para descarregar, e cada página seguinte explica uma parte dele.
- Quer uma IA jogando? Descarregue o modelo pronto e siga Colocar a IA na sua sala.
Como as peças se encaixam
sua sala (o seu código: pick, comandos, rec, Discord, IA...)
└── bonktools (biblioteca, npm)
BonkSession várias salas, reconexão, uma conta só
└── BonkRoom estado, eventos, times, lock, anti-AFK
└── BonkTransport conexão com o servidor do bonk.io
ScoreTracker / PhysicsSimulator a física REAL do jogo, sem navegadorA biblioteca conversa com o bonk.io direto pelo protocolo do jogo, sem abrir um navegador: cada sala é só uma conexão leve. O ScoreTracker roda a física do próprio jogo para saber o marcador, e é a mesma física que usamos para treinar a IA.
O que você precisa saber antes
- TypeScript/JavaScript básico. Os exemplos são em TypeScript e rodam com Node.js 20 ou mais novo.
- Python básico, só se for treinar a sua própria IA.
- Uma conta do bonk.io é recomendada para salas que ficam no ar (como convidado também funciona, com limitações).