Files
Dreierpack-Manager/docs/new_engine/almanach.md
T

9.3 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 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_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

  • 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/.