Biblioteca

Placar e vencedor (football)

ScoreTracker descobre pontos e vencedor de partidas de football sem navegador, e gera o estado inicial pelo próprio jogo.

O bonk.io não informa placar nem vencedor ao host por nenhum pacote: o GAME_END chega sem dados e os clientes voltam ao lobby sozinhos ao fim da partida. O ScoreTracker resolve isso sem navegador e sem ocupar uma vaga na sala.

Como funciona

O jogo é determinístico: todos os clientes simulam a mesma partida a partir do mesmo estado inicial e dos mesmos inputs. O ScoreTracker:

  1. baixa da bonk.io (na primeira execução) os ficheiros de física do próprio cliente e os guarda em cacheDir. Eles não fazem parte do pacote;
  2. roda a física do football num worker, isolado do resto do seu processo;
  3. alimenta a simulação com o estado inicial da partida (GAME_START) e com os inputs dos jogadores (pacote 7, com o frame de cada tecla);
  4. emite um evento a cada ponto e quando uma equipa chega ao limite.

O resultado é idêntico ao dos clientes: em testes com partidas reais, posições e placar bateram frame a frame.

Uso

ts
import { ScoreTracker } from 'bonktools';

const score = new ScoreTracker(room, { cacheDir: '.cache/bonk-client' });

score.on('score', ({ team, scores }) => {
  room.chat(`ponto do time ${team}! placar: azul ${scores[3]} x ${scores[2]} vermelho`);
});
score.on('match-winner', ({ team }) => {
  console.log('venceu o time', team); // 2 vermelho · 3 azul
});
score.on('error', (e) => console.error('rastreamento desativado:', e));

await score.start();
EventoPayloadQuando
ready—O simulador carregou
score{ team, scores, frame }Uma equipa fez ponto (scores é indexado pelo id da equipa)
match-winner{ team, scores, frame }Uma equipa chegou a maxScore (uma vez por partida)
errorErrorFalha ao carregar ou simular; o rastreamento para
OpçãoPadrãoDescrição
cacheDir<tmp>/bonktools-clientOnde guardar os ficheiros do cliente baixados
maxScoregs.wl da partidaPontos para vencer (os "rounds" da sala)
clientBaseUrlhttps://bonk.io/js/Origem dos ficheiros do cliente
tickMs / lagFrames100 / 6Passo da simulação e atraso (200 ms) para os inputs chegarem

score.tracking diz se a partida atual está sendo acompanhada. Use-o para manter um plano B (por exemplo, pedir o vencedor no chat) quando o rastreamento não estiver ativo.

Gerar o estado inicial pelo próprio jogo

buildInitialState(players) gera o IS blob de uma partida de football com o código do jogo (createNewState). Não depende de blobs capturados e vale para qualquer quantidade de jogadores e qualquer id:

ts
const is = await score.buildInitialState([
  null,                      // índice 0: o bot
  { id: 1, team: 3 },        // azul
  { id: 2, team: 2 },        // vermelho
]);
room.startGame(is ? { is } : undefined);

players é um array indexado pelo id do jogador; só as equipas 2 (vermelho) e 3 (azul) ganham disco. Devolve null se o simulador não está pronto: nesse caso use um blob capturado (veja Partidas e IS blob).

Limitações

  • Só football. Outros modos são ignorados.
  • O vencedor sai por equipa, não por jogador: o jogo não informa quem tocou na bola por último.
  • Memória. O worker carrega o cliente inteiro (algumas centenas de MB no pior caso). Em VMs muito pequenas, avalie antes de ligar.
  • Rede. O pacote com os inputs precisa chegar ao host; inputs atrasados fazem a simulação voltar a um checkpoint e refazer os frames.