Files
Dreierpack-Manager/docs/new_ui/desktop/settings/README.md
T

102 lines
5.9 KiB
Markdown

# Einstellungen und Automatik
Stand: 25. Oktober 2026, native RmlUI-Umsetzung auf `0.3`.
Referenz ist der private HTML-Desktop mit `settings-menu.js` und
`settings-window.css` aus dem unveränderten Goldstand `197ac08c`.
## Darstellung und Bedienung
Vier Kategorien teilen sich die linke Navigation: Anzeige, Sound, Spiel und
Automatik. Im Hauptmenü stehen nur Anzeige und Sound zur Verfügung. Die
Fenstergröße und alle drei Paletten folgen den übrigen Untermenüs. Drei
unterschiedliche Miniaturdesktops zeigen die Gestaltungsvarianten; erst
„Anwenden“ ändert das tatsächliche Theme und schließt das Fenster.
Anzeige enthält Modus, fünf Beispielauflösungen, Skalierung und Sprache.
Deutsch ist aktiv; Englisch bleibt bis zur Übersetzung sichtbar und gesperrt.
Modus, Auflösung und Skalierung sind wie im POC gespeicherte UI-Auswahlen;
sie konfigurieren derzeit noch nicht das SDL-Fenster. Sound enthält Lautstärke,
Effekte und Effektstil sowie im Desktop die drei vorhandenen Spieltonoptionen.
Die Anbindung an Audioausgabe und Musik ist ein späterer Integrationsschritt.
Spiel bietet **142 Optionen in zehn Abschnitten**. Eine Suche berücksichtigt
mehrere Suchwörter, Abschnitts- und Wettbewerbsnamen sowie deutsche Umlaute
und ß. Die Abschnittsauswahl springt in den scrollbaren Optionsbereich;
leere Trefferlisten werden ausdrücklich angezeigt. Zahlenwerte nutzen die
vorhandene gemeinsame Zahleneingabe mit Feldgrenzen und Vorschlagswerten.
Die Kartenfarbe hat vier Auswahlwerte. Zusammen mit den drei Tonoptionen
werden 145 der 180 vorhandenen Optionszellen angezeigt; die übrigen Zellen
bleiben erhalten.
Automatik umfasst Aufstellung, Auswechslungen, Taktik, Manndeckung und Training.
Der Hauptschalter zeigt bei gemischter Auswahl einen Zwischenzustand. Training
schaltet bei Übernahme die vier Automatikgruppen der Trainingsansicht gemeinsam;
eine einzeln abgeschaltete Trainingsgruppe hebt umgekehrt die gemeinsame
Trainingsautomatik auf. Die eigentliche Planung übernimmt später die Engine.
Alle Kategorien bearbeiten denselben lokalen Entwurf. Kategorienwechsel und
Suche behalten die Eingaben. „Abbrechen“, Schließen und Escape verwerfen sie;
„Anwenden“ ist nur bei gültigen Änderungen aktiv. Tab und Umschalt-Tab führen
durch die sichtbaren Elemente, Pfeile navigieren zwischen den Kategorien.
Ein geöffnetes Auswahlmenü verarbeitet seine eigenen Tasten zuerst.
## Daten und spätere Engine-Anbindung
Anzeige, Theme und Sound werden atomar in
`userdata/modern-ui-preferences.json` neben der Anwendung gespeichert. Diese
Datei gilt unabhängig vom geladenen OBW und verändert weder Karriere-Revision
noch den Geändert-Status des Demostands. Für isolierte QA gibt es
`--ui-preferences <Datei>`. Fehlerhafte Dateien werden gemeldet und bleiben
bis zu einer ausdrücklichen Übernahme unverändert. Ein CLI-Theme überschreibt
nur die aktuelle Sitzung. Alte flache UI-Voreinstellungen eines Demostands
können bei fehlender globaler Datei noch eingelesen werden.
Spieloptionen und Automatik gehören zum UI-Demostand: `settings.version = 1`,
`cells` mit 180 Ganzzahlen und `automation` mit fünf Wahrheitswerten. Es werden
keine Originaldateien verändert. Alte Demostände erhalten Standardwerte; ein
bereits vorhandener fehlerhafter Block wird beim Laden zurückgewiesen.
Der revisionsgeschützte Anbieter übernimmt eine Änderung atomar; Entwürfe
bleiben an ihre Quelle und Welt gebunden. Globale Änderungen werden vor einem
lokalen Commit gespeichert; bei Ablehnung wird die vorherige Datei restauriert.
Die Optionscodes sind eine UI-Zuordnung, keine neue Engine-Regelausführung.
Diese Umsetzung greift nicht auf GameState, Zufallsquellen oder Matchfunktionen
zu. **Anstoß bleibt funktionslos.** Stadionperipherie gehört nicht zu diesem
Paket. Spieloptionen, Bildschirmkonfiguration und Audio müssen später über
validierte Session-/Plattformadapter angeschlossen werden.
## Prüfung
Synthetische Anbietertests prüfen Katalogvollständigkeit, Zellgrenzen,
Automatikabgleich, Revisionen, atomare Fehler, Migration und unabhängige globale
Dateien. Bild- und Bedienungsnachweise inklusive UI-Demoständen liegen privat
unter `bmh_4k_ui/docs/qa/settings-batch-2026-10-25/`; sie ersetzen keine
Windows-/macOS-Laufzeitabnahme.
## Erste native Übertragungsart: Live-Ticker
Die native Präsentation bietet eine feste Übertragungsart Live-Ticker an; es gibt
keine Grafik-/Reality-/Animationsauswahl. Der Hinweis steht in Anzeige neben der
bestehenden Gestaltung. Theme-, Bildschirm- und Soundpräferenzen bleiben
vorhanden. Sportschau und Animationen sowie klar grafikbezogene Einzelzeilen
werden ausschließlich in der lesenden Präsentationskopie ausgeblendet.
Sportschau-Ergebniszeilen bleiben für diese erste Version verborgen, ohne ihnen
eine neue Regelbedeutung zu geben.
Sinnvolle Spielregeln, TOTO, Auslosungen, Pausen, Karten und Chancen bleiben
sichtbar. Die bisherigen Radio-Informationszeilen heißen für dieselben Inhalte
nun Gelbe Karten, Rote Karten beziehungsweise Chancen im Live-Ticker. Alle drei
Original-Spieltonadressen bleiben erhalten. Der ursprüngliche Katalog und die
Validierung werden nicht gekürzt: alle180Zellen einschließlich verborgener alter
Grafikwerte überleben Import, erneutes Speichern und Änderungen anderer Zeilen.
Die fünf Automatikwerte bleiben dieselben Benutzerwahlen, keine Engineaktionen.
Suchtreffer, sichtbare Gesamtzahl und Sprungliste verwenden denselben gefilterten
Katalog; verborgene Gruppen tauchen dort nicht als scheinbar wählbare Abschnitte
auf. Ein synthetischer Präsentationstest prüft Originalkatalog-Unverändertheit,
beibehaltene Regel-/Karten-/Chancenadressen, drei Soundadressen und unveränderte
179andere Zellen beim Editieren einer sichtbaren Option. Der gezielte native
Inputlauf bestätigt den festen Hinweis, ausgeblendete Gruppen/Choices,
keine Reality-Suchtreffer, Entwurf/Apply sowie erhaltene verborgene Werte.
Daraus folgt weder eine Änderung realer Spielregeln noch eine Engine-Anbindung.