111 lines
9.3 KiB
Markdown
111 lines
9.3 KiB
Markdown
# 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-<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](../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/`.
|