Files
Dreierpack-Manager/docs/new_engine/AGENTS.md
T
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

25 lines
2.8 KiB
Markdown

# 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](ui-schnittstelle.md)), nie direkt aus `GameState`.
- Regeländerungen gegenüber Classic werden in [DIFFERENCES](../DIFFERENCES.md) als Modern-Abweichung festgehalten.
- Jede Änderung am OBW-Format (neue Felder, Wertebereiche, Prüfregeln) wird vor oder mit dem Code in [Datenformat](datenformat.md) eingetragen, mit einer Zeile „Editor“ für die nötige Editor-Anpassung.
- Mit jeder Phase den Status in [README](README.md) und die Details in [Phasen](phasen.md) 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.