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>
116 lines
6.5 KiB
Markdown
116 lines
6.5 KiB
Markdown
# 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.
|