Files
Dreierpack-Manager/docs/new_engine/ui-schnittstelle.md
T

8.7 KiB
Raw Blame History

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 direkt GameState und 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, Spieler photo).
  • 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
Fußball-Almanach ModernState::almanac: alle Spiele aller Saisons (Almanach); Auswertungs-Projektionen folgen, sobald die Oberfläche feststeht – M8 (Daten vorhanden)
Spielstatistik ModernSession::read_statistics: Sieger nach Jahren, Spielerstatistik je Wettbewerb (Tore, Vorlagen, Gelb, Gelb-Rot, Rot, Einsätze) (Spielstatistik) – M8

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, affordable je 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): Fehler camp_week_used, camp_season_limit, camp_unaffordable oder camp_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.

Spielstandmetadaten

ui_read({kind: "file-metadata"}) liefert die reine Projektion modern-career-metadata@1: Welt-/Karriere-ID, Datenrevision, Datum, Saison, nächster Ligaspieltag (National: unbekannt), Menschenzahl, aktive Person und Menschenliste mit stabiler ID, kanonischem Namen, Verein, Teamtext, Porträt und Nationalkennzeichen. Dieselbe Contentprojektion liest die geprüften OBS-Dateien für die Dateiliste ohne zweite aktive Session. Kein RNG, keine Änderungen an Weltmaßen und kein neues Save-/OBW-Format. Der Live-Frontendadapter liest auch hier ausschließlich über ModernSession::ui_read.

Große Statistikansicht

ui_read({kind: "statistics", query: {...}}) delegiert an die vorhandene ModernSession::read_statistics_screen. Das Snapshot-Datenobjekt enthält kind, die unveränderte query und report. Die bekannten Filter und das available-/reason-Verhalten bleiben erhalten. Vorhandene aktuelle Transfer- und Analytics-Projektionen ergänzen die belegten Almanachauswertungen. Der Read ist rein; weder OBS-/OBW-Format noch Spielregeln werden geändert.

Stadionangebote bearbeiten

quote.request kann ein bestehendes Block-/Ausstattungsangebot mit dessen quoteId erneut adressieren. Kennung, Art und Block/Ausstattung müssen zum aktuellen Besitzer passen. Der vorhandene Firmenpreis bleibt erhalten; reine Ziel-/Stufenwahl zieht keine neue Zufallszahl. Ohne quoteId bleibt es eine neue Anfrage, die vorhandene offene Angebote weiterhin abweist. stadium.commit bestätigt bzw. verwirft das genaue Angebot und schließt es. Der UI-Standardbau verwendet den bereits vorhandenen Weg ohne Beschleunigung.

Der Stadion-Read ergänzt tatsächliche geplante Kapazität/Ausstattung und vorhandene Messreihen/Tabellen. Bei Ausbau sind aktuelle und geplante Werte getrennt. Weitere Parkplatzstufen aus der Grafikstudie werden nicht erfunden: die aktuelle Engine kennt neben der mehrstufigen Anbindung binäre Außenobjekte. Kein neues Welt-/Spielstandformat und keine neue Bau- oder Finanzregel.