Files
Dreierpack-Manager/docs/new_engine/phasen.md
T
ClaudeandClaude Opus 5.5 44a7a77915 Accept data revision 1.4: real ages for all players (M5)
Revision 1.4 of the Modern data set brings birth dates for every
player, the camp catalogue with its maps and 100 referees. The
expansion now takes the age from a birth date for the original players
as well (WorldPlayer::born); before, only the added players kept their
data age. The yearly aging stops at 47, the most the age bits hold, so
real ages (a goalkeeper of 40) cannot run into the bits above. The
season sim counts second referee assignments per day.

Two seasons and ten seasons run through; the save round trip is
identical; second referee assignments drop to about 7 a season.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 08:54:21 +01:00

11 KiB
Raw Blame History

Phasen · Modern-Engine 0.3

Jede Phase hält das Spiel lauffähig. Classic-Prüfung nach jeder Phase: ctest -C Release -E repo_hygiene und die Classic-Regression identisch zur Referenz aus M0.

M0 · Grundlage

  • Classic-Referenz festhalten: Regressionsausgaben, Langläufe, Tag auf 0.3.
  • Modern-Datensatz lokal bereitstellen (privat, nicht in dieses Repository).

Abnahme: Referenzen liegen vor; spätere Phasen vergleichen dagegen.

M1 · WorldLayout und Abzweig

  • WorldLayout in src/game/state.hpp: Ligagrößen, ID-Bereiche (Liga, Amateure, Pokal-Ausländer, Nationalteams, kNoTeam), Kaderplätze pro Team, Pool-Offsets, Gesamtzahl der Plätze, Spieler- und Vereinsanzahl. classic_layout() liefert die heutigen Werte; squad_range liest das Layout.
  • Gemeinsame Teile lesen Teambereiche aus dem Layout (match_engine, rating, match).
  • Saisonlogik nach src/modern/game/ kopieren (Bibliothek bmh_season_modern, Namespace bmh::modern); dort alle festen Größen aus dem Befund durch Layoutwerte ersetzen.
  • Vereinsbezogene Speicherblöcke werden in Modern zu Vektoren, die nach der Vereinsanzahl bemessen sind; Classic behält seine Blöcke.

Abnahme: Classic identisch; Modern-Kern baut und läuft mit Classic-Layout identisch zu Classic (Gegenprobe, dass der Abzweig nichts verändert hat).

M2 · Ligen, Spielpläne, Kalender

  • Spielplangenerator je Liga aus den Daten: round-robin (Kreismethode, jede Größe, Heim/Auswärts ausgeglichen) für die internationalen Ligen, legacy:<n> für die deutschen Ligen aus den Classic-Tabellen des Datensatzes.
  • Kalender: Der Tagesplan der Saison wird beim Start aus dem Classic-Plan erzeugt und für die internationalen Ligen auf 38 Runden ergänzt. Ligen mit weniger Runden setzen danach aus. Tabellen, Prognose und Saisonende rechnen je Liga mit 2 × (Vereine − 1) Spieltagen.
  • Europapokal-Teilnehmer aus den internationalen Ligen werden wie bisher bestimmt, mit den neuen Teambereichen.

Abnahme: Synthetische Welt mit Ligen von 20, 20, 20 und 18 Vereinen spielt eine Saison vollständig durch; jede Paarung genau einmal pro Hin- und Rückrunde.

M3 · Modern-Weltlader

  • Ein Paket ist Modern, wenn requires runtime:modern-v1 enthält; der Mod-Ordner darf zusätzlich mod.json mit type: modern tragen (Ansatz aus dem Modern-POC).
  • Ablauf (src/modern/content/world_loader.*): Archiv lesen → Classic-Startzustand aus den Classic-Datenbereichen des Pakets aufbauen → Welttabellen darüberlegen (Vereine, Ligen, Kader und Reihenfolge, Spielerwerte bmh-classic@1, Verträge) → WorldLayout aus den Daten ableiten.
  • Namen: GameState erhält UTF-8-Felder für Vor- und Nachname sowie Vereinsname und Kurzname. Texte der Engine (Post, Meldungen, Ranglisten, Konsole) verwenden in Modern einen gemeinsamen Namenszugriff.
  • Asset-Schlüssel (Wappen, Porträts, Trophäen) werden unverändert an die UI weitergegeben.
  • Gegenseitiger Ausschluss: Modern lehnt Classic-Pakete ab und umgekehrt.

Abnahme: Der Modern-Datensatz startet eine Karriere mit einem deutschen Verein; Kader, Namen und Ligen stimmen mit den Welttabellen überein.

Umsetzung (Stand 24. Oktober 2026):

  • src/modern/content/world.*: typisierte Sicht auf die Welttabellen (Ligen, Vereine, Spieler, Nationen, Ligatermine).
  • src/modern/content/world_package.*: liest aus dem Paket nur, was die Engine braucht (Manifest, Welttabellen, Classic-Nutzdaten, Classic-Grafiken); HD-Wappen und -Porträts bleiben im Archiv. Der Classic-Startzustand entsteht aus den unveränderten x-classic/x-legacy-Daten.
  • src/modern/content/world_expand.*: bringt den Classic-Start auf die Welt. Vereins-IDs folgen den Ligamitgliedern (die vergrößerten internationalen Ligen verschieben alle IDs dahinter um 30); Tabellen pro Verein werden umgerechnet, neue Vereine übernehmen die Startwerte eines Originalvereins derselben Liga; neue Spieler erhalten ihre Werte aus den bmh-classic@1-Attributen; jeder Ligaverein hat 24 Kaderplätze; die Pools hinter den Kadern (Transferliste, vereinslos, Ausland, Nationalteam, 54 Reservespieler) behalten Inhalt und Reihenfolge.
  • Namen und OBW-IDs für die UI liegen in ModernState (world_club_name, player_first, player_last, …); die Engine-Texte nutzen weiter die Einzelbyte-Namenspools, in die neue Namen angehängt werden.
  • Probelauf: modern_season_sim <Welt.obw> [Spielzüge] [Verein] [Startwert]; MODERN_DEBUG=1 zeigt die Ladeschritte, MODERN_WATCH=<Sekunden> meldet regelmäßig den Engine-Schritt (Endlosschleifen finden).
  • Ergebnis mit dem Modern-Datensatz 1.3: zwei Saisons, rund 5.300 Spiele; alle Ligen spielen ihre Runden vollständig (deutsche Ligen 34, LaLiga/Premier League/Serie A 38, Ligue 1 34).
  • Dabei gefunden und behoben: der Schiedsrichterpool (49) reicht nicht für Tage mit deutschen und vergrößerten internationalen Ligen (Modern-Abweichung), die Fairplay-Tabelle pro Ligaverein ist mitgewachsen, Kaderzuordnung über das Layout statt fester 24/16-Arithmetik.
  • Offen für M6: Modern-Spielstände; die Session nutzt übergangsweise die Classic-UI-Projektionen, die dafür auf das Layout umgestellt sind.

M4 · Trainingslager

Siehe Trainingslager: Katalog aus den Daten, drei Regionen, Qualitätswerte 0–6, unveränderte Preisformel und Aufenthaltsgrenzen, begrenzte 6-Sterne-Wirkung.

Abnahme: Tests für Preis, Grenzen und Wirkung mit festen Seeds; Simulation: drei Aufenthalte in 6-Sterne-Lagern bringen einem Spitzenteam im Schnitt höchstens etwa einen Tabellenplatz.

M5 · Datenrevision 1.4 (privat)

  • Neue, nummerierte Migration des Modern-Datensatzes nach dem bestehenden Migrationsvertrag (Eingangs-Hash, Bericht, unabhängige Prüfung, Editor-Roundtrip): runtime:modern-v1, spielbar, Trainingslager-Katalog, Kalenderangaben für 38 Spieltage, Finanzangaben auch für die 30 neuen Vereine, ein größerer Schiedsrichter-Pool (mindestens 100, Datenformat F9) samt Engine-Anbindung.
  • Werkzeug: C++ (openbmh_world_migrate) oder das bestehende Migrationswerkzeug der Datenpflege; vor Beginn abstimmen.

Abnahme: Prüfbericht ohne Fehler; Editor öffnet und speichert verlustfrei.

Abnahme Revision 1.4 (25.10.2026): runtime:modern-v1 im Manifest; 18 Lager auf 3 Karten aus den Daten (resorts), das 6-Sterne-Lager buchbar; 100 Schiedsrichter (50 neue mit Strenge und Wahrnehmung), noch etwa 7 Doppeleinsätze pro Saison statt an fast jedem Ligatag; Geburtsdaten für alle 3.414 Spieler. Zwei Saisons ohne Abbruch, Spielstand-Rundreise identisch, zehn Saisons ohne Abbruch. Engine-Anpassungen dabei: Geburtsdaten gelten jetzt auch für die Originalspieler (WorldPlayer::born); das Alter stoppt bei 47, dem Maximum seines Feldes (ein 40-jähriger Torwart würde sonst nach einigen Jahren überlaufen). Offen für die Daten nur playable: true im Manifest (liest die Engine nicht).

Stand Engine (erledigt): Die Engine liest alles, was 1.4 liefern soll: runtime:modern-v1 (F1), Ligatermine für 38 Spieltage (F3; Revision 1.3 spielt schon 38/38), den Lager-Katalog mit Karten (F4), den Schiedsrichter-Pool aus staff (F9). Für Finanzen (F7) braucht 0.3 nichts.

Stand Datenpflege (25.10.2026): Revision 1.4 ist gebaut und unabhängig geprüft (101 Prüfungen, null Fehler), zweimal bytegleich erzeugt und im ergänzten Editor verlustfrei geöffnet/gespeichert. Die Welt nennt beide Laufzeit-/Editoranforderungen, ist spielbar markiert und liefert 3 Karten, 18 Lager sowie 100 Schiedsrichter. Alle 3.414 Spieler haben born: bei den Originalen 2.345 aus Quellen ergänzt und 229 ausdrücklich als Simulation generiert; die 840 Ergänzungen bleiben unverändert. Original-IDs, Namen, Werte und Ressourcen bleiben erhalten. Ein Engine-Zug mit der neuen Welt ist geprüft; der unten genannte Mehrsaisontest bleibt beim Engine-Team. Der Editor-Supportfix liegt ebenfalls auf 0.3, kein neuer Editor-Release.

Aufgabenpaket Datenmigration 1.4 (Codex, Python-Migrationswerkzeug, privates Repo):

  1. Manifest: requires um runtime:modern-v1 ergänzen, playable: true. editor:world-v1 darf bleiben.
  2. Trainingslager: Regel rule:training-camps mit maps (Deutschland, Europa, Naher Osten) und den 18 Lagern aus docs/new_ui/desktop/trainingcamp nach F4; x/y bleiben null. Vorlage für Werte und IDs (resort:0..17): default_camp_catalogue() in src/modern/game/training_camps.cpp.
  3. Schiedsrichter: mindestens 50 neue staff-Zeilen (role: referee, ohne x-legacy) nach F9, fiktive Namen, attributes.strictness und attributes.perception je 0–3 ähnlich verteilt wie bei den 49 Originalen (x-legacy.property: Bits 3–4 bzw. 0–1).
  4. Stabile IDs: Vereins-, Spieler- und Schiedsrichter-IDs aus 1.3 unverändert lassen (der Almanach und die Spielstände beziehen sich darauf). 4a. Geburtsdaten auch für die 2.574 Originalspieler (heute Platzhalter-Alter 16). Die Engine übernimmt das Alter dann beim Karrierestart, statt es zu würfeln (Balance).
  5. Bericht, Prüfung und Editor-Roundtrip wie bei 1.3; Eintrag in DIAMOND_MIGRATIONS.md.

Danach: modern_season_sim mit der neuen Welt (zwei Saisons, SIM_CONTRACTS=1) muss ohne Doppeleinsätze von Schiedsrichtern und mit den 18 Lagern laufen; das prüfe ich.

M6 · Spielstände und UI-Projektionen

  • Spielstände .obs mit save_profile: modern-career-v1: gleiche Hülle wie Classic, aber Modern-Zustand mit Layout und Namen; Dimensionen aus der Welt.
  • Projektionen und Aktionen der ModernSession gemäß UI-Schnittstelle.

Abnahme: Speichern und Laden mitten in der Saison setzt identisch fort; UI-Projektionen haben Tests mit synthetischen Welten.

Umsetzung Spielstände (erledigt):

  • src/modern/content/world_save.*: save_world_career / load_world_career. Der Spielstand nennt seine Welt (ID und Datenrevision) und enthält nur die Karriere (Format siehe Datenformat F8).
  • Laden: ModernSession setzt zuerst das Classic-Layout zurück, liest den Spielstand und ruft dann install_world_dimensions(world) auf (aus expand_to_world herausgelöst), damit Layout, Ligagrößen und Kalender wieder zur Welt passen.
  • Autosave und save_game schreiben über save_world_career, sobald eine Welt geladen ist (current_world()).
  • Fehler behoben: Beim Auf- und Abstieg (ClubsChangePlaces) wurden die Modern-Namen (world_club_id/name/short) nicht mitgetauscht.
  • Prüfung: MODERN_SAVE_CHECK=N modern_season_sim … speichert nach Zug N, lädt in eine zweite Session und vergleicht Zustand, Namen und Layout. Nach Zug 30 und 58 identisch; zwei Saisons mit SIM_CONTRACTS=1: 0 von 168 Vereinsnamen falsch.

M7 · Balance

  • Konsolen-Langläufe mit dem Modern-Datensatz (mehrere Startkonstellationen, je zehn Saisons): Tore pro Spiel, Punkteverteilung je Liga, Ermüdung und Verletzungen bei 38 statt 22 Spieltagen, Marktwerte und Gehälter, Finanzen des menschlichen Vereins, Wirkung der Trainingslager.
  • Korrekturen zuerst in den Daten (etwa Werte der neu ergänzten Spieler, Preise), dann in Regeln; jede Regeländerung in DIFFERENCES.

Abnahme: Bericht mit Kennzahlen und begründeten Anpassungen.