7.7 KiB
7.7 KiB
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 und das Editor-Profil editor-v1.
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 Karte und X/Y-Lage, 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 mitruntime:modern-v1darfx-editor.playable: truehaben, 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
requiresundplayableerst nach erfolgreicher Modern-Prüfung; Entfernen setzt beides zurück. Die bisherige Bedingungplayable == falsegilt nur noch für Welten ohneruntime:modern-v1.
F2 · Ligen
competitions[].stages[].teamsdarf je Liga zwischen 12 und 20 liegen; die Mitgliederliste (members),teamsund die Teams der Slots müssen übereinstimmen.generator:round-robinfür jede Größe;legacy:<n>nur, wennrule:legacy-fixtureseine Tabelle für genaunTeams hat.- Spieltage einer Liga:
2 × (teams − 1)beilegs: 2. - Die Classic-Zusatzfelder
x-legacy.league_index,calendar_bit,relegation_places,europe_placesbleiben 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,teamsund Slots nicht übereinstimmen.
F3 · Kalender
- Ligen verweisen über
matchdaysauf einen Kalender. Neben den Classic-Verweisen (calendar:legacy-league-<n>) ist ein Kalender mit expliziter Datumslistedateserlaubt, 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:
{
"id": "rule:training-camps",
"type": "training_camps",
"maps": [
{"id": "map:de", "name": {"default": "Deutschland"}},
{"id": "map:eu", "name": {"default": "Europa"}},
{"id": "map:me", "name": {"default": "Naher Osten"}}
],
"resorts": [
{
"id": "resort:4",
"base_price": 485000,
"quality": [4, 4, 4, 4],
"map": "map:eu",
"x": null,
"y": null,
"name": {"default": "Sportzentrum Groningen"},
"place": {"default": "Groningen"},
"country": "nation:nl"
}
]
}
id,base_price,qualitywie bisher;qualityin der Reihenfolge Platz, Fitness, Verpflegung, Unterkunft, je 0–6 (Classic: 1–5).- Karte und Lage: Jedes Lager trägt immer
map(Verweis aufmaps) sowiexundyals ganzzahlige Koordinaten auf dieser Karte. Das Koordinatensystem einer Karte legt die Oberfläche fest; solange es nicht feststeht, sindxundynull. Sobald die GUI die Kartenmaße liefert, bekommt jede Karte zusätzlichwidthundheight(Ursprung oben links), undx/ymü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. 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.
imageist 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. - Die IDs
resort:0bisresort:17entsprechen 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.jsonmit 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 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 fehlendesimageist kein Fehler; feste GUI-Motive müssen nicht in den Datensatz kopiert werden.
F5 · Namen
- Spieler haben in Modern genau
name.firstundname.last(UTF-8, NFC); ein zusammengesetzter Anzeigename wird nicht gespeichert. - Vereine:
nameundshortals 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
.obsmitsave_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:
requiresruntime:modern-v1enthält und alle Verweise auflösbar sind,- höchstens 32 Ligen bestehen, jede mit 12–20 Vereinen und passendem Generator und Kalender (F2, F3),
- jeder Ligaverein die Kaderregeln erfüllt (F6),
- jeder Spieler Vor- und Nachname hat (F5),
- 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.