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 <noreply@anthropic.com>
This commit is contained in:
ClaudeandClaude Opus 5.5 committed 2026-10-23 16:09:53 +02:00
1 parent d8ccf7b364
commit d856000780
5 files changed
+129 -8

No files matched your search

+1
View File
@@ -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.
+1
View File
@@ -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
+115
View File
@@ -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:<n>` 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:<n>` 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-<n>`) 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.
+10 -6
View File
@@ -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
+2 -2
View File
@@ -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/<id>/crest`, `asset:player/<id>/photo`, `asset:comp/<id>/trophy`, `asset:camp/<id>/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/<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.
- Texte aus der Engine (Post, Meldungen) kommen als fertige UTF-8-Zeichenketten in der gewählten Sprache.
## Verzeichnisaufteilung