Bibliothèque
Score et vainqueur (football)
ScoreTracker trouve les points et le vainqueur des parties de football sans navigateur, et génère l'état initial avec le code même du jeu.
bonk.io n'indique ni le score ni le vainqueur à l'hôte, par aucun paquet : GAME_END arrive sans données et les clients reviennent seuls au lobby à la fin de la partie. ScoreTracker règle cela sans navigateur et sans occuper de place dans le salon.
Comment ça marche
Le jeu est déterministe : tous les clients simulent la même partie à partir du même état initial et des mêmes inputs. ScoreTracker :
- télécharge depuis bonk.io (à la première exécution) les fichiers de physique du client lui-même et les garde dans
cacheDir. Ils ne font pas partie du paquet ; - exécute la physique du football dans un worker, isolé du reste de votre processus ;
- alimente la simulation avec l'état initial de la partie (
GAME_START) et les inputs des joueurs (paquet7, avec la frame de chaque touche) ; - émet un événement à chaque point et quand une équipe atteint la limite.
Le résultat est identique à celui des clients : lors de tests avec de vraies parties, positions et score concordaient frame par frame.
Utilisation
import { ScoreTracker } from 'bonktools';
const score = new ScoreTracker(room, { cacheDir: '.cache/bonk-client' });
score.on('score', ({ team, scores }) => {
room.chat(`point pour l'équipe ${team} ! score : bleu ${scores[3]} x ${scores[2]} rouge`);
});
score.on('match-winner', ({ team }) => {
console.log("l'équipe", team, 'a gagné'); // 2 rouge · 3 bleu
});
score.on('error', (e) => console.error('suivi désactivé :', e));
await score.start();| Événement | Payload | Quand |
|---|---|---|
ready | — | Le simulateur est chargé |
score | { team, scores, frame } | Une équipe a marqué (scores est indexé par id d'équipe) |
match-winner | { team, scores, frame } | Une équipe a atteint maxScore (une fois par partie) |
error | Error | Échec du chargement ou de la simulation ; le suivi s'arrête |
| Option | Par défaut | Description |
|---|---|---|
cacheDir | <tmp>/bonktools-client | Où garder les fichiers du client téléchargés |
maxScore | le gs.wl de la partie | Points pour gagner (les « rounds » du salon) |
clientBaseUrl | https://bonk.io/js/ | D'où viennent les fichiers du client |
tickMs / lagFrames | 100 / 6 | Pas de la simulation et retard (200 ms) pour laisser arriver les inputs |
score.tracking indique si la partie en cours est suivie. Servez-vous-en pour garder un plan B (par exemple demander le vainqueur dans le chat) quand le suivi n'est pas actif.
Générer l'état initial avec le jeu lui-même
buildInitialState(players) génère l'IS blob d'une partie de football avec le code du jeu (createNewState). Il ne dépend pas de blobs capturés et convient à n'importe quel nombre de joueurs et n'importe quel id :
const is = await score.buildInitialState([
null, // indice 0 : le bot
{ id: 1, team: 3 }, // bleu
{ id: 2, team: 2 }, // rouge
]);
room.startGame(is ? { is } : undefined);players est un tableau indexé par l'id du joueur ; seules les équipes 2 (rouge) et 3 (bleu) reçoivent un disque. Il renvoie null si le simulateur n'est pas prêt : dans ce cas, utilisez un blob capturé (voir Parties, IS blob et spectateurs).
Limites
- Football uniquement. Les autres modes sont ignorés.
- Le vainqueur est une équipe, pas un joueur : le jeu n'indique pas qui a touché le ballon en dernier.
- Mémoire. Le worker charge tout le client (quelques centaines de Mo au pire). Sur de très petites VM, évaluez avant de l'activer.
- Réseau. Le paquet des inputs doit parvenir à l'hôte ; les inputs tardifs font revenir la simulation à un checkpoint et refaire les frames.