Biblioteca

Puntuación y ganador (fútbol)

ScoreTracker averigua los puntos y el ganador de las partidas de fútbol sin navegador, y genera el estado inicial con el propio código del juego.

bonk.io no informa de la puntuación ni del ganador al host mediante ningún paquete: GAME_END llega sin datos y los clientes vuelven solos al lobby al terminar la partida. ScoreTracker lo resuelve sin navegador y sin ocupar un hueco en la sala.

Cómo funciona

El juego es determinista: todos los clientes simulan la misma partida a partir del mismo estado inicial y de los mismos inputs. ScoreTracker:

  1. descarga de bonk.io (la primera vez) los archivos de física del propio cliente y los guarda en cacheDir. No forman parte del paquete;
  2. ejecuta la física del fútbol en un worker, aislado del resto de tu proceso;
  3. alimenta la simulación con el estado inicial de la partida (GAME_START) y con los inputs de los jugadores (paquete 7, con el frame de cada tecla);
  4. emite un evento por cada punto y cuando un equipo alcanza el límite.

El resultado es idéntico al de los clientes: en pruebas con partidas reales, posiciones y marcador coincidieron 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(`¡punto del equipo ${team}! marcador: azul ${scores[3]} x ${scores[2]} rojo`);
});
score.on('match-winner', ({ team }) => {
  console.log('ganó el equipo', team); // 2 rojo · 3 azul
});
score.on('error', (e) => console.error('seguimiento desactivado:', e));

await score.start();
EventoPayloadCuándo
ready—El simulador se cargó
score{ team, scores, frame }Un equipo marcó (scores se indexa por id de equipo)
match-winner{ team, scores, frame }Un equipo llegó a maxScore (una vez por partida)
errorErrorFalló la carga o la simulación; el seguimiento se detiene
OpciónPor defectoDescripción
cacheDir<tmp>/bonktools-clientDónde guardar los archivos del cliente descargados
maxScoreel gs.wl de la partidaPuntos para ganar (los "rounds" de la sala)
clientBaseUrlhttps://bonk.io/js/De dónde vienen los archivos del cliente
tickMs / lagFrames100 / 6Paso de la simulación y retraso (200 ms) para que lleguen los inputs

score.tracking indica si la partida actual se está siguiendo. Úsalo para mantener un plan B (por ejemplo, pedir el ganador por chat) cuando el seguimiento no esté activo.

Generar el estado inicial con el propio juego

buildInitialState(players) genera el IS blob de una partida de fútbol con el código del juego (createNewState). No depende de blobs capturados y sirve para cualquier cantidad de jugadores y cualquier id:

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

players es un array indexado por el id del jugador; solo los equipos 2 (rojo) y 3 (azul) reciben disco. Devuelve null si el simulador no está listo: en ese caso usa un blob capturado (consulta Partidas, IS blob y espectadores).

Limitaciones

  • Solo fútbol. Los demás modos se ignoran.
  • El ganador es un equipo, no un jugador: el juego no dice quién tocó la pelota por última vez.
  • Memoria. El worker carga el cliente entero (unos cientos de MB en el peor caso). En VMs muy pequeñas, evalúalo antes de activarlo.
  • Red. El paquete con los inputs debe llegar al host; los inputs tardíos hacen que la simulación vuelva a un checkpoint y rehaga los frames.