Hauptmenü und lokale Mod-Bibliothek
Dieser Backendvertrag gehört zur nativen Modern-UI-Umsetzung auf Basis
ab4a962. Schreibgeschützte Gestaltungsreferenz sind desktop/mod-library.js
und desktop/main-menu.js im privaten HTML-Goldstand, Revision
97c19979f10f190a87bbb93a06df397a8d3dae89. Proprietäre Inhalte werden nicht in
dieses Repository übernommen. Das Hauptmenü wählt eine Mod für das nächste
Spiel aus; die Aktivierung erzeugt keine Karriere und verändert keine Engine.
Ablage und Schnittstelle
UiModLibrary(portable_root) verwendet portable_root/mods/<name>/content.obw
und optional mod.json. Der Root-Parameter ist ausdrücklich die portable
Basis, nicht das Verzeichnis mods selbst. --ui-mods kann diese Basis für
isolierte Tests überschreiben. Neu installierte Modern-Mods besitzen ein Profil mit
Schema openbmh-mod@1.0. Classic-Mods bleiben für den vorhandenen 0.2-Launcher
streng content.obw-only; auch bestehende solche Verzeichnisse bleiben lesbar. UiModEntry.path bezeichnet immer den
Mod-Ordner, nicht die Paketdatei.
Die öffentliche API steht in src/modern/ui/mod_library.hpp:
snapshot()liefert Einträge, eine optionale aktive Verzeichnis-ID, Auswahl-Token und Bibliotheksfehler. Beschädigte Einträge bleiben als Fehlerzeilen erhalten. Eine beschädigte Profilbeschreibung verhindert keine sichere Entfernung des eigenen Datensatzes. Fremde oder nicht normalisierbare Namen blockieren nicht pauschal neue Importe.inspect(source,start_year)liefert einenModImportPlanmit geprüftem Namensvorschlag und Metadaten. Es wird noch keine Mod installiert, keine Bibliotheksauswahl geändert und kein echtes Nutzerverzeichnis angelegt.commit(plan,name,progress)veröffentlicht erst nach erneuter Quellprüfung ein vollständig vorbereitetes Verzeichnis. Öffentliche Plan-Metadaten dienen der Anzeige; maßgeblich bleibt der private unveränderliche geprüfte Plan.activate,deactivate,renameundremoveverlangen sowohl die konkrete Bibliotheksmitgliedschaft als auch aktuelle Datei- und Auswahl-Token.
Inspektion und Commit enthalten keine SDL-/RmlUI-Aufrufe. Die Oberfläche darf
sie in einem Hintergrundauftrag ausführen und währenddessen weitere
Mutationen sperren. Der optionale Fortschrittscallback liefert nur Text und
muss durch den UI-Besitzer sicher an dessen Hauptthread weitergereicht werden.
Ein explizites externes --mod ist ein vorübergehender Startoverride und wird
nicht als Bibliotheksmitglied oder persistierte Aktivierung ausgegeben.
Metadaten und unterstützte Quellen
Die Detaildaten sind type, source, version, file_count, bytes und
description. Art und Herkunft folgen den tatsächlich validierten Inhalten.
Ein importiertes mod.json darf Classic und Modern nicht gegeneinander
umdeklarieren. Die Dateianzahl und Bytes zählen die geprüften, entpackten
Paketinhalte; vor einer Originalkonvertierung beschreibt der Plan die
Originalquellensammlung. Interne Bibliotheksprofile gehören nicht zu dieser
Inhaltszahl.
Unterstützt werden OBW-/ZIP-Weltpakete mit einer Manifestdatei an der
Archivwurzel, entpackte Weltverzeichnisse und Mod-Verzeichnisse mit
content.obw. Der vorhandene editor::ArchiveStore prüft sichere Pfade,
Grenzen und komprimierte Einträge. Alle Payload-Einträge werden gelesen und
gehasht, nicht lediglich die Manifestdatei. Modern-Inhalte müssen durch den
vorhandenen Catalog lesbar sein und bekannte UI-Weltanforderungen erfüllen.
Unbekannte Profile oder eine Welt ohne von der UI-Demo unterstützten Verein
werden ausdrücklich zurückgewiesen. Das ist keine Zusage einer vollständigen
Modern-Engine-Ausführung.
Classic wird ausschließlich nach erfolgreichem content::open klassifiziert:
Das vorhandene Siegel, die exakten Inhaltshashes, der Classic-Adapter und die
unterstützte Ligastruktur bleiben verbindlich. Herkunft ist bei geprüften
deutschen Inhalten BMH, bei Football Limited FTLD; letzteres ist das
historische UI-Kürzel, während die echte Originaldatei FLTD.EXE heißt.
Originalordner und explizit gewählte BMH.EXE/FLTD.EXE werden mit
launch::check_game_directory geprüft. Nicht unterstützte Disketteneditionen,
unvollständige und mehrdeutige Installationen ergeben konkrete Fehler.
Die eigentliche Konvertierung verwendet unverändert
launch::ModLibrary::add/AddMod in einer isolierten temporären Bibliothek,
mit migrate=false. Nutzerspielstände, Einstellungen und Desktopdateien werden
nicht migriert. Nach vollständiger Prüfung wird nur das resultierende
content.obw in die echte Mod-Bibliothek übernommen.
Eine Quelle darf höchstens 512 MiB und 12.000 Dateien umfassen; die bestehenden strengeren Classic- und ArchiveStore-Grenzen gelten zusätzlich. Quell- und Mitgliedschaftstoken werden blockweise gebildet, damit ein großes Paket nicht als zusätzliche vollständige Kopie im RAM gehalten werden muss. Temporäre ArchiveStore-Snapshots und Konvertierungsordner werden beim Verwerfen des Plans beziehungsweise nach dem Vorgang entfernt. Eine ungefähr 1,6-GiB große Season-Sammlung liegt außerhalb dieses Bibliotheksimports und wird nicht stillschweigend als unterstütztes Ligaset übernommen.
Auswahl und Transaktionen
Ohne gespeicherte Auswahl ist keine Mod aktiviert. Import aktiviert niemals
automatisch den ersten oder zuletzt importierten Eintrag. Eine explizite
Auswahl steht atomar in .ui-active-mod.json; ihr Wert ist entweder genau
eine existierende gültige Verzeichnis-ID oder null. Fehlt eine referenzierte
Mod oder ist sie beschädigt, meldet snapshot() den Fehler und zeigt keine
falsche aktive Mod. Ein Neustart wählt keinen Ersatz aus.
Neue Namen besitzen höchstens 64 Unicode-Zeichen und 240 UTF-8-Bytes. Die Vergleichsregeln übernehmen die portable deutsche Casefold-Hilfe der Dateiverwaltung einschließlich Ö/ö, ß und zerlegter lateinischer Akzente. Zusätzlich gelten portable Dateinamensregeln: keine Schrägstriche, Doppelpunkte oder anderen Windows-Sonderzeichen, keine versteckten Namen, kein abschließender Punkt und keine reservierten Gerätenamen. Bestehende gültige 0.2-Namen bis 100 ASCII-Zeichen bleiben lesbar und können auf einen neuen kürzeren Namen umbenannt werden. Die dokumentierte Unicode-Normalisierungsgrenze des Dateianbieters bleibt bestehen.
Installieren veröffentlicht einen fertig geprüften Staging-Ordner mit einer einzigen abschließenden Umbenennung. Für Rename/Delete werden der Ordnerwechsel und die aktive Namensreferenz durch ein kleines Journal mit Auswahl-Nonce verbunden. Ein Fehler vor dem Auswahl-Commit stellt die bisherige Anordnung wieder her. Nach dem Commit wird ausschließlich aufgeräumt. Auch reine Groß-/Kleinschreibungsänderungen verwenden einen temporären Zwischennamen, damit das Verhalten auf Windows nicht vom Umbenennen auf denselben Pfad abhängt. Ein liegen gebliebenes Journal wird vor dem nächsten Bibliothekszugriff geprüft und soweit eindeutig wiederhergestellt. Unerwartete externe Änderungen führen zu einer ausdrücklichen Prüfmeldung; unbekannte Daten werden dabei nicht gelöscht.
Der eigene temporäre Schreib-Lock verhindert konkurrierende Anbietertransaktionen.
Ein nach einem Prozessabsturz verbliebener Lock wird nicht ungeprüft entfernt.
Symlinks innerhalb der verwalteten Mod-Struktur und verknüpfte Quellen werden
zurückgewiesen. Die vertrauenswürdige portable Basis wird kanonisiert, damit
gewöhnliche Betriebssystem-Basisaliase funktionieren. userdata hat einen
unabhängigen Lebenszyklus und bleibt bei Mod-Rename und Mod-Delete erhalten.
Prüfung
tests/modern_mods_ui_tests.cpp verwendet ausschließlich temporäre synthetische
Welten und den bereits öffentlichen künstlichen Classic-Testgenerator. Es
prüft Modern-/versiegelte Classic-Metadaten, 0/1-Auswahl über Neustarts,
Namenskonflikte, Mitgliedschaft, alte 0.2-Ordner, fehlerhafte Profile, geänderte
Quellen, Staging-Abbruch, IO-/Lock-Fehler, Symlinks und erhaltene Nutzerdaten.
Originalkonvertierungen mit tatsächlich proprietären Installationen gehören
ausschließlich in die private QA. Die Testquelle allein belegt weder einen
ausgeführten Build noch natives Plattformverhalten.
Native Oberfläche und Bedienung
Der native RmlUI-Client übernimmt das Hauptmenü mit sechs großen Textaktionen, Hover-/Fokuspfeil und zurückhaltender Versionsanzeige. Ohne aktive Mod bleibt Neues Spiel gesperrt. Das Netzwerk ist ein sichtbarer Platzhalter; Downloads führt in den zweiten Mod-Tab mit angekündigtem, gesperrtem Datenbankzugang.
Die Bibliothek zeigt die tatsächlich installierten Classic-/Modern-Pakete und ihre geprüften Metadaten. Auswahl aktiviert noch nichts. Aktivierung bleibt explizit und wird über Neustarts erhalten. Umbenennen und Löschen verwenden lokale Bestätigungen; beim Löschen der aktiven Mod gibt es keine automatische Ersatzwahl. Nutzerdateien bleiben getrennt erhalten.
Der Import bietet Originalordner, Paketdatei und Export-/Modordner. Nach Dateiauswahl folgt die asynchrone Prüfung, danach ein editierbarer Namensentwurf. Erst Importieren veröffentlicht das Paket. Auswahlabbruch und verworfene Namensentwürfe ändern die Bibliothek nicht. Während laufender Prüfung oder Übernahme sperrt der Client weitere Mutationen, Escape und Schließen; ein in-flight Abbruch wird nicht angeboten. Der vorhandene Classic-Konverter wird wiederverwendet und verändert keine Originaldateien. Inspektion, Konvertierung und Veröffentlichung laufen ohne SDL-/RmlUI-Zugriffe im Worker.
--ui-mods <portable Basis> isoliert eine Bibliothek mit ihrem Unterordner
mods/; --ui-mod-import <Quelle> ersetzt ausschließlich die explizite
OS-Dateiauswahl für QA. Das JSONL-Skript wartet mit front-wait auf denselben
normalen Abschlussweg wie die interaktive Anwendung. Es injiziert keine
Bibliothekszustände.
Ein explizites --mod ist eine temporäre externe Welt und wird nicht als
installierte oder dauerhaft aktivierte Mod dargestellt. Neues Spiel einer
Classic-Mod startet weiter den vorhandenen Classic-Client; die zugehörige
Spielstandauswahl bleibt ebenfalls dort. Modern verwendet weiterhin den
getrennten UI-Datenanbieter. Die echte Engine wird nicht geändert und Anstoß
bleibt ohne Aktion. Die eigentliche Bildschirm-/Audioanbindung und das größere
Stadionperipherie-Redesign gehören nicht zu diesem Paket.
Private Vorher-/Nachherbilder, UI-Zustände, synthetische Importfixtures und
Eingabeskripte liegen in
bmh_4k_ui/docs/qa/front-mods-batch-2026-10-26/. Gold enthält eine fiktive
mitgelieferte Beispielmod; die native frische Liste bleibt wegen der getrennten
Nutzerdaten leer. Gold sammelt Originalbytes nur lokal für den POC, während der
native Client den bestehenden tatsächlichen Converter verwendet. Das ist eine
ausdrückliche Datenstrecken-Abgrenzung, keine Behauptung identischer Engine-
funktionalität.
Prüfung
Die lokale Meilenstein-Suite umfasst 35 bestandene Tests. Synthetische
Referenzpakete lassen sich reproduzierbar über
modern_mods_ui_tests --write-fixtures <leeres Verzeichnis> erzeugen; dabei
wird keine Engine gestartet. Der unabhängige UI-Lauf besteht auf seiner
zugeordneten Runtime 132 Prüfungen in neun Prozessen (darunter zwei Neustarts).
Die neue Kompatibilitäts-/Coverkohorte wird getrennt dokumentiert. Native
Bild- und Bedienungstests laufen unter Linux/OpenGL; die Plattform-CI baut
und prüft synthetisch, ersetzt aber keine Windows-/macOS-Spielabnahme.
Spieleinstieg
Grundeinstellungen, Managerwahl, Entwürfe und Bestätigungen sind im separaten Einstiegsvertrag beschrieben.