From d85600078050b16ab61ee15be015cbc72a8e77f3 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 23 Oct 2026 16:09:51 +0200 Subject: [PATCH] Document the OBW changes of the Modern engine for the editor New docs/new_engine/datenformat.md lists format changes F1-F8 (modern runtime requirement, league sizes and generators, date-list calendars, extended training camp rule, names, squads, finances, saves) with the editor work each needs and the shared Modern validation rules. Co-Authored-By: Claude Opus 5.5 --- docs/new_engine/AGENTS.md | 1 + docs/new_engine/README.md | 1 + docs/new_engine/datenformat.md | 115 ++++++++++++++++++++++++++++ docs/new_engine/trainingslager.md | 16 ++-- docs/new_engine/ui-schnittstelle.md | 4 +- 5 files changed, 129 insertions(+), 8 deletions(-) create mode 100644 docs/new_engine/datenformat.md diff --git a/docs/new_engine/AGENTS.md b/docs/new_engine/AGENTS.md index 202dfde..eba0e4c 100644 --- a/docs/new_engine/AGENTS.md +++ b/docs/new_engine/AGENTS.md @@ -6,6 +6,7 @@ - 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. diff --git a/docs/new_engine/README.md b/docs/new_engine/README.md index c7c6709..6fd98b8 100644 --- a/docs/new_engine/README.md +++ b/docs/new_engine/README.md @@ -11,6 +11,7 @@ Grundlage ist der [Engine-Split](../ENGINE_SPLIT.md); die Oberfläche ist in | [Phasen](phasen.md) | Arbeitsschritte M0–M7 mit Abnahmekriterien | | [Befund](befund.md) | Feste Classic-Größen im Code, die Modern auflösen muss | | [Trainingslager](trainingslager.md) | Katalog, Preis, Wirkung und die neue 6-Sterne-Stufe | +| [Datenformat](datenformat.md) | **Formatänderungen für Engine und Editor** (F1–F8) | | [Agentenregeln](AGENTS.md) | Arbeitsregeln für diesen Bereich | ## Ziel diff --git a/docs/new_engine/datenformat.md b/docs/new_engine/datenformat.md new file mode 100644 index 0000000..32b5aec --- /dev/null +++ b/docs/new_engine/datenformat.md @@ -0,0 +1,115 @@ +# Datenformat · Änderungen für die Modern-Engine + +Stand: 23. Oktober 2026. Hier steht jede Änderung am OBW-Format, die die +Modern-Engine einführt oder voraussetzt. **Der Editor muss jede Zeile mit +„Editor“ nachziehen**: anzeigen, bearbeiten und prüfen. Grundlage ist das +Format [OBW](../formats/OBW.md) und das Editor-Profil +[editor-v1](../formats/obw/editor-v1.md). + +Status: *geplant* (noch nicht in der Engine), *umgesetzt* (Engine liest/prüft es). + +## Übersicht + +| Nr. | Bereich | Änderung | Phase | Status | +|---|---|---|---|---| +| F1 | Manifest | Laufzeit `runtime:modern-v1`, spielbare Modern-Welt | M3 | geplant | +| F2 | Ligen | Größe je Liga frei (12–20), Generator je Liga | M2 | geplant | +| F3 | Kalender | Ligatermine als Datumsliste | M2 | geplant | +| F4 | Trainingslager | Katalog mit Region, Ort, Bild, Qualität 0–6 | M4 | geplant | +| F5 | Namen | Vor- und Nachname Pflicht, UTF-8 | M3 | geplant | +| F6 | Kader | bis 24 Plätze je Verein, Mindestgröße | M3 | geplant | +| F7 | Finanzen | Finanzangaben für Vereine ohne Classic-Startregel | M5 | geplant | +| F8 | Spielstand | `save_profile: modern-career-v1` | M6 | geplant | + +## F1 · Manifest + +- Eine Modern-Welt trägt `"requires": ["runtime:modern-v1"]`. Die Modern-Engine lädt nur solche Welten; Classic lehnt sie ab. +- Das Editor-Profil bleibt `editor-world-v1`. Neu: Eine Welt mit `runtime:modern-v1` darf `x-editor.playable: true` haben, wenn sie die Modern-Prüfung (unten) besteht. +- Die Datenrevision steht weiter in der Erweiterung des Datensatzes (z. B. `data_revision`). +- **Editor:** Schalter „Als Modern-Welt spielbar machen“ setzt `requires` und `playable` erst nach erfolgreicher Modern-Prüfung; Entfernen setzt beides zurück. Die bisherige Bedingung `playable == false` gilt nur noch für Welten ohne `runtime:modern-v1`. + +## F2 · Ligen + +- `competitions[].stages[].teams` darf je Liga zwischen 12 und 20 liegen; die Mitgliederliste (`members`), `teams` und die Teams der Slots müssen übereinstimmen. +- `generator`: `round-robin` für jede Größe; `legacy:` nur, wenn `rule:legacy-fixtures` eine Tabelle für genau `n` Teams hat. +- Spieltage einer Liga: `2 × (teams − 1)` bei `legs: 2`. +- Die Classic-Zusatzfelder `x-legacy.league_index`, `calendar_bit`, `relegation_places`, `europe_places` bleiben und werden in 0.3 weiter gelesen. +- **Editor:** Größe zwischen 12 und 20 zulassen; Generator `legacy:` nur anbieten, wenn die Tabelle existiert; Warnung, wenn Mitglieder, `teams` und Slots nicht übereinstimmen. + +## F3 · Kalender + +- Ligen verweisen über `matchdays` auf einen Kalender. Neben den Classic-Verweisen (`calendar:legacy-league-`) ist ein Kalender mit expliziter Datumsliste `dates` erlaubt, wie er für die vier vergrößerten internationalen Ligen bereits vorliegt. +- Die Anzahl der Daten muss der Zahl der Spieltage entsprechen; Daten liegen aufsteigend innerhalb der Saison und nicht auf demselben Tag zweimal. +- Die Engine bildet die Daten auf Spieltage des Classic-Saisonablaufs ab; ein Datum, das dort kein möglicher Ligaspieltag ist, verschiebt sich auf den nächsten möglichen Tag (Hinweis im Ladeprotokoll). +- **Editor:** Datumsliste anzeigen und bearbeiten; Anzahl gegen die Spieltage prüfen. + +## F4 · Trainingslager + +Die bestehende Regel `rule:training-camps` (Typ `training_camps`) bleibt und wird erweitert: + +```json +{ + "id": "rule:training-camps", + "type": "training_camps", + "regions": [ + {"id": "de", "name": {"default": "Deutschland"}}, + {"id": "eu", "name": {"default": "Europa"}}, + {"id": "me", "name": {"default": "Naher Osten"}} + ], + "resorts": [ + { + "id": "resort:4", + "base_price": 485000, + "quality": [4, 4, 4, 4], + "region": "eu", + "name": {"default": "Sportzentrum Groningen"}, + "place": {"default": "Groningen"}, + "country": "nation:nl", + "position": {"lat_e6": 53219400, "lon_e6": 6566500}, + "image": "asset:camp/4/image" + } + ] +} +``` + +- `id`, `base_price`, `quality` wie bisher; `quality` in der Reihenfolge Platz, Fitness, Verpflegung, Unterkunft, je **0–6** (Classic: 1–5). +- Neu und für Modern Pflicht: `region` (Verweis auf `regions`), `name`, `place`, `country`, `position` (Millionstel Grad als Ganzzahlen), `image` (Asset-Schlüssel). +- 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:** Liste der Lager mit Region, Karte bzw. Koordinaten, vier Qualitätswerten (0–6), Preis und Bild bearbeiten; Prüfung auf eindeutige IDs, gültige Region und Nation, Qualitäten im Bereich. + +## F5 · Namen + +- Spieler haben in Modern genau `name.first` und `name.last` (UTF-8, NFC); ein zusammengesetzter Anzeigename wird nicht gespeichert. +- Vereine: `name` und `short` als lokalisierbare Texte mit Groß- und Kleinschreibung. +- Die Classic-Namensfelder im Archiv bleiben unverändert als Quelle erhalten; die Modern-Engine liest sie nicht. +- **Editor:** besteht bereits (Datenrevision 1.2); für Modern-Welten Pflichtprüfung „Vorname und Nachname vorhanden“. + +## F6 · Kader + +- Jeder Ligaverein hat höchstens 24 Kaderplätze; die Reihenfolge (`squad_order`) bleibt maßgeblich. +- Mindestens 14 Spieler je Ligaverein, davon mindestens ein Torwart. +- **Editor:** Warnung bei mehr als 24 oder weniger als 14 Spielern beziehungsweise ohne Torwart. + +## F7 · Finanzen + +- In 0.3 übernimmt der Mensch nur deutsche Vereine; deren Startfinanzen entstehen weiter aus der Classic-Startregel. +- Vereine ohne Finanzzeile (etwa die neuen internationalen Vereine) bleiben gültig. Eine Finanzzeile für sie wird erst nötig, wenn sie wählbar werden; das Format dafür wird dann hier ergänzt. +- **Editor:** vorerst keine Änderung. + +## F8 · Spielstand + +- Modern-Spielstände sind `.obs` mit `save_profile: modern-career-v1`; Aufbau wie Classic-Spielstände (`state/…`, Integritätsdatei), aber mit dem Modern-Zustand und den Dimensionen der Welt. +- **Editor:** öffnet keine Spielstände; keine Änderung. + +## Modern-Prüfung (Engine und Editor) + +Eine Welt ist als Modern-Welt spielbar, wenn: + +1. `requires` `runtime:modern-v1` enthält und alle Verweise auflösbar sind, +2. höchstens 32 Ligen bestehen, jede mit 12–20 Vereinen und passendem Generator und Kalender (F2, F3), +3. jeder Ligaverein die Kaderregeln erfüllt (F6), +4. jeder Spieler Vor- und Nachname hat (F5), +5. Trainingslager vollständig sind, sofern die Regel vorhanden ist (F4). + +Die Engine meldet Verstöße mit Datei, Pfad und Regel; der Editor zeigt dieselben Meldungen. diff --git a/docs/new_engine/trainingslager.md b/docs/new_engine/trainingslager.md index d0ea018..4204242 100644 --- a/docs/new_engine/trainingslager.md +++ b/docs/new_engine/trainingslager.md @@ -24,24 +24,28 @@ Der Katalog steht im Modern-Datensatz unter `rules.training_camps`. Fehlt er, gilt die öffentliche Vorgabe `assets/modern/rules/training_camps.json` mit den 18 fiktiven Lagern der Oberfläche. +Der Katalog erweitert die bestehende Regel `rule:training-camps` (Liste +`resorts`); das genaue Format und die Aufgaben für den Editor stehen in +[Datenformat F4](datenformat.md#f4--trainingslager). Ein Eintrag: + ```json { - "id": "camp:04", + "id": "resort:4", + "base_price": 485000, + "quality": [4, 4, 4, 4], "region": "eu", "name": {"default": "Sportzentrum Groningen"}, "place": {"default": "Groningen"}, "country": "nation:nl", "position": {"lat_e6": 53219400, "lon_e6": 6566500}, - "quality": {"pitch": 4, "fitness": 4, "catering": 4, "lodging": 4}, - "base_price": 485000, - "image": "asset:camp/04/image" + "image": "asset:camp/4/image" } ``` +- `quality`: Platz, Fitness, Verpflegung, Unterkunft, je 0–6. - `region`: `de` (Deutschland), `eu` (übriges Europa), `me` (Naher Osten). - `position`: Breite und Länge in Millionstel Grad als Ganzzahlen, weil der JSON-Leser der Laufzeit keine Gleitkommazahlen kennt. -- `quality`: je 0–6; die Reihenfolge in der UI ist Platz, Fitness, Verpflegung, Unterkunft. -- Die numerischen IDs 0–17 der Oberfläche bleiben als `camp:00` bis `camp:17` erhalten und werden nicht neu sortiert. +- Die IDs `resort:0` bis `resort:17` entsprechen den IDs 0–17 der Oberfläche und werden nicht neu sortiert. - Preis, Grenzen und Schwerpunkte bleiben wie in Classic. ## Die 6-Sterne-Stufe diff --git a/docs/new_engine/ui-schnittstelle.md b/docs/new_engine/ui-schnittstelle.md index 17e78e3..9a335f8 100644 --- a/docs/new_engine/ui-schnittstelle.md +++ b/docs/new_engine/ui-schnittstelle.md @@ -8,8 +8,8 @@ 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:…`, `camp:…`), nicht Laufzeitindizes. -- Bilder werden über Asset-Schlüssel referenziert (`asset:club//crest`, `asset:player//photo`, `asset:comp//trophy`, `asset:camp//image`). Auflösung und Rückfallbilder (Silhouette, generisches Wappen) übernimmt die UI über das Asset-Verzeichnis des Datensatzes. +- Identitäten sind die stabilen OBW-IDs (`club:…`, `player:…`, `comp:…`, `resort:…`), nicht Laufzeitindizes. +- Bilder werden über Asset-Schlüssel referenziert (`asset:club//crest`, `asset:player//photo`, `asset:comp//trophy`, `asset:camp//image`). Auflösung und Rückfallbilder (Silhouette, generisches Wappen) übernimmt die UI über das Asset-Verzeichnis des Datensatzes. - Texte aus der Engine (Post, Meldungen) kommen als fertige UTF-8-Zeichenketten in der gewählten Sprache. ## Verzeichnisaufteilung