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

9.5 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.

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.

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).
  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.