17 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 | Engine: lädt runtime:modern-v1 und vorerst auch editor:world-v1; lehnt Classic-Pakete ab |
| F2 | Ligen | Größe je Liga frei (12–20), Generator je Liga | M2 | Engine: Größe je Liga umgesetzt; Generator vorerst Tabelle passender Größe |
| F3 | Kalender | Ligatermine als Datumsliste | M2 | Engine-Funktion umgesetzt; Anbindung an den Weltlader mit M3 |
| F4 | Trainingslager | Katalog mit Karte und X/Y-Lage, Ort, Bild, Qualität 0–6 | M4 | Engine: liest den erweiterten Katalog; ohne Katalog gilt die eingebaute Vorgabe (18 Lager) |
| F5 | Namen | Vor- und Nachname Pflicht, UTF-8 | M3 | Engine: gelesen, in ModernState |
| F6 | Kader | bis 24 Plätze je Verein, Mindestgröße | M3 | Engine: 24 Plätze je Ligaverein; mehr als 24 Spieler werden abgelehnt |
| F7 | Finanzen | Finanzangaben für Vereine ohne Classic-Startregel | M5 | geplant |
| F8 | Spielstand | save_profile: modern-career-v1 |
M6 | Engine erledigt: Spielstand nennt seine Welt (ID, Revision), enthält nur die Karriere |
| F9 | Schiedsrichter | eigener Schiedsrichter-Pool der Welt, mehr als 49 | M5 | Engine erledigt (Pool aus staff, neu: perception); Daten folgen mit 1.4 |
| F10 | Almanach | alle gespielten Spiele im Spielstand (history/…) |
M8 | Engine erledigt (Aufzeichnung, Spielstand); UI offen |
| F11 | Nationen | jede Spielernation mit eindeutiger ID und, wo vorhanden, Original-Index | 1.5 | Engine erledigt (Index 0–63); Daten: zwei doppelte Nationen zusammenführen |
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. - Editor-Kompatibilität: Öffnen und verlustfreies Speichern von
editor-world-v1mitx-editor.playable: trueist erlaubt, wennrequiressowohleditor:world-v1als auchruntime:modern-v1enthält. Eine gleichzeitige Classic-Laufzeitanforderung ist ungültig. Reine Editorwelten behalten die bisherige Zulassung mitplayable: false. - Die Editorprüfung deckt außerdem die Modern-Felder aus F4 und F9 ab. Sie ersetzt noch keine vollständige Engine-Spielbarkeitsprüfung für F2/F3/F5/F6; ein neuer GUI-Schalter zur Freigabe ist damit nicht umgesetzt. Eine fehlende Finanzzeile für zusätzliche Vereine bleibt nach F7 zulässig.
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.- Stand 0.3: Die Engine spielt jede Liga mit der Spielplantabelle ihrer Größe (
rule:legacy-fixtures, 12–20 Teams).round-robinwird gelesen, aber noch wie die gleich große Tabelle behandelt; nur die Reihenfolge der Paarungen unterscheidet sich. Ein eigener Round-Robin-Generator folgt bei Bedarf. - 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 in die Engine eingebaute Vorgabe (
src/modern/game/training_camps.cpp) mit den 18 fiktiven Lagern. - Exklusiv-Sponsor (optional, neu 25.10.2026):
sponsor_chance(Prozent je Aufenthalt, 0–100; 0 = keiner),sponsor_bonus(Betrag in Prozent des besten regulären Angebots, 100–500, Standard 150),sponsor_months(Laufzeit 1–60, Standard 12). Fehltsponsor_chance, gelten die eingebauten Werte des Lagers mit derselben ID (Doha 15, Abu Dhabi 30, Dubai 45), sonst keine Chance. Siehe Trainingslager. - 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, optionales datensatzspezifisches Bild und die drei Sponsor-Felder. 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. - Anders als ein Classic-Spielstand enthält ein Modern-Spielstand nicht die Welt (sie ist samt HD-Bildern mehrere hundert MB groß). Das Manifest nennt sie unter
world(id,data_revision,title); geladen wird nur mit genau dieser Welt. - Einträge:
state/career.json(Spielzustand),state/modern.json(Schemamodern-state@1.1: Vereins- und Spieler-IDs, UTF-8-Namen, Nationen je Laufzeit-Index, Liga-IDs, Zähler neuer Spieler-IDs),history/…(Almanach, F10),state/rng.json,state/driver.json,state/session.json,state/information.json,state/integrity.json. Rund 210 KB. - Ändert sich die Datenrevision, passt ein alter Spielstand nicht mehr; eine Spielstand-Migration ist noch nicht vorgesehen.
- Editor: öffnet keine Spielstände; keine Änderung.
F9 · Schiedsrichter
- Heute kommen die 49 Schiedsrichter (plus Platzhalter 0) aus der Original-Datenbank: Namen im Namenspool, je ein Eigenschaftsbyte (
RefereeProperties). Pro Spieltag erhält jedes Spiel einen noch freien Schiedsrichter. Mit den vergrößerten internationalen Ligen gibt es Tage mit bis zu 84 Ligaspielen; die Engine lässt deshalb vorübergehend Doppeleinsätze zu. - Die Welt führt Schiedsrichter schon heute als
staff-Zeilen mitrole: referee(Revision 1.3: die 50 Originale mitx-legacy.referee_index0–49 undx-legacy.property, dem Original-Eigenschaftsbyte). - Das Eigenschaftsbyte hat zwei Werte, die die Spiele beeinflussen:
perception(Bits 0–1, 0–3): Abseits-Entscheidungen und übersehene Fouls;strictness(Bits 3–4, 0–3): Karten.
- Neue Schiedsrichter (ab Revision 1.4):
staff-Zeilen ohnex-legacy, Pflichtfelder sindid,nameundrole: referee. Dazuattributes.strictnessundattributes.perception(je 0–3, fehlend = 1); eine Nation ist optional. Sie folgen in Tabellenreihenfolge auf die Originale (Index 50, 51, …), höchstens 255 insgesamt. Die Originale behalten ihr Eigenschaftsbyte ausx-legacy.property. - Empfehlung: mindestens 100 Schiedsrichter, damit auch Tage mit Pokalspielen ohne Doppeleinsatz auskommen.
- Engine: erledigt.
- Die Poolgröße kommt aus der Welt.
- Namen gehen in den Namenspool (Einzelbyte-Kodierung wie bei den Vereinen), das Eigenschaftsbyte ist
strictness << 3 | perception. - Ein Doppeleinsatz ist nur noch der Rückfall, wenn der Pool erschöpft ist.
- Ein Spielstand passt nur zu einer Welt mit gleich vielen Schiedsrichtern.
- Test ohne neuen Datensatz:
MODERN_EXTRA_REFEREES=N modern_season_sim ….
- Editor: Schiedsrichterliste anzeigen und bearbeiten (Name, Nation, Strenge, Wahrnehmung), neue Schiedsrichter anlegen; Prüfung auf eindeutige IDs, Werte 0–3 und höchstens 255 Schiedsrichter.
F10 · Almanach
- Ein Modern-Spielstand enthält alle gespielten Spiele der Karriere:
history/season-<Jahr>.binje abgeschlossener Saison (unveränderlich) undhistory/current.binfür die laufende. Beschreibung: Almanach. state/modern.json(Schema jetztmodern-state@1.1) bekommt dazuleague_ids,league_namesundgenerated_players(Zähler der neu vergebenen Spieler-IDsplayer:gen-<n>).- Die Integritätsprüfung deckt
history/mit ab. - Editor: keine Änderung (öffnet keine Spielstände). Eine Welt muss nichts liefern; sinnvoll sind stabile Vereins- und Spieler-IDs, die sich zwischen Datenrevisionen nicht ändern.
F8 · Optionale Managerdarstellung (29.10.2026)
Der Modern-Sessionkontext (state/session.json, vorhandenes Schema
classic-session@1.0) darf zusätzlich die bis zu vier bekannten flüchtigen
PlanTicketPrice-Bytes enthalten, wenn sie nicht im serialisierten Speicherblock
liegen. Der Leser prüft ihre ursprüngliche Preisgrenze 0–25; die bisherigen
Pflichtadressen und Duplikat-/Unbekannt-Prüfungen bleiben erhalten. Das behebt
#26, ohne Classic oder die Byteanordnung der Spielwerte zu verändern.
Editor: keine Anpassung; der Editor liest keine Karriere-/Sessiondateien.
Das Postfach darf außerdem news_marks speichern: eine Map kanonischer
Manager-IDs auf Nachrichten-IDs und deren UI-Bits (1 gelesen, 2 Papierkorb).
Fehlende Markierungen bedeuten ungelesen/im Posteingang; leere Besitzermaps
werden nicht für wirkungslose Aktionen angelegt. Das Archivieren bleibt das
vorhandene Behalten-Bit des Originalpostfachs. Die eigentliche Nachricht wird
beim Verschieben in den Papierkorb nicht aus dem Spielstand entfernt.
Ältere Spielstände ohne die optionale Map bleiben lesbar.
Editor: keine Welt-/Editoränderung; der Editor öffnet keine Karriere-OBS.
state/modern.json darf zusätzlich manager_presentations enthalten: eine Liste
mit {id, name, portrait_style}. id ist die stabile Manager-ID, name der
kanonische UTF-8-Anzeigename, portrait_style ist photo oder painted.
Fehlt die Liste, bleiben die bisherigen Originalnamen/Fotoansichten maßgeblich.
Die Einträge ändern keine Spielregeln oder Manageridentitäten. Die bestehenden
Originalrecords bleiben vollständig erhalten; das Feld mit 24 Originalbytes
ist keine UTF-8-Speichergrenze für die Modern-Anzeige. Native UI und neu erzeugte
Almanach-Managernamen bevorzugen die optionale Darstellung. Bereits archivierte
Namen werden nicht rückwirkend geändert.
Spielstände mit Managerdarstellungen verwenden modern-state@1.2, damit ältere
Programme diese Angaben nicht unbemerkt beim erneuten Speichern verlieren. Ohne
Managerdarstellungen bleibt der Writer bei modern-state@1.1; der neue Reader
akzeptiert beide Versionen. Weltformat und Original-Spielstände bleiben unverändert. Doppelte/ungültige IDs, leere/überlange Namen
oder unbekannte Darstellungsarten werden abgewiesen. Editor: keine Änderung,
da der Welteditor keine Karriere-Spielstände bearbeitet.
F11 · Nationen
- Die Nationalität eines Spielers hat in der Engine sechs Bit (Original:
w368Bits 27–31 plus Bit 7 vonPlayerBonuses, also 0–63); die Original-Nationen haben die Indizes 0–61 (x-legacy.nationality_index). Die Engine vergleicht Nationalitäten nur (deutsch oder ausländisch, gleiche Nation, Regionen bei Transfers), sie nutzt sie nicht als Tabellenindex. - Engine erledigt (25.10.2026): Spieler aus Nationen mit Index 32–61 (Brasilien, Argentinien, USA, Japan …) bekamen bisher die Ausweich-Nationalität 31 (Wales); jetzt den richtigen Index samt Bit 7. Nationen ohne Original-Index erhalten 63 (keine Nation, keine Nationalmannschaft). Datensatz 1.4: 80 Spieler ohne Original-Index (vorher 223).
- Daten erledigt (Revision 1.5, 25.10.2026): Die doppelten Länder sind zusammengeführt. Die Spieler von
nation:tr(2) undnation:ci(13) und das Lager Belek zeigen jetzt aufnation:x-legacy-8(Türkei) bzw.nation:x-legacy-59(Elfenbeinküste); 97 Nationen, 65 Spieler ohne Original-Index. Geprüft mit einer Saison samt Speicherprüfung. - Offen: Die Platzhalter-IDs
nation:x-legacy-8/-59/-60(Südkorea) sollten später ISO-IDs werden (nation:tr,nation:ci,nation:kr); IDs bleiben dabei stabil, wenn die Platzhalter als Alias erhalten bleiben. - Die übrigen 65 Spieler kommen aus Nationen, die das Original nicht kennt (Mali, Georgien, Island …); für sie ist 63 richtig, solange die Engine keine eigenen Nationalmannschaften dafür hat.
- Editor: Prüfung auf doppelte Nationen (gleicher Name oder gleicher Index), auf Spielernationen ohne Eintrag in
nations.jsonund auf Indizes außerhalb 0–63.
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.