Files
Dreierpack-Manager/docs/new_engine/almanach.md
T
ClaudeandClaude Opus 5.5 0f36b507d4 Modern: national teams play with squads of their nationality (M9)
A Modern layout gives every national team after no_team 24 squad slots.
On each national team day, after the German nomination, the strongest fit
players of each nationality (quotas 3/5/7/5, the German strength measure)
fill its squad and get a computer line-up; a nation without a goalkeeper
or with fewer than 14 nominees keeps its drawn rating. The shared match
core asks fields_players() instead of 'league club or no_team', which is
the same set in Classic. National squads get no cards or injuries, their
players develop after the match like Germany's, and the almanac records
their line-ups.

Diamond data 1.5: 24 of 61 nations play with players. Classic regression
(game 1 and two-player) unchanged, Classic-data season identical, save
round trip identical, ctest passes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 15:02:50 +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 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 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

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