Files
ClaudeandClaude Opus 5.5 f2fcb28f65 Fork the Classic season core into src/modern and add the world layout (M1)
- src/modern/game: the season modules as bmh::modern, working on ModernState
  (a GameState). Data types stay shared with Classic; Modern code calls its
  season functions qualified (modern::...), so a missing Modern function is a
  compile error instead of a silent call into Classic.
- src/modern/app/modern_session: the session on the Modern core. It still uses
  the Classic UI projections until the Modern projections exist.
- SeasonHooks: the shared match core reaches player statistics and the table
  prediction of the season core that owns the game (Classic: unchanged).
- WorldLayout: team ranges, squad slots and pools of the running world. Shared
  code and the Modern fork read them; Classic keeps the original numbers.
- Transfer list views moved to game/transfer_offer_view.hpp (shared).
- tools/modern/check_fork_calls.sh, modern_season_sim and world_layout_tests.

Verified: Classic tests and replay regression unchanged; season_sim and
modern_season_sim produce identical output with Classic data.

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

2.8 KiB

Modern-Engine · Regeln für Agenten

  • Modern-Engine-Arbeit findet auf dem Branch 0.3 statt; Dokumentation liegt in docs/new_engine/.
  • Code der Modern-Saisonlogik gehört ausschließlich nach src/modern/ (Namespace bmh::modern).
  • Classic bleibt unverändert. Gemeinsame Teile (src/formats, src/game/state.*, Zufall, Match-Kern) dürfen nur so geändert werden, dass Classic mit seinem Layout bit-identisch bleibt. Nach jeder solchen Änderung laufen Classic-Tests und Regression.
  • Die Modern-Engine lädt nur Modern-Datensätze (runtime:modern-v1); Classic lädt keine Modern-Datensätze.
  • UI-Code (RmlUi) liest Spielzustand nur über die Modern-Session und ihre Projektionen (UI-Schnittstelle), nie direkt aus GameState.
  • Regeländerungen gegenüber Classic werden in DIFFERENCES als Modern-Abweichung festgehalten.
  • Jede Änderung am OBW-Format (neue Felder, Wertebereiche, Prüfregeln) wird vor oder mit dem Code in Datenformat eingetragen, mit einer Zeile „Editor“ für die nötige Editor-Anpassung.
  • Mit jeder Phase den Status in README und die Details in Phasen nachführen.
  • Private Datensätze, echte Namen, Wappen und Fotos gehören nicht in dieses Repository; Tests nutzen synthetische Welten.
  • Diese Notizen sind deutsch; Code, Kommentare und Commits englisch.

Arbeiten im Abzweig (seit M1)

  • Der Abzweig ist mit Skripten aus Classic erzeugt worden; seitdem wird src/modern/ von Hand gepflegt. Classic-Änderungen werden nicht automatisch übernommen.
  • Modern-Saisonfunktionen nehmen ModernState (src/modern/game/modern_state.hpp), eine Ableitung von GameState. Modern-Code ruft sie qualifiziert auf: modern::name(...). Ein fehlender Modern-Aufruf wird so zum Übersetzungsfehler statt zum stillen Aufruf der Classic-Version.
  • Datentypen sind zwischen Classic und Modern gemeinsam: Ein Modern-Header bindet den Classic-Header für die Typen ein und deklariert nur die Modern-Funktionen. Ein eigener Modern-Typ entsteht erst, wenn Modern ihn ändern muss.
  • Gemeinsame Callback-Typen übergeben GameState&; in Modern wird dort ausdrücklich nach ModernState& gewandelt.
  • Feste Classic-Größen (138, 168, 0x165, Pool-Slots) kommen in Modern aus dem WorldLayout (league_clubs(), first_foreign_cup(), no_team(), transfer_list_slot() …). Offsets im Speicherabbild (etwa rec + 0xa8) bleiben.
  • Prüfungen nach jeder Änderung:
    • tools/modern/check_fork_calls.sh build und LIBRARY=bmh_modern_session tools/modern/check_fork_calls.sh build: Modern ruft keine Classic-Saisonfunktion.
    • season_sim und modern_season_sim mit Classic-Daten und gleichen Argumenten liefern dieselbe Ausgabe, solange Modern keine Regel bewusst ändert.
    • Classic-Tests und Classic-Regression unverändert.