Files
Dreierpack-Manager/docs/new_engine/phasen.md
T
ClaudeandClaude Opus 5.5 0e708f2b63 Document the Modern engine plan for 0.3 in docs/new_engine
Modern starts as a fork of the Classic season core under src/modern/ and
shares formats, GameState (with a world layout) and the match core; Classic
stays unchanged. Covers the fixed Classic sizes to resolve, phases M0-M7
with acceptance criteria, the training camp catalogue with a bounded six-star
tier, and the session interface the Modern UI builds against.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 16:00:18 +02:00

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

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.
  • Werkzeug: C++ (openbmh_world_migrate) oder das bestehende Migrationswerkzeug der Datenpflege; vor Beginn abstimmen.

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

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.

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.