Bibliothek
Punkte und Sieger (Fußball)
ScoreTracker ermittelt Punkte und Sieger von Fußball-Partien ohne Browser und erzeugt den Anfangszustand mit dem Code des Spiels selbst.
bonk.io teilt dem Host weder Punktestand noch Sieger über irgendein Paket mit: GAME_END kommt ohne Daten an und die Clients kehren am Ende der Partie von allein in die Lobby zurück. ScoreTracker löst das ohne Browser und ohne einen Platz im Raum zu belegen.
So funktioniert es
Das Spiel ist deterministisch: Alle Clients simulieren dieselbe Partie aus demselben Anfangszustand und denselben Inputs. ScoreTracker:
- lädt (beim ersten Start) die Physikdateien des Clients von bonk.io herunter und legt sie in
cacheDirab. Sie sind nicht Teil des Pakets; - führt die Fußball-Physik in einem Worker aus, getrennt vom Rest deines Prozesses;
- füttert die Simulation mit dem Anfangszustand der Partie (
GAME_START) und den Inputs der Spieler (Paket7, mit dem Frame jeder Taste); - sendet bei jedem Punkt ein Event und wenn ein Team das Limit erreicht.
Das Ergebnis ist identisch mit dem der Clients: In Tests mit echten Partien stimmten Positionen und Punktestand Frame für Frame überein.
Verwendung
import { ScoreTracker } from 'bonktools';
const score = new ScoreTracker(room, { cacheDir: '.cache/bonk-client' });
score.on('score', ({ team, scores }) => {
room.chat(`Punkt für Team ${team}! Stand: Blau ${scores[3]} x ${scores[2]} Rot`);
});
score.on('match-winner', ({ team }) => {
console.log('Team', team, 'hat gewonnen'); // 2 Rot · 3 Blau
});
score.on('error', (e) => console.error('Tracking deaktiviert:', e));
await score.start();| Event | Payload | Wann |
|---|---|---|
ready | — | Der Simulator ist geladen |
score | { team, scores, frame } | Ein Team hat gepunktet (scores ist nach Team-ID indiziert) |
match-winner | { team, scores, frame } | Ein Team hat maxScore erreicht (einmal pro Partie) |
error | Error | Laden oder Simulation fehlgeschlagen; das Tracking stoppt |
| Option | Standard | Beschreibung |
|---|---|---|
cacheDir | <tmp>/bonktools-client | Wo die heruntergeladenen Client-Dateien liegen |
maxScore | gs.wl der Partie | Punkte zum Sieg (die „Runden“ des Raums) |
clientBaseUrl | https://bonk.io/js/ | Woher die Client-Dateien kommen |
tickMs / lagFrames | 100 / 6 | Simulationsschritt und Verzögerung (200 ms), damit Inputs ankommen |
score.tracking zeigt, ob die aktuelle Partie verfolgt wird. Nutze es, um einen Plan B zu behalten (etwa den Sieger im Chat abzufragen), wenn das Tracking nicht aktiv ist.
Den Anfangszustand mit dem Spiel selbst erzeugen
buildInitialState(players) erzeugt den IS-Blob einer Fußball-Partie mit dem Code des Spiels (createNewState). Er hängt nicht von aufgezeichneten Blobs ab und funktioniert für beliebig viele Spieler und jede ID:
const is = await score.buildInitialState([
null, // Index 0: der Bot
{ id: 1, team: 3 }, // Blau
{ id: 2, team: 2 }, // Rot
]);
room.startGame(is ? { is } : undefined);players ist ein nach Spieler-ID indiziertes Array; nur die Teams 2 (Rot) und 3 (Blau) bekommen eine Scheibe. Gibt null zurück, wenn der Simulator nicht bereit ist: Nimm dann einen aufgezeichneten Blob (siehe Partien, IS-Blob und Zuschauer).
Einschränkungen
- Nur Fußball. Andere Modi werden ignoriert.
- Der Sieger ist ein Team, kein Spieler: Das Spiel sagt nicht, wer den Ball zuletzt berührt hat.
- Speicher. Der Worker lädt den gesamten Client (im schlimmsten Fall einige hundert MB). Prüfe das auf sehr kleinen VMs vor dem Einschalten.
- Netzwerk. Das Paket mit den Inputs muss den Host erreichen; späte Inputs lassen die Simulation zu einem Checkpoint zurückgehen und die Frames neu berechnen.