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:
- baixa da bonk.io (na primeira execução) os arquivos de física do próprio cliente e os guarda em
cacheDir. Eles não fazem parte do pacote; - roda a física do football num worker, isolado do resto do seu processo;
- alimenta a simulação com o estado inicial da partida (
GAME_START) e com os inputs dos jogadores (pacote7, com o frame de cada tecla); - emite um evento a cada ponto e quando um time chega ao limite.
O resultado é idêntico ao dos clientes: em testes com partidas reais, posições e placar bateram frame a frame.
Uso
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();| Evento | Payload | Quando |
|---|---|---|
ready | — | O simulador carregou |
score | { team, scores, frame } | Um time fez ponto (scores é indexado pelo id do time) |
match-winner | { team, scores, frame } | Um time chegou a maxScore (uma vez por partida) |
error | Error | Falha ao carregar ou simular; o rastreamento para |
| Opção | Padrão | Descrição |
|---|---|---|
cacheDir | <tmp>/bonktools-client | Onde guardar os arquivos do cliente baixados |
maxScore | gs.wl da partida | Pontos para vencer (os "rounds" da sala) |
clientBaseUrl | https://bonk.io/js/ | Origem dos arquivos do cliente |
tickMs / lagFrames | 100 / 6 | Passo 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:
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ó os times 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 time, 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.