Files
Dreierpack-Manager/docs/new_ui/desktop/save-load

Speichern, Laden und Desktopansichten

Die native RmlUI-Fassung überträgt den privaten HTML-Goldstand der Dateien desktop/save-load-menu.js, desktop/save-load-window.css, desktop/modern-dialogs.js und desktop/desktop-views.js. Referenzrevision: 4b1c3b61ccd7b19351cd0b2dfac1006918103c97. Die Referenz bleibt privat und unverändert; diese öffentliche Implementierung enthält keine Originalgrafiken oder Originalspielstände. Ausgangsstand der nativen Umsetzung ist db89d88.

Sichtbare Ansichten

Spielstände verwenden den gemeinsamen Untermenürahmen mit 2720 × 2040 Entwurfseinheiten. Die Desktopansichten verwenden das eigenständige Desktopdialogfenster mit 2560 × 1840 Einheiten. Beide haben eine unbegrenzt scrollbare Liste, eine getrennte Detailansicht und bestätigte Aktionen für Überschreiben, Umbenennen und Löschen. „Neuer Speicherstand“ beziehungsweise „Neue Ansicht“ erscheint nur beim Speichern. Fehlende oder beschädigte Dateien bleiben mit einer Fehlermeldung erkennbar.

Die Karriereübersicht zeigt Saison, Spieltag, Spieldatum, Manager und Vereine aus dem ausgewählten Dokument. Nur ein neuer Eintrag zeigt die aktuelle Karriere. Die Demo befindet sich ohne gesonderte gespeicherte game_info.matchday-Angabe in der Vorbereitung; hier wird kein zukünftiger Engine-Spieltag erfunden. Die Saison folgt dem gespeicherten Spieldatum und beginnt im Juli. Speicherdatum, Dateigröße und Änderungsdatum stammen aus dem Dateianbieter. Namen werden vor der Anzeige als RmlUI-Text maskiert.

Die Ansicht „Standard“ ist eine unveränderliche, immer verfügbare Vorlage. Sie verwendet beim Laden den aktuellen Look. Ihre Vorschau wird unmittelbar aus der Standardgeometrie gezeichnet; sie ist kein Screenshot einer heimlich auf die aktive Karriere angewendeten Ansicht. Eigene Ansichten enthalten den tatsächlichen Desktop-Screenshot zum Speicherzeitpunkt sowie Anordnung, Widgetgrößen, Sichtbarkeit, Fixierungen und Look. Der Screenshot entsteht ohne Dateidialog und ohne das darüberliegende Verwaltungsfenster.

Lokale Dateitransaktionen

DemoFiles speichert ausschließlich UI-Demostände; es liest und schreibt keine OBS-/Engine-Karriere. Die Ablage liegt unter dem weltbezogenen userdata/ui-demo/<world-hash>/saves beziehungsweise layouts. Der explizite Parameter --ui-userdata erlaubt eine vollständig isolierte QA-Ablage. Globale Anzeige-, Sound- und Themenpräferenzen bleiben in ihrer eigenen Datei.

Ein Datensatz ist ein Dokument mit Schema openbmh-ui-file@1. Es enthält Bezeichnung, Art, Zeitstempel, Payload, Welt-ID, Hash der Weltmanifestrevision, PNG-Vorschau und separate Inhaltsprüfsummen. Die PNG-Bytes werden verlustfrei hexadezimal eingebettet. Deshalb werden Layout und Screenshot mit einem atomaren Dateiaustausch veröffentlicht. Die Dateinamen sind opake IDs und werden nicht aus Benutzernamen zusammengesetzt. Eine umbenannte Ansicht behält Identität, ursprünglichen Speicherzeitpunkt und Vorschau.

Vor der Veröffentlichung werden Karriere und Desktop in isolierten Objekten validiert. Karriereprüfungen nutzen die bestehenden DemoSource-Regeln. Die aktive Quelle wird erst nach erfolgreicher Validierung ersetzt. Entwürfe binden sich an Welt, Source-Objekt und Source-Revision. Bestätigungen tragen zusätzlich den SHA-256-Token der ausgewählten Dateiversion. Ein inzwischen geänderter, gelöschter oder fremder Datensatz wird zurückgewiesen.

Ein kurzlebiges Transaktionsverzeichnis serialisiert Anbieteroperationen. Fehlgeschlagene Schreibvorgänge behalten den bisherigen Datensatz. Löschen verwendet eine atomare Umbenennung; bei einem unterbrochenen Aufräumen bleibt die Datei als versteckter, wiederherstellbarer Rest erhalten. Ein nach einem Prozessabsturz verbliebenes Transaktionsverzeichnis wird nicht ungeprüft entfernt: Nach Beenden aller beteiligten Prozesse muss es geprüft werden. Symlinks und Pfadwechsel aus der Ablage werden zurückgewiesen. Abgeleitete PNG-Vorschaudateien unter .previews sind nur ein durch Hash identifizierter Cache; sie sind nie die autoritative gespeicherte Vorschau.

Namen besitzen 1 bis 64 Unicode-Zeichen und keine Steuerzeichen. Der plattformunabhängige Vergleich berücksichtigt Groß-/Kleinschreibung, deutsches ß, Ö/ö und komponierte/dekomponierte lateinische Tastaturakzente. Ansichten berücksichtigen zusätzlich vollbreite ASCII-Kompatibilitätszeichen; „Standard“ bleibt dabei reserviert. Speichernamen verwenden diesen Kompatibilitätsschritt nicht. Die kleine portable Hilfe ist kein vollständiger Unicode-NFC-/NFKC-Normalisierer: Seltene kombinierte Schriftzeichen außerhalb der dokumentierten lateinischen Akzente bleiben bytegenau unterscheidbar. Diese Grenze betrifft die Namen, nicht die Dateiinhalte oder Spielvalidierung.

Ältere rohe Demo-JSON-Spielstände und Layoutdateien werden gelesen, aber beim Navigieren nicht umgeschrieben. Vorhandene PNG-Seitendateien können in ein neues konsistentes Dokument übernommen werden. Alte Ansichten ohne Vorschau zeigen einen ausdrücklichen Hinweis; vor der Veröffentlichung einer neuen Ansichtsdatei ist eine gültige Vorschau erforderlich.

Aktionen und Zustandsgrenzen

Import und Export sind ausdrückliche Buttonaktionen. Erst dann öffnet NFD einen Betriebssystemdialog. QA kann mit --ui-file-import und --ui-file-export konkrete Pfade bereitstellen; die Parameter lösen allein keine Dateiaktion aus. Import validiert das Dokument vollständig und legt einen neuen, bei Namenskonflikten umbenannten Eintrag an. Es wird kein bestehender lokaler Stand überschrieben und keine Karriere automatisch geladen. Export enthält Payload und Vorschau gemeinsam; ein vorhandenes Ziel benötigt eine separate Überschreibbestätigung.

Karriere-Save setzt Source und Karriere-Desktop erst nach erfolgreicher Veröffentlichung auf „gespeichert“. Karriere-Load setzt den ausgewählten validierten Stand samt Layout auf „gespeichert“. Ansichts-Save verändert diese Karrieremarkierungen nicht. Ansichts-Load erzeugt einen Desktop-Undo-Schritt, speichert die globale Themenpräferenz zuerst und übernimmt anschließend Layout und Look. Andere Anzeige- oder Soundwerte werden dabei nicht aus dem Spielstand übernommen.

Die Root-Glue-Hooks files_saved_success(bool) und files_loaded_success() verantworten den Rücksprung ins Hauptmenü, die Fortsetzung eines bestätigten Beenden-Ablaufs und das Zurücksetzen sourceabhängiger Presenter. Abbrechen und Escape verwerfen nur lokale Dateifensterentwürfe und die ausstehende Beenden-nach-Speichern-Absicht. Navigation, Auswahl und Vorschau verändern die aktive Karriere nicht.

Prüfung und offene Enginefragen

tests/modern_files_ui_tests.cpp verwendet nur eine synthetische Welt und temporäre QA-Dateien. Es prüft Namenskonflikte, atomare Payload-/PNG-Rundläufe, veraltete Tokens, beschädigte Importe, fehlgeschlagene Überschreibungen, Transaktionskonflikte, ausgewählte Dateimetadaten, Exportkollisionen, getrennte UI-Präferenzen und den Rollback fehlgeschlagener Karrierevalidierung. Ein Build und native Screenshot-/Interaktionsprüfungen müssen separat ausgeführt werden; die Testquelle allein belegt kein Plattformverhalten.

Die spätere Engineanbindung muss den gemeinsamen Karriere-/Sessionanbieter verwenden. OBS-Migration, Managerbesitz, Engine-Revisionen, RNG-Zustände, Autosaves und echte Saisonfortschritte werden hier ausdrücklich nicht als implementiert behauptet. Sie gehören nicht in diesen UI-Demodateianbieter.

Bewusste Abgrenzungen zum Browser-POC

Ansichten und Arbeitsanordnung liegen in dieser nativen Demo im weltbezogenen UI-Verzeichnis; vorhandene ältere native Layouts bleiben so erreichbar. Der Browser-POC speichert diese Bibliothek browserglobal. Anzeige und Sound bleiben nativ unabhängig von der Welt gespeichert. Das Laden einer Karriere setzt diese globalen Präferenzen nicht zurück; eine benannte Ansicht darf dagegen ihre ausdrücklich gespeicherte Gestaltung wiederherstellen.

Erfolgreiches Speichern und Laden einer Karriere lässt das Dateifenster mit Auswahl und Rückmeldung offen. Ansichts-Speichern und -Laden kehren zum Desktop zurück. Arbeitsanordnungen lösen keinen Spielstand-Speicherbedarf aus.