# 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](datenformat.md#f10--almanach). ## 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 Nationalteams mit nominiertem Kader ([Nationalteams](nationalteams.md)); Teams ohne Spieler haben keine | | 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 Tor-/Fehlschusspaare mit Minute 121 aus dem vollständigen Matchprotokoll. Show-Ereignisse sind nur ein Ersatz bei fehlendem Schussprotokoll; sichtbare und unbeobachtete Partien erhalten dieselbe Serie, ohne Doppelerfassung. - 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-`. 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-`, Vereine `team:`. ## 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-.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](../new_ui/desktop/almanac/README.md) liegt mit Pseudodaten vor. Der [Lesevertrag](../new_ui/desktop/almanac/DATA_CONTRACT.md) 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 - Nationalteams spielen seit M9 mit Kader, wenn der Datensatz genug Spieler ihrer Nationalität hat ([Nationalteams](nationalteams.md)); die übrigen Nationen, die Amateure und die Pokal-Ausländer spielen weiter ohne Spieler. - 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 %. ## Korrektur der Elfmeterschießen · 28. Oktober 2026 · #18 Der Recorder trennte bisher die mit Minute 121 protokollierten Elfmeterschüsse nicht von normalen Toren/Fehlschüssen. Zusätzlich wurden dieselben Schüsse aus den Show-Ereignissen aufgenommen. Dadurch enthielt der Spielstand normale Tore inklusive Elfmetertreffern, während der abgeleitete Elfmeterstand 0:0 blieb. Die Aufzeichnung erfasst jetzt jeden protokollierten Elfmeter genau einmal und zählt normale Tore sowie Elfmetertreffer getrennt. Die tatsächliche Schussserie bleibt auch dann vollständig, wenn `CupTie2` seine gepackte Ergebnisanzeige begrenzt. Die Berechnung der Partie, ihr gepacktes Ergebnis und beide RNGs werden dabei nicht geändert. Für ältere betroffene Archive normalisiert die gemeinsame Leseprojektion nur **Kopien**: Beide vollständigen Schussfolgen müssen in Seite, Spieler und Treffer/Miss übereinstimmen, eine abgeschlossene zulässige Serie bilden und mit dem gespeicherten gepackten Endstand einschließlich dessen Begrenzung vereinbar sein. Nur dann werden die doppelten Tor-/Fehlschusseinträge in der Lesekopie entfernt und Spieltore/Elfmetertore getrennt. Rohdaten des geladenen Spielstands und abgeschlossener Saisons bleiben bytegleich. Unvollständige oder widersprüchliche Überlieferungen werden nicht geraten. Auch Torschützen- und andere Archivstatistiken verwenden die normalisierte Lesekopie. Hallenturniere und Hallenmasters gehen nach 40 Minuten direkt ins Elfmeterschießen; die Projektion behauptet dort keine Verlängerung. Bei Feldspielen überschneiden sich protokollierte Minuten 91–93 aus Nachspielzeit und Verlängerung. Enthält eine verlängerte Partie solche Tore oder kein vollständiges Torprotokoll, bleiben die Teilstände für reguläre Zeit/Verlängerung unbekannt (`null`); der gespeicherte Endstand und eine belegte Schussserie bleiben verfügbar. Es gibt keine OBW-/Editor-Formatänderung und keinen neuen F10-Binärstand. Die Versionsrundreisen bleiben unverändert. Die synthetische Prüfung deckt sichtbare und unbeobachtete Schussserien, Doppelerfassung, Ergebnisbegrenzung, alte laufende/abgeschlossene Saisons, Statistik, Hallenspiele und unklare Teilstände ab. Private Vergleichsläufe und GUI-Nachweise liegen unter `bmh_4k_ui/docs/qa/almanac-shootout-2026-10-28/`.