M3 - Modern world loader: - modern/content/world: typed view of the world tables (leagues, clubs, players, nations, league dates, training camp catalogue). - modern/content/world_package: opens a Modern world (runtime:modern-v1, or editor:world-v1 until data revision 1.4), reads only the engine entries and decodes the Classic payload (import: load_classic_payload). - modern/content/world_expand: turns the Classic start into the world: club ids in the order of the world's leagues, per-club tables remapped (added clubs copy an original club of their league), added players from their attributes, 24 squad slots per league club, pools kept, layout, league sizes and league dates installed; UTF-8 names and OBW ids in ModernState. - Fixes found by playing the Modern data set: referee pool exhausted on days with German and larger international leagues (Modern deviation), card table per league club grown, slot-to-team lookup via WorldLayout, form history stride from the layout, remaining slot literals. - Classic UI projections used by the session read the layout instead of executable constants (Classic values unchanged). - modern_season_sim opens .obw worlds; MODERN_DEBUG / MODERN_WATCH tracing. M4 - training camps: - Catalogue in ModernState (built-in 18 fictional camps on three maps, or the world's extended catalogue); price, booking and effect use it. - Six-star grades: step index capped, limit +1 from pitch 5 and +1 with pitch and fitness 6, catering 6 one more point of condition, lodging 6 one week less injury. Classic data behaves as before. modern_camp_tests. Verified: 190 tests pass; Classic replay regression identical to the M0 baseline; season_sim and modern_season_sim identical with Classic data; the Modern data set plays full seasons (leagues 34/38/34 rounds). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.3 KiB
UI-Schnittstelle · Modern-Engine
Stand: 23. Oktober 2026. Einstieg für die Arbeit an der Modern UI. Hier steht, was die Modern-Engine der Oberfläche liefert, ab welcher Phase es verfügbar ist und womit die UI bis dahin arbeitet.
Grundsatz
- Die Modern UI (RmlUi) spricht ausschließlich mit der
ModernSession(src/modern/app/modern_session.hpp, ab M1) und deren Projektionen. Sie liest nie direktGameStateund rechnet keine Spielregeln nach (Preise, Grenzen, Tabellen). - Projektionen sind unveränderliche Momentaufnahmen mit einer Revision. Aktionen geben die neue Revision oder einen Fehlercode mit deutscher und englischer Meldung zurück; abgelehnte Aktionen ändern nichts.
- Identitäten sind die stabilen OBW-IDs (
club:…,player:…,comp:…,resort:…), nicht Laufzeitindizes. - Weltbilder werden über Asset-Schlüssel referenziert (
asset:club/<id>/crest,asset:player/<id>/photo,asset:comp/<id>/trophy). Auflösung und Rückfallbilder übernimmt die UI über das Asset-Verzeichnis des Datensatzes. Feste GUI-Motive, insbesondere Trainingslagerbilder und Karten, gehören zum eigenen GUI-Ressourcenbestand; sie müssen nicht im OBW-Paket liegen (GUI-/Welt-Trennung). - Texte aus der Engine (Post, Meldungen) kommen als fertige UTF-8-Zeichenketten in der gewählten Sprache.
Verzeichnisaufteilung
| Pfad | Inhalt | Zuständig |
|---|---|---|
src/modern/game/ |
Saisonlogik (Abzweig von Classic) | Engine |
src/modern/content/ |
Laden der Modern-Welt, Spielstände | Engine |
src/modern/app/ |
ModernSession, Projektionen, Aktionen |
Engine |
src/modern/ui/ |
RmlUi-Fenster, Ansichten, Modell der Oberfläche | UI |
Der bestehende POC (modern::Model mit Snapshot, gesichert unter Tag archive/modern-poc-0.2) kann weitergeführt werden. Er hängt künftig an der ModernSession statt an der Classic-CareerSession. Wird der POC übernommen, wandert er nach src/modern/ui/.
Modern-Welt laden (ab M3)
auto package = bmh::modern::open_world_package(path); // modern/content/world_package.hpp
bmh::content::Mount mount(path, package.classic); // Original-Datenbereiche unter dem Paketpfad
bmh::modern::set_current_world(package.world); // eine Welt pro Prozess
bmh::modern::app::ModernSession session(path, seed); // erweitert den Start auf die Welt
ModernState(session.state()) hält pro Laufzeit-Index die UTF-8-Namen und OBW-IDs:world_club_id,world_club_name,world_club_short(pro Verein),world_player_id,player_first,player_last,player_nation(pro Spieler). Die Bildschlüssel stehen in der Welt (current_world()->clubs[...].crest, Spielerphoto).- HD-Bilder liest die UI selbst aus dem Paket; die Engine lädt sie nicht.
- Bis die Projektionen unten fertig sind, liefert die Session noch die Classic-UI-Projektionen; sie sind auf variable Ligagrößen umgestellt.
Projektionen und Aktionen
| Bereich | Projektion | Aktionen | Ab Phase |
|---|---|---|---|
| Sitzung | SessionInfo: Datensatz-Titel, Datenrevision, Sprache, Währung |
Neue Karriere, Laden, Speichern | M3 (Laden/Speichern M6) |
| Karrierestart | ClubChoice[]: nur deutsche Vereine in 0.3, mit Liga, Name, Kurzname, Wappen |
Manager anlegen, Verein wählen | M3 |
| Statusleiste | DeskStatus: Verein, Manager, Termin bzw. Saisonvorbereitung, Saison, Guthaben |
– | M3 |
| Ligen | LeagueInfo[]: ID, Name, Land, Stufe, Anzahl Vereine (12–20), Spieltage |
– | M2 |
| Tabelle | LeagueTable: bis 20 Zeilen mit Verein, Spiele, S/U/N, Tore, Punkte, Platzierung |
– | M2 |
| Spielplan | Fixtures: je Liga und Spieltag die Paarungen und Ergebnisse |
– | M2 |
| Kader | Squad: bis 24 Plätze; je Spieler ID, Vorname, Nachname, Position, Alter, Werte, Vertrag, Porträt |
Aufstellung tauschen | M3 |
| Spieler | PlayerCard: Detailwerte, Marktwert, Gehalt, Statistik |
– | M3 |
| Trainingslager | siehe unten | Schwerpunkte setzen, buchen | M4 |
| Post | Mail[]: Datum, Absender, Betreff, Text |
Gelesen markieren | M3 |
| Spieltag | Fortschritt und Ereignisse über den bestehenden Match-Kern | Weiter, Eingriffe | M3 |
Alles, was hier noch fehlt (Transfers, Finanzen, Stadion, Umfeld und weitere Menüs), folgt nach demselben Muster. Jedes neue Menü der UI bekommt in diesem Dokument eine Zeile, sobald seine Projektion festgelegt ist.
Trainingslager
Projektion TrainingCampView:
maps[]: Karten mit ID, Name und – sobald festgelegt – Breite und Höhe; die UI zeigt je Karte einen Umschalter,camps[]: ID, Karte (map:de,map:eu,map:me), X/Y-Lage auf der Karte (anfangs leer), Name, Ort, Land, vier Qualitätswerte (0–6), Basispreis, optionaler Bildschlüssel für ein ausdrücklich in der Welt geliefertes Bild,price: Preis für den aktuellen Kader (Basispreis + 5000 × Spieler) je Lager,stays_this_season(0–3),booked_this_week,affordableje Lager,focus: Kondition, Technik, Spiel (0–15) und die abgeleitete Erholung.
Koordinatensystem und Maße der Karten legt die Oberfläche fest; die Werte werden über den Editor in den Datensatz eingetragen (siehe Datenformat F4). Bis dahin platziert die UI Lager ohne Koordinaten selbst, zum Beispiel nach dem bisherigen POC.
Ohne datensatzspezifischen Bildschlüssel ordnet die GUI der Karten-/Lager-ID ihre eigenen Bildmotive zu. Die Session lädt keine GUI-Bilder und verlangt für Standardmotive keine Einträge im OBW-Asset-Index.
Aktionen:
set_camp_focus(kondition, technik, spiel): Fehler, wenn ein Wert außerhalb 0–15 liegt.book_camp(camp_id): Fehlercamp_week_used,camp_season_limit,camp_unaffordableodercamp_unknown; bei Erfolg bucht die Engine den Preis, wendet die Wirkung an und liefert die neue Revision.
Die bisherige POC-Vormerkung bleibt ein reiner UI-Zustand; erst book_camp
löst eine Buchung aus. Regeln und 6-Sterne-Wirkung: Trainingslager.
Bis die Engine liefert
- Die UI arbeitet mit dem POC-Zustand oder mit Beispieldaten in genau den oben genannten Formen. Beispieldaten sind fiktiv und liegen bei den UI-Tests, nicht im Datensatz.
- Weicht eine Projektion von dieser Beschreibung ab, wird zuerst dieses Dokument angepasst, dann der Code.
- Fragen zur Schnittstelle als GitHub-Issue mit dem Label
modern-engine.