Files
Dreierpack-Manager/docs/new_engine/datenformat.md
T
ClaudeandClaude Opus 5.5 d856000780 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>
2026-10-23 16:09:53 +02:00

6.5 KiB
Raw Blame History

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 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:

{
  "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.