Files

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 einen ModImportPlan mit 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, rename und remove verlangen 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.

Nachtstand 26./27. Oktober 2026: Büro-Hauptmenü

Das HTML-Hauptmenü verwendet die transparente Navigation der Studie4832d248. Die sechs vorhandenen Funktionen bleiben Neues Spiel, Laden, Netzwerk (gesperrt), Mod, Einstellungen und Beenden. Die aktive Mod steht dezent unten. Die große OpenBMH-Überschrift entfällt. Das Vereinsbüro ist Vorgabe; die alternative Trophäenbüro-Studie bleibt in der privaten HTML-Vorschau erhalten.

Die RmlUI-Fassung übernimmt Anordnung, Menüflächen und Navigation in front_screens.inc und front.rcss. Das feste Bild wird als GUI-Ressource menu.club-office geladen, nicht aus dem Weltpaket. Ältere GUI-Ressourcensätze ohne diesen neuen Schlüssel behalten ihren vorhandenen Hintergrund; es wird kein Bild aus fremden Weltassets erraten. Die getrennte Vorbereitung kann zusätzlich menu.trophy-office führen. Das Almanach-SVG bleibt mit seinem Ball innerhalb des Buchdeckels.

HTML-Bedienprüfungen und tatsächliche Bilder liegen im privaten Repository unter docs/qa/night-ui-2026-10-27/main-menu. Der native Build-/Sichtnachweis folgt nach Integration des zeitgleich überarbeiteten Karrierepakets; dieser Eintrag behauptet noch keine native Abnahme.