Separate Modern GUI artwork from world-owned assets (by Codex)

This commit is contained in:
Codex committed 2026-10-23 17:05:40 +02:00
1 parent d6a929534b
commit 96203aea20
9 files changed
+187 -15

No files matched your search

+1
View File
@@ -532,6 +532,7 @@ Composed pictures may be cached in the user's cache directory; they are never wr
### 9.6 RmlUi themes (`.obt`)
- A theme contains `.rml` documents, `.rcss` style sheets, fonts, icons and its `locale/` texts, plus a manifest naming the client version it targets.
- Fixed interface artwork, including training-camp illustrations, maps, menu scenes and desktop motifs, belongs to the GUI resources or theme, not to the world. World assets include club crests, player photos and competition trophies. The stock Modern UI must not require its own pictures in the world's asset index; see the [GUI/world boundary](../new_ui/assets.md). Old interface images can be removed from Modern worlds through a separate validated migration once their remaining dependencies are gone. Classic content and its seals retain their existing requirements.
- Interfaces bind to a **view model**, not to the world files. The client exposes data models (RmlUi data bindings) built from the application/protocol layer (`docs/protocol.md`), with ids and asset keys as values. RmlUi loads images through a file interface that resolves `asset:` keys (§9.2).
- Neither worlds nor packs contain layout, so a theme works with every world, and the classic 320×200 interface keeps working next to it.
+4 -4
View File
@@ -66,8 +66,7 @@ Die bestehende Regel `rule:training-camps` (Typ `training_camps`) bleibt und wir
"y": null,
"name": {"default": "Sportzentrum Groningen"},
"place": {"default": "Groningen"},
"country": "nation:nl",
"image": "asset:camp/4/image"
"country": "nation:nl"
}
]
}
@@ -76,10 +75,11 @@ Die bestehende Regel `rule:training-camps` (Typ `training_camps`) bleibt und wir
- `id`, `base_price`, `quality` wie bisher; `quality` in der Reihenfolge Platz, Fitness, Verpflegung, Unterkunft, je **0–6** (Classic: 1–5).
- **Karte und Lage:** Jedes Lager trägt immer `map` (Verweis auf `maps`) sowie `x` und `y` als ganzzahlige Koordinaten auf dieser Karte. Das Koordinatensystem einer Karte legt die Oberfläche fest; solange es nicht feststeht, sind `x` und `y` `null`. Sobald die GUI die Kartenmaße liefert, bekommt jede Karte zusätzlich `width` und `height` (Ursprung oben links), und `x`/`y` müssen innerhalb liegen.
- Die Karten sind eine eigene Liste, damit später weitere hinzukommen können, etwa wenn ausländische Vereine spielbar werden und Lager aus deren Sicht dargestellt werden. Ein Lager gehört genau zu einer Karte.
- Weitere Pflichtfelder für Modern: `name`, `place`, `country`, `image` (Asset-Schlüssel). Geografische Koordinaten werden nicht gespeichert.
- Weitere Pflichtfelder für Modern: `name`, `place`, `country`. Geografische Koordinaten werden nicht gespeichert.
- Standardkarten und Resortbilder sind GUI-Ressourcen und werden anhand von Karten-/Lager-ID zugeordnet; sie sind keine Pflichtinhalte der Welt. `image` ist optional und nur für ein ausdrücklich in der Welt geliefertes Bild vorgesehen. Wenn gesetzt, muss der Asset-Schlüssel im normalen OBW-Asset-Index auflösbar sein. Siehe [GUI-/Welt-Trennung](../new_ui/assets.md).
- Die IDs `resort:0` bis `resort:17` entsprechen den IDs 0–17 der Oberfläche und werden nicht umsortiert.
- Fehlt die Regel in einer Modern-Welt, gilt die öffentliche Vorgabe `assets/modern/rules/training_camps.json` mit den 18 fiktiven Lagern.
- **Editor:** Kartenliste und Lager bearbeiten: Karte (Pflicht), `x`/`y` (leer erlaubt, solange die Karte keine Maße hat), vier Qualitätswerte (0–6), Preis, Ort, Land und Bild. Prüfung auf eindeutige IDs, gültige Karte und Nation, Qualitäten im Bereich und Koordinaten innerhalb der Kartenmaße, sobald diese gesetzt sind.
- **Editor:** Kartenliste und Lager bearbeiten: Karte (Pflicht), `x`/`y` (leer erlaubt, solange die Karte keine Maße hat), vier Qualitätswerte (0–6), Preis, Ort, Land und optionales datensatzspezifisches Bild. Prüfung auf eindeutige IDs, gültige Karte und Nation, Qualitäten im Bereich, auflösbare explizite Bildreferenzen und Koordinaten innerhalb der Kartenmaße, sobald diese gesetzt sind. Ein fehlendes `image` ist kein Fehler; feste GUI-Motive müssen nicht in den Datensatz kopiert werden.
## F5 · Namen
+2 -2
View File
@@ -38,8 +38,7 @@ Der Katalog erweitert die bestehende Regel `rule:training-camps` (Liste
"y": null,
"name": {"default": "Sportzentrum Groningen"},
"place": {"default": "Groningen"},
"country": "nation:nl",
"image": "asset:camp/4/image"
"country": "nation:nl"
}
```
@@ -47,6 +46,7 @@ Der Katalog erweitert die bestehende Regel `rule:training-camps` (Liste
- `map`: immer gesetzt, `map:de` (Deutschland), `map:eu` (Europa) oder `map:me` (Naher Osten); weitere Karten können später hinzukommen.
- `x`, `y`: Lage auf der Karte in deren Koordinatensystem; bis die Oberfläche die Kartenmaße festlegt `null`.
- Die IDs `resort:0` bis `resort:17` entsprechen den IDs 0–17 der Oberfläche und werden nicht neu sortiert.
- Standardkarten und Resortbilder liefert die GUI anhand dieser IDs; sie sind keine Pflichtdateien im OBW-Paket. Das optionale Feld `image` ist nur für ein ausdrücklich im Datensatz geliefertes Bild vorgesehen ([GUI-/Welt-Trennung](../new_ui/assets.md)).
- Preis, Grenzen und Schwerpunkte bleiben wie in Classic.
## Die 6-Sterne-Stufe
+7 -3
View File
@@ -9,7 +9,7 @@ und womit die UI bis dahin arbeitet.
- 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.
- Bilder werden über Asset-Schlüssel referenziert (`asset:club/<id>/crest`, `asset:player/<id>/photo`, `asset:comp/<id>/trophy`, `asset:camp/<n>/image`). Auflösung und Rückfallbilder (Silhouette, generisches Wappen) übernimmt die UI über das Asset-Verzeichnis des Datensatzes.
- 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](../new_ui/assets.md)).
- Texte aus der Engine (Post, Meldungen) kommen als fertige UTF-8-Zeichenketten in der gewählten Sprache.
## Verzeichnisaufteilung
@@ -21,7 +21,7 @@ und womit die UI bis dahin arbeitet.
| `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`, Branch `assist/codex-0.2-modern-poc`) 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/`.
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/`.
## Projektionen und Aktionen
@@ -48,7 +48,7 @@ Dokument eine Zeile, sobald seine Projektion festgelegt ist.
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, Bildschlüssel,
- `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.
@@ -58,6 +58,10 @@ Koordinatensystem und Maße der Karten legt die Oberfläche fest; die Werte werd
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.
+1
View File
@@ -5,4 +5,5 @@
- Record the source revision, visible data, interactions and outstanding engine decisions.
- Clearly distinguish the HTML prototype, a native RmlUI implementation and engine behaviour.
- Update the relevant document with each substantive UI change and link it from the index.
- Fixed UI artwork, including training-camp maps and illustrations, belongs to the GUI resource set, not the OBW world. Follow `assets.md`; never require stock GUI pictures in a world's asset index.
- Use German for these user-facing design notes. Keep proprietary reference assets out of this repository.
+77
View File
@@ -0,0 +1,77 @@
# Native Modern UI bis zum Anstoß
Stand: 23. Oktober 2026. **Abgestimmter Umfang; native Umsetzung noch offen.**
Diese Seite hält die Entscheidungen aus dem UI-Plan fest. Sie ersetzt keine
Implementierungs- oder Abnahmebelege. Die Engine entsteht parallel bei Claude.
## Einstieg und Darstellung
- Die native Oberfläche entsteht in OpenBMH mit SDL2/RmlUI auf `0.3`.
- Gestalterische Referenz ist das aktuelle HTML-Mockup im privaten Repository
`bmh_4k_ui`, einschließlich aller drei Themes und der jüngsten QA-Korrekturen.
Es werden keine vereinfachten Ersatzansichten oder neue Layouts eingeführt.
- Das gemeinsame Hauptmenü und seine Mod-Verwaltung folgen dem Mockup. Die
aktive Mod entscheidet: Classic startet die alte UI, Modern die neue Demo.
- Die erste vollständige Fassung ist deutsch. Übersetzungsschlüssel werden
vorbereitet; Englisch bleibt bis zur vollständigen Übersetzung deaktiviert.
- Das Paket umfasst Hauptmenü, Grundeinstellungen, Manager-/Vereinswahl,
Saisonvorbereitung, den bedienbaren Desktop und sämtliche vor dem Anstoß
erreichbaren Untermenüs. Anstoß bleibt sichtbar und positionierbar, hat aber
weder per Maus noch per Tastatur eine Startaktion. Matchansicht, Simulation
und Post-Match gehören nicht zu diesem Paket.
## Daten und Zuständigkeit
- Diamond 2026/27 Modern liefert Namen, Kader, Werte, Ligen und HQ-Weltbilder
schreibgeschützt aus dem OBW-Paket. Die Demo verändert den Datensatz nicht.
- Veränderliche Zustände wie Kontostände, Tabellen, Nachrichten und Abläufe
werden von einem getrennten Demo-Datenanbieter geliefert. UI-Aktionen dürfen
Demo-Eingaben speichern, bilden aber keine Spielregeln oder Saisonlogik nach.
- Der Datenanbieter gibt unveränderliche Projektionen mit Revision heraus und
nimmt Aktionen entgegen. Die spätere Modern-Session wird über einen Adapter
angebunden; Fenster und Renderer lesen nie direkt `GameState`.
- GUI-Motive sind ein eigener Ressourcenbestand. Trainingslagerbilder und
Karten kommen aus der GUI, Vereinswappen und Spielerfotos aus der Welt.
Einzelheiten: [GUI-/Welt-Trennung](assets.md).
- Demo-Spielstände bleiben von echten `.obs`-Karrieren getrennt. Ihre
Speichern-/Laden-Dialoge entsprechen dem Mockup; sie bestätigen keine
Engine-Spielbarkeit.
## Spielwelt und Auswahl
- Das Ligaset folgt Diamond/BMH: fünf deutsche Ligen mit je 18 Vereinen;
LaLiga, Premier League und Serie A mit je 20 sowie Ligue 1 mit 18 Vereinen.
Es werden keine zusätzlichen Ligen aus dem großen Season-Paket übernommen.
- Wettbewerbe behalten ihre BMH-Struktur. Aktuelle Champions-/Europa-/Conference-
League-Regeln werden nicht aus der Darstellung des HTML-Demos abgeleitet.
- Manager können nur deutsche Vereine übernehmen. Ausländische Vereine bleiben
sichtbar; ihre Logos sind abgeblendet und mit einem Schloss markiert. Die
Übernahme ist auch per Doppelklick oder Tastatur gesperrt.
- Tabellen, Kader und Spielpläne der ausländischen Ligen bleiben einsehbar.
- Die Trainingslageransicht unterstützt Deutschland, Europa und Nahost mit
den abgestimmten 18 Lagern. Bis die Engine-Projektion vorliegt, liefert ein
separater Demo-Katalog diese Daten. Die acht alten Lager in Diamond 1.3 werden
nicht als vollständiger Modern-Katalog ausgegeben.
## Übertragung und Abnahme
1. Gemeinsamer Unterbau: Welt-/GUI-Ressourcen, Datenanbieter, Komponenten,
Mod-Routing und drei Themes.
2. Durchgehender Weg vom Hauptmenü über Managerwahl und Saisonvorbereitung
zum Desktop.
3. Vollständiger Widgetkatalog, Raster/freies Verschieben, Fixierung,
Rückgängig, Ansichten und alle vereinbarten Untermenüs.
4. Vergleichsbilder mit zugehörigen Demo-Zuständen und zusammenhängender
GUI-Abnahme; Testpakete für Windows x64, Linux x64 und macOS ARM64.
Die Untermenüs übernehmen den gemeinsamen 4:3-Rahmen mit 2720 × 2040 im
logischen 3840 × 2160-Desktop. Abnahme umfasst 720p, Full HD, 4K, HiDPI und
Ultrawide, lesbare Eingaben und Dropdowns, Bildproportionen und Inhalte innerhalb
ihrer Flächen. Jede Ansicht wird mit der HTML-Referenz verglichen; gemeinsame
Bedienelemente und repräsentative Fenster zusätzlich in allen drei Themes.
Regressionen laufen an Meilensteinen und bei Änderungen gemeinsamer Bausteine.
Classic-Import/-Start bleibt eine eigene Gegenprobe. Private Daten, Motive und
referenzabhängige QA-Belege bleiben im privaten Bestand; öffentliche Tests
verwenden synthetische Welten. Detailverträge werden vor oder mit der jeweiligen
Implementierung in [new_engine](../new_engine/ui-schnittstelle.md) nachgeführt.
+2
View File
@@ -7,6 +7,8 @@ Implementierung in der Spiel-Engine.
| Bereich | Dokument |
|---|---|
| Umsetzung | [Abgestimmter Umfang der nativen UI bis zum Anstoß](PLAN.md) |
| Ressourcen | [GUI-Assets, Weltbilder und spätere Paketbereinigung](assets.md) |
| Desktop | [Statusleiste, Gestaltung und Fenster](desktop/README.md) |
| Trainingslager | [Alle 18 Angebote, Qualitätswerte und Bedienung](desktop/trainingcamp/README.md) |
| Transfers | [Ablöse-Kasten und Positionsfilter](desktop/transfers/README.md) |
+81
View File
@@ -0,0 +1,81 @@
# GUI-Ressourcen und Weltinhalte
Stand: 23. Oktober 2026. Festlegung für die native Modern UI, noch keine
Implementierung eines neuen Ressourcenladers oder einer Paketmigration.
## Zuständigkeit
Die festen Bildmotive des HTML-Mockups gehören zur GUI. Sie werden zusammen mit
der Oberfläche ausgeliefert und müssen nicht im aktiven OBW-Paket vorhanden sein.
Das gilt insbesondere für die HD-Trainingslagerbilder, die aktuell nur im
privaten Mockup-Repository vorliegen.
| GUI-Ressourcen | Weltinhalte im OBW-Datensatz |
|---|---|
| Desktop-Icons, Widgetmotive und Bedienelemente | Vereinsnamen, Wappen und Vereinsfarben |
| Hintergrund, Themes, Fenster, Schriften und UI-Texte | Spieler, Werte, Verträge, Fotos und Jugendporträt-Auswahl |
| Trainingslagerkarten und feste Resort-Illustrationen | Trainingslager-IDs, Regionen, Lage, Namen, Qualitätswerte und Preise |
| Bank-, Stadion-, Umfeld- und andere feste Menüillustrationen | Stadionzustand, Finanzen, Personal und sonstige Spielwerte |
| Managerporträt-Auswahl der GUI | Wettbewerbsdefinitionen und zugeordnete Trophäen |
Die GUI verwendet Bildmotive unverändert aus dem abgestimmten Mockup. Dynamische
Werte, Texte, Auswahlzustände und Trefferflächen bleiben davon getrennt.
## Laden und Referenzieren
- Die GUI besitzt einen eigenen Ressourcenbestand, zunächst unter
`assets/modern/gui/` neben den Programmressourcen. Die geplanten Theme-Pakete
nach [OBW §9.6](../formats/OBW.md#96-rmlui-themes-obt) bleiben davon unabhängig
als spätere Verpackung möglich; ein neuer Theme-Importer ist hier nicht vereinbart.
- Weltbilder werden über den Asset-Index des aktiven OBW-Pakets aufgelöst.
Die bestehenden HQ-/SVG-Varianten haben Vorrang vor niedrig aufgelösten
Classic-Varianten desselben Inhalts.
- GUI- und Weltauflösung bleiben getrennte Schnittstellen. Der GUI-Lader greift
nicht auf `assets/classic/` oder alte KB-/VGA-Objekte der Welt zurück.
- Die Engine liefert semantische IDs und Projektionen, keine Dateipfade zu
GUI-Bildern. Die Oberfläche ordnet den IDs ihre festen Bildmotive zu.
- Fehlende GUI-Ressourcen werden als unvollständige GUI-Installation gemeldet.
Fehlende Spielerfotos verwenden die vorgesehene Silhouette. Ein fehlendes
GUI-Bild macht den Weltkatalog nicht zu einem ungültigen OBW-Datensatz.
## Trainingslager
Die drei Karten und die 18 Resortmotive gehören zur GUI. Die Oberfläche ordnet
sie über `map:de`, `map:eu`, `map:me` beziehungsweise `resort:0` bis `resort:17`
zu. Die bestehende Reihenfolge wird nicht neu nummeriert. Die Karten des
Mockups haben jeweils einen Zeichenraum von 1200 × 1336; die Lagewerte einer
Welt müssen zum dokumentierten Kartenkoordinatensystem passen.
Ein Standardlager benötigt **keinen** Eintrag wie `asset:camp/4/image` im
Asset-Index der Welt. Das optionale Feld `image` bleibt für ein ausdrücklich
mitgeliefertes, datensatzspezifisches Bild möglich; dann ist es ein normaler
OBW-Asset-Verweis und muss dort auflösbar sein. Ohne diesen Verweis wählt die
GUI ihr eigenes Resortmotiv anhand der Lager-ID.
Diese Trennung gilt auch für die Demo: Diamond liefert die vorhandenen Welt-
und HQ-Spielerinhalte; die GUI liefert ihre Karten und Resortbilder. Der noch
separate 18er-Demokatalog ist kein Anlass, GUI-Bilddateien in die Welt zu kopieren.
Die Regeln und die künftige Engine-Anbindung stehen in
[Datenformat F4](../new_engine/datenformat.md#f4--trainingslager).
## Schrittweise Bereinigung der Modern-Pakete
Alte GUI-Grafiken sollen schrittweise aus Modern-OBW-Paketen verschwinden.
Dafür erhält die Modern UI von Anfang an keine Abhängigkeit auf diese Dateien.
Eine Entfernung erfolgt als eigene, protokollierte Datenmigration: betroffene
Dateien und Referenzen erfassen, verbleibende Daten-/Editor-/Engine-Nutzung
prüfen, entfernen und die neue Paketrevision validieren. Classic-Pakete behalten
ihre für die alte Oberfläche erforderlichen Inhalte und Siegel.
Mit dieser Dokumentationsänderung wird kein bestehendes Paket umgeschrieben.
Die öffentliche Quellverteilung enthält weiterhin nur eigene oder entsprechend
freigegebene Ressourcen und synthetische Tests. Referenzabhängige Motive und
private QA-Inhalte bleiben im privaten Bestand.
## Quellen
- Benutzerfestlegung vom 23. Oktober 2026 zur Zuständigkeit der GUI-Assets.
- Privates Repository `bmh_4k_ui`, Ausgangscommit
`cacf8fdd5376110529afbf97c7b977aaee1d7957`: Karten, Campmotive und Menügrafiken.
- Diamond 2026/27 Modern, Datenrevision 1.3: der geprüfte Asset-Index enthält
HQ-Wappen und Spielerbilder, aber keine `asset:camp/...`-Bildschlüssel.
+12 -6
View File
@@ -72,15 +72,21 @@ Migration gespeicherter POC-Ansichten nicht versehentlich neu sortiert werden.
## Grundlage für die Engine-Anbindung
Die UI benötigt eine stabile Lager-ID, Region, geografische Position, Name,
Ort und Land, vier Qualitätswerte, Preis und Bildreferenz. Auswahl und
Die UI benötigt eine stabile Lager-ID, Karte und X/Y-Lage, Name,
Ort und Land, vier Qualitätswerte und Preis. Auswahl und
Vormerkung sind getrennte Zustände; die drei einstellbaren Schwerpunkte
werden separat gespeichert.
Vor einer wirksamen Buchung sind Preisbasis, Dauer, verfügbare Termine,
Stornierung und Trainingswirkung festzulegen. Der POC spezifiziert diese
Spielregeln nicht. Insbesondere darf aus dem angezeigten Preis kein Preis
pro Spieler oder pro Woche abgeleitet werden.
Karten und feste Lagermotive gehören zum GUI-Ressourcenbestand und werden über
die Karten- beziehungsweise Lager-ID zugeordnet. Sie müssen nicht im OBW-Paket
liegen. Ein optionales datensatzspezifisches Bild kann die Welt ausdrücklich
über ihren Asset-Index liefern. Siehe [GUI-/Welt-Trennung](../../assets.md).
Der POC spezifiziert keine Spielregeln für eine wirksame Buchung. Der inzwischen
abgestimmte [Engine-Plan](../../../new_engine/trainingslager.md) legt einen Preis
pro Aufenthalt, Grenzen und Wirkung fest. Die UI übernimmt später Preisangebote
und Ergebnisse aus der Session; aus den hier angezeigten Demo-Preisen wird keine
eigene Preis- oder Trainingsberechnung abgeleitet.
## Quellen und Nachführung