A3HD Reparatur-Update 1.0.5 – Windows-Testpaket, 01.11.2026

EIN GEMEINSAMER ABLAUF
Siehe START-HIER.txt. Dieses Paket ersetzt für neue Tests den manuellen
DLL-Austausch und bündelt HD-Update, gesicherten Grafikwechsel, Startprotokoll,
Diagnose und Wiederherstellung in A3HD-Setup.exe. payload muss daneben bleiben.
Die Versionsauswahl kann auf „Automatisch erkennen“ stehen bleiben.

VORAUSSETZUNGEN
Vorhandene HD-Basis und erkannte deutsche GOG-1.40-EXE (einschließlich bekannter
Balancing-Versionen) oder erkannter AJ/CD-/CD-Test3-Stand mit passender nativer
Grafik-DLL. Beliebige CBS-, Sprach- oder modifizierte EXEs werden nicht automatisch
unterstützt; manuelle Versionsauswahl umgeht diese Prüfung nicht.
Das kleine Update enthält keine Spiel-EXE, Grafiken oder neuen Balancing-Regeln.
Erstinstallation ohne HD-Basis weiterhin über das bestehende Basispaket.

WAS DIE REPARATUR ÄNDERT
Die unveränderte Diagnoseruntime aus 1.0.4 wird installiert. gl.cfg wird für
32-Bit-Farbe und den Fensterbetrieb der alten Engine korrigiert. Andere
Einstellungen, EXE, Spielstände, HDAssets und Balancing bleiben erhalten.

Standardgrafik: Die lokale ddraw.dll wird nach Sicherung deaktiviert.
Unter Windows übernimmt die System-DirectDraw-Bibliothek. Es wird keine
Windows-Systemdatei angefasst und keine fremde DLL aus dem Internet nachgeladen.

Kompatibilitätsgrafik: Die mitgelieferte DDrawCompat 0.7.2 wird zusammen mit
unserer Konfiguration installiert. Dies ist ein optionaler Windows-Test und
kein bestätigter universeller Grafikfix. Kein neuer Vollbild-/16:9-Modusschalter.

Beide Varianten sichern auch unbekannte lokale Wrapper vollständig. Das
behebt den bisherigen Installationsblocker bei Vetaran, beweist aber noch
nicht die Lösung seines grauen Startbildschirms. Die Sicherung ist an genau
seine vorhandenen Dateien gebunden; kein unbekannter EXE-Code wird gepatcht.

GESICHERTE DATEIEN UND RÜCKBAU
D3D_Dll.dll, gl.cfg, ddraw.dll und die drei Konfigurationen DDrawCompat.ini,
DDrawCompat-anstoss3.ini, DDrawCompatOverlay-anstoss3.ini werden berücksichtigt.
Auch ihr vorheriges Fehlen wird gespeichert. Fremde Wrapper-Einstellungen
werden nach Sicherung deaktiviert, damit sie den Vergleich nicht verfälschen.
A3HD-Repair.txt beschreibt die Transaktion, A3HD-Repair-Backup-* enthält die
Originaldateien und SHA256-geprüften Sicherungen. Diese Dateien behalten.

Beim Variantenwechsel wird zunächst die eigene Reparaturschicht zurückgebaut
und dann die neue Variante installiert. Der Rückweg bleibt der Zustand vor
der ersten Reparatur. Bei Fehlern kann „Vorherigen Zustand wiederherstellen“
den Rückbau fortsetzen; unvollständige Vorgänge werden nicht als Erfolg gemeldet.
Nachträglich fremd geänderte Dateien oder beschädigte Sicherungen werden nicht
blind überschrieben: Diagnose sammeln. Ein Versionswechsel der EXE während
einer aktiven Reparatur erfordert ebenfalls Prüfung statt automatischem Rückbau.

Frühere 1.0.4-/Diagnose-/3D-Patches bleiben als unterliegende Schicht erhalten.
Der Rückbau dieser Reparatur stellt genau diesen vorherigen Zustand her; er
entfernt nicht automatisch sämtliche älteren Patches. Keine älteren Installer
über eine aktive Reparatur laufen lassen. Vorher Reparatur zurücknehmen.

LOGGING UND TESTRÜCKMELDUNG
„Spiel starten“ im neuen Fenster setzt eine vollständig geprüfte Reparatur
voraus. So wird nach fehlgeschlagenem Update nicht versehentlich ein alter
HD-Stand als neue Version getestet. Ein eigener Start über die Spiel-EXE
bleibt möglich, enthält aber keine zusätzliche Setup-Prozessüberwachung.

Installer und Runtime protokollieren Startinventar/Hashes, Windows/GPU/Treiber,
DirectDraw-/Direct3D-Fehler und kritische Exceptions. Die Runtime ist bytegleich
zu 1.0.4. Normale Logs rotieren bei 1 MiB, kritische Logs bei 64 KiB.
Spielordner und TEMP/A3HD sowie VirtualStore werden bei der Sammlung berücksichtigt.
Der neue Reparaturnachweis und die Wrapper-Konfigurationen kommen mit in den Bericht.
Keine Spiel-EXE/DLL, Bilder oder Spielstände werden in Diagnoseberichte kopiert.
Logs können persönliche Pfade enthalten: vor dem Hochladen prüfen.

Bei Fehlern nennen: gewählte Grafikvariante, Zeitpunkt, genauer Ablauf,
Windows-Version, Grafikkarte und ob Menüstart oder erst 3D betroffen ist.
Ein Prozess-Endcode 0 beweist keine korrekte Darstellung. Ein fehlender
Logeintrag beweist keinen erfolgreichen Start. Kein automatischer Upload.

QUELLE UND LIZENZ
DDrawCompat 0.7.2 ist ein Upstream-Pre-release unter 0BSD.
https://github.com/narzoul/DDrawCompat/releases/tag/v0.7.2
Lizenz: LICENSE-DDrawCompat.txt. A3HD-Quellen und Prüfskripte: source/.
Die GOG-Original-ddraw.dll wird nicht mitgeliefert.

TECHNISCHE AUFRUFE (normalerweise nicht erforderlich)
A3HD-Setup.exe /repair SPIELORDNER [auto|gog|cd]
A3HD-Setup.exe /repair-compat SPIELORDNER [auto|gog|cd]
A3HD-Setup.exe /restore SPIELORDNER
A3HD-Setup.exe /collect SPIELORDNER AUSGABEORDNER
/launch bleibt als technischer Diagnoseaufruf auch für fehlgeschlagene alte
Installationen verfügbar. /install, /compat-install, /compat-restore dienen
nur den früheren Patch-Schichten und sind bei aktiver Reparatur gesperrt.
Lokale Tests laufen unter privatem Wine/Xvfb; sie ersetzen keinen nativen
Windows-Test. Details und tatsächliche Prüfergebnisse: PRUEFSTAND.txt.
