Files
Dreierpack-Manager/docs/new_engine/almanach.md
T
ClaudeandClaude Opus 5.5 d419943e86 Almanac format 3: matches column by column, line-ups against the previous one
Each match field of a season is stored as its own column and every player
of a line-up as his slot in the club's previous line-up. Deflate then
finds the repeats: a half season shrinks from 294 to 218 KB in the save.
Versions 1 and 2 are still read; tests cover a hand-built version 2 season
and a reordered line-up with a new player.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 12:48:00 +01:00

6.9 KiB
Raw Blame History

Fußball-Almanach

Michaels Wunsch: Die Modern-Engine hebt jedes je gespielte Spiel auf, damit das Spiel einen „Fußball-Almanach“ mit starken Statistiken bekommt (ewige Torjäger, direkte Vergleiche, Rekorde, Serien, Zuschauer, Schiedsrichter …). Nur Modern; Classic bleibt unverändert.

Code: src/modern/game/almanac.hpp/.cpp. Datenformat: F10.

Was aufgezeichnet wird

Pro Spiel (AlmanacMatch):

Feld Inhalt
Saison season (gespielte Saisons), start_year (Kalenderjahr des Saisonbeginns) im Saisonkopf
Datum Tageszähler des Kalenders; almanac_date(zähler, display_start_year) liefert Tag/Monat/Jahr wie der Schreibtisch
Spieltyp type: 0 Liga, sonst Pokal-ID + 1 (DFB-Pokal, Europapokale, Länderspiele, Freundschaftsspiele, Hallenturnier, Relegation …)
Wettbewerb league (Ligaindex, im Saisonkopf mit Welt-ID und Namen) bzw. stage (Pokalstufe = Eintrag der Pokaltabelle)
Spieltag round: Liga-Spieltag ab 1 bzw. Runde innerhalb der Pokalstufe ab 1
Vereine Heim/Gast als stabile Welt-IDs (Vereinstabelle der Saison)
Menschliche Manager je Seite der Manager (Index und Name) oder −1 für Computer; Grundlage für spätere Vereinswechsel
Ergebnis Tore nach regulärer Zeit bzw. Verlängerung, Elfmeterschießen getrennt, decided (0 regulär, 1 Verlängerung, 2 Elfmeter)
Schiedsrichter, Zuschauer, Wetter Name (Tabelle der Saison), Zuschauerzahl, Temperatur in °C, Regen 0–7
Aufstellungen je Seite die 11 Startspieler, dann die Bank: Ligavereine und die deutsche Nationalmannschaft, solange der Mensch an Länderspieltagen Bundestrainer ist (sonst spielt sie wie die anderen Länder- und Amateurteams ohne Spieler)
Ereignisse Minute, Seite, Spieler und ggf. zweiter Spieler: Tor (mit Vorlage und Art: Spiel, Elfmeter/Freistoß, Nachschuss, Ecke), Fehlschuss, Gelb, Gelb-Rot, Rot, Verletzung, Wechsel (ein/aus), Elfmeter im Elfmeterschießen

Pro Saison zusätzlich:

Feld Inhalt
Abschlusstabellen (tables) alle Ligen in Platzierungsreihenfolge: Platz, Verein, Spiele, S/U/N, Tore, Gegentore, Punkte (nach einem Punktabzug). Aufgenommen zu Beginn des Saisonwechsels, bevor Auf- und Abstieg die Vereine verschieben
Sieger (winners) in der Reihenfolge, in der sie feststehen: Meister jeder Liga (mit Vizemeister) und jeder entschiedene Pokalwettbewerb (DFB-Pokal, Europapokale, Supercup, Relegation, Länderturniere, jedes Hallenturnier und das Masters) mit Datum, letzter Stufe und Finalgegner bzw. Gruppenzweitem. Nicht: die Behälter für Wiederholungsspiele und Freundschaftsspiele (Pokal-ID 9 und 10)

Woher die Daten kommen (keine Wirkung auf das Spiel)

  • Tore, Fehlschüsse, Karten, Verletzungen: das Ereignisprotokoll der Spielgruppe (MatchGroup::log), das die Engine wie das Original für jedes Spiel führt.
  • Elfmeterschießen: die Show-Ereignisse der Match-Engine (das Protokoll hat keine Elfmeter); Modern sammelt sie jetzt immer.
  • Wechsel: Vergleich der Spieler auf dem Platz nach jeder Minute. Damit werden auch Wechsel des menschlichen Managers (Bildschirm, Halbzeit) erfasst.
  • Aufstellung, Schiedsrichter, Wetter, Spieltag: beim Anpfiff; Ergebnis und Zuschauer nach dem Spieltag.
  • Der Almanach zieht keine Zufallszahlen und ändert nichts, was die Saisonlogik liest. Geprüft: Ein Modern-Lauf über 60 Züge ist mit und ohne Almanach identisch.

Identitäten

  • Vereine tauschen beim Auf- und Abstieg ihre Laufzeitnummer; der Almanach speichert deshalb die Welt-ID (world_club_id).
  • Spieler: Die Engine verwendet den Platz eines Spielers für eine neue Person wieder (Karriereende/Abgang in den Pool mit neuen Werten, Jugendspieler). Dort vergibt new_player_identity eine neue ID player:gen-<n>. Der Zähler wird mitgespeichert. Wie im Original behält die neue Person den Namen des Platzes; die ID trennt die Karrieren.
  • Spieler ohne Welt-ID (Classic-Daten) heißen player:legacy-<index>, Vereine team:<index>.

Speicherung

  • Jede Saison hat ihre eigenen Tabellen (Ligen, Vereine, Spieler, Manager, Schiedsrichter) und ist damit für sich lesbar.
  • Abgeschlossene Saisons liegen im Spielstand als history/season-<Jahr>.bin und werden nie wieder geschrieben; die laufende als history/current.bin. Beide stehen in state/integrity.json.
  • Binärformat Version 3 (Little Endian): OBAL, u16 Version, Saisonkopf, Tabellen (Ligen, Vereine, Spieler, Manager, Schiedsrichter), Spiele, Abschlusstabellen, Sieger. Die Spiele stehen spaltenweise (jedes Feld aller Spiele als eigener Block, Daten als Abstände, Spielerverweise in Low- und High-Bytes); eine Aufstellung nennt jeden Spieler über seinen Platz in der vorigen Aufstellung desselben Vereins. Versionen 1 (ohne Abschlusstabellen und Sieger) und 2 (eine Zeile je Spiel) werden weiter gelesen; abgeschlossene Saisons bleiben in der Version, in der sie geschrieben wurden. Text: u16 Länge + UTF-8. Einzelheiten in encode_almanac_season.
  • Größe: etwa 0,5 MB pro Saison im (komprimierten) Spielstand, mit allen Ereignissen und Aufstellungen. Ein Spielstand nach einer Saison ist ~700 KB statt ~210 KB.

Für die UI (Codex)

Der native und HTML-Almanachprototyp liegt mit Pseudodaten vor. Der Lesevertrag beschreibt die Abfragen index, calendar, day und match für eine spätere konstante Modern-Sessionprojektion. Dort sind auch die F10-Grenzen festgehalten: Teilstände nur bei vollständigem Nachweis ableiten, die ET-Teilnahme beim Elfmeterschießen nicht raten, historische Tabellen verwenden und fehlende Kader beziehungsweise Einzelangaben neutral ausgeben. Die UI liest derzeit keine F10-/OBS-Dateien und ändert keine Engine- oder Spielstanddaten.

  • ModernState::almanac: finished (Dateiname + Bytes je Saison, mit decode_almanac_season lesen) und current (laufende Saison).
  • Auswertungen (Torjäger aller Zeiten, Bilanzen, Rekorde) baut die Engine als Projektionen, sobald die Almanach-Oberfläche feststeht. Bis dahin kann die UI direkt auf den Saisons rechnen. modern_season_sim zeigt am Laufende ein Beispiel (print_almanac: Prüfung Tore gegen Ergebnis, Top-Torschützen über alle Saisons).
  • Namen sind UTF-8; Wettbewerbsnamen für Pokale kommen wie im Ergebnisbildschirm aus den Texten (type - 1 = Pokal-ID).

Offen

  • Kader für die übrigen Länder- und Amateurteams (die Engine lässt sie ohne Spieler antreten), damit auch deren Aufstellungen und Torschützen aufgezeichnet werden.
  • Behoben (25.10.2026): Die Spiele der deutschen Nationalmannschaft fehlten ganz, weil ihre Team-Nummer (357) zugleich „kein Team“ ist und als Platzhalter aussortiert wurde.
  • Projektionen für die Almanach-Oberfläche.
  • Kompression: Version 3 spart gegenüber Version 2 rund ein Viertel (eine halbe Saison: Almanach 294 → 218 KB, Spielstand 501 → 432 KB). Den Rest belegen vor allem die Ereignisse; eine stärkere ZIP-Stufe brächte nur etwa 10 %.