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):

AbaPara quê
SalasInstalar 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 ArtificialComo 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

  1. Nunca programou um bot de bonk? Comece pela Instalação e primeiro bot: em 5 minutos você tem uma sala respondendo !ping.
  2. 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.
  3. Quer uma IA jogando? Descarregue o modelo pronto e siga Colocar a IA na sua sala.

Como as peças se encaixam

text
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 navegador

A 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).