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:
1 parent
d8ccf7b364
commit
d856000780
5 files changed
+129
-8
No files matched your search
@@ -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.
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user