9.3 KiB
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 Nationalteams mit nominiertem Kader (Nationalteams); 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_identityeine neue IDplayer: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>, Vereineteam:<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>.binund werden nie wieder geschrieben; die laufende alshistory/current.bin. Beide stehen instate/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 inencode_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, mitdecode_almanac_seasonlesen) undcurrent(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_simzeigt 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); 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/.