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:
- 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; - ejecuta la física del fútbol en un worker, aislado del resto de tu proceso;
- alimenta la simulación con el estado inicial de la partida (
GAME_START) y con los inputs de los jugadores (paquete7, con el frame de cada tecla); - 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
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();| Evento | Payload | Cuá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) |
error | Error | Falló la carga o la simulación; el seguimiento se detiene |
| Opción | Por defecto | Descripción |
|---|---|---|
cacheDir | <tmp>/bonktools-client | Dónde guardar los archivos del cliente descargados |
maxScore | el gs.wl de la partida | Puntos para ganar (los "rounds" de la sala) |
clientBaseUrl | https://bonk.io/js/ | De dónde vienen los archivos del cliente |
tickMs / lagFrames | 100 / 6 | Paso 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:
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.