124 lines
12 KiB
Markdown
124 lines
12 KiB
Markdown
# 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](befund.md) 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](trainingslager.md): 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](datenformat.md#f9--schiedsrichter)) 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](datenformat.md#f4--trainingslager); `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](datenformat.md#f9--schiedsrichter), 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](balance.md)).
|
||
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](ui-schnittstelle.md).
|
||
|
||
**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](datenformat.md)).
|
||
- 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](../DIFFERENCES.md).
|
||
|
||
**Abnahme:** Bericht mit Kennzahlen und begründeten Anpassungen.
|
||
|
||
## M8 · Almanach: Anschluss und Schussserien
|
||
|
||
Die native Oberfläche liest Kalender, Tagespaarungen, Spielberichte und Ereignisse
|
||
über die revisionsgebundene Modern-Sessionprojektion; die getrennte Demo bleibt
|
||
eine eigene Quelle. Details stehen im [Almanach-Menü](../new_ui/desktop/almanac/README.md).
|
||
|
||
Nachbesserung vom 28. Oktober 2026 (#18): Der Recorder erfasst Elfmeterschüsse aus
|
||
dem Matchprotokoll einmalig und getrennt von Spieltoren. Die Leseprojektion
|
||
berichtigt eindeutig belegte ältere Doppelprotokolle in Kopien. Spielstandbytes,
|
||
Spielentscheidungen und RNG bleiben unverändert. Hallen- und unklare
|
||
Verlängerungs-Teilstände werden ausdrücklich behandelt. Format und Editor
|
||
benötigen keine Anpassung; [Nachweise und Grenzen](almanach.md).
|
||
|
||
### M6 · Tabellen-/Stärken-Leseprojektion, 28. Oktober 2026
|
||
|
||
`report-index` nennt die tatsächlich aktiven Ligen und ihre aktuellen Mitglieder.
|
||
`league-report` kapselt ComputeLeagueTable mit fünf Filtern und TeamAverage für
|
||
den ganzen Kader. Die UI ordnet gelieferte Zeilen nur zur Ansicht um; Kader und
|
||
Profile nutzen den bestehenden squad-Read. Es gibt keine Regel-, OBW- oder
|
||
Editor-Formatänderung. Nicht projizierte Qualifikationszonen bleiben unbekannt.
|
||
Synthetische Tabellen-/Subset-/Bereichsprüfungen und private Read-/GUI-Rundreisen
|
||
stehen unter `bmh_4k_ui/docs/qa/engine-reports-2026-10-28/`.
|