A3HD Community-Update 1.0.4 – Windows-Testpaket
Stand: 29.10.2026

EIN SETUP FÜR BESTEHENDE HD-INSTALLATIONEN
Dieses Paket bündelt die bisherigen Startkorrekturen, den unveränderten
Diagnose-Renderer 1.0.3, Startüberwachung, Berichtssammlung und optionalen
DDrawCompat-3D-Test. Die Auswahl erfolgt in einem Fenster: A3HD-Setup.exe.
Es ersetzt die getrennten Update-/Diagnose-/3D-Downloads für neue Tests.
Der 3D-Test ist keine automatisch aktivierte oder bestätigte Universallösung.

KEINE GRAFIKEN ERNEUT LADEN
Bestehende HD-Grafiken, Schrift, Sprites, Spielstände, Spiel-EXE und bereits
installiertes Balancing bleiben erhalten. Kein neues Balancing wird eingebaut.
Für die Erstinstallation wird weiterhin das bisherige HD-Basispaket benötigt.
Dieses kleine Update enthält keine Bilder und keine Original-Spieldateien.

INSTALLATION UND TEST
1. Spiel schließen. ZIP vollständig in einen eigenen Ordner entpacken.
   A3HD-Setup.exe und der Ordner payload müssen nebeneinander bleiben.
2. Setup starten und Spielordner mit anstoss3.exe auswählen. „Version
   automatisch erkennen“ belassen; alternativ bekannte GOG- oder CD-Familie.
3. „HD aktualisieren“ wählen. Benötigt Schreibrechte im Spielordner.
   Das Setup sichert D3D_Dll.dll und gl.cfg, installiert den protokollierenden
   HD-Renderer und stellt gl.cfg auf 32-Bit-Farbe/Fenstermodus um. Andere
   Optionen bleiben erhalten. Ausschließlich der exakt bekannte GOG-ddraw-
   Wrapper wird gesichert und entfernt, damit System-DirectDraw verwendet wird.
   Ein bereits vorhandener offizieller DDrawCompat-Testwrapper bleibt erhalten.
   Fremde Wrapper werden nicht ersetzt; unbekannte Versionen werden abgewiesen.
4. „Spiel mit Startprotokoll starten“ und Fehler nachstellen. Dieser Start
   erfasst Windows-Startfehler und Prozess-Endcode. Der Setup-Start verwendet
   anstoss3.exe ohne besondere Argumente externer Launcher. Bisherige
   Verknüpfungen funktionieren weiter, ohne diese zusätzliche Überwachung.
5. Spiel beenden; „Diagnose sammeln“ und Ausgabeordner wählen. Es entsteht
   ein A3HD-Bericht-Ordner. Persönliche Pfade/Fehlertexte prüfen, Ordner als ZIP
   weitergeben. Fehlerzeitpunkt und Reproduktionsschritte dazuschreiben.

Auch bei unbekannter EXE und fehlgeschlagenem Update kann „Diagnose sammeln“
verwendet werden. Es wird nichts automatisch hochgeladen. Sind Spielordner
und TEMP nicht beschreibbar, ist kein vollständiges Protokoll möglich.

WAS PROTOKOLLIERT WIRD
- UTC-Zeit, Prozess-/Thread-ID, Phase und Ergebnis.
- Windows-Build, Architektur/WOW64, DPI/Bildschirmmodi, Grafikadapter und
  Treiberdaten, soweit Windows sie bereitstellt.
- Größe/SHA-256 der konkret benannten EXE-, DLL-, Konfigurations- und
  Installationsnachweisdateien. Keine rekursive Spielstandsuche.
- Modulnamen/Ladeadressen für die Zuordnung von Fehleradressen.
- Frühe LoadLibrary-/Exportfehler und der HD-Anbindungsstatus.
- Eintritt und Rückkehr wichtiger SGL-Startfunktionen.
- DirectDrawCreate/Enumerate, QueryInterface, SetCooperativeLevel,
  SetDisplayMode, CreateSurface und IDirect3D3::CreateDevice inklusive
  HAL/RGB/Ramp und exakten HRESULTs. Rückgabewerte werden nicht verändert.
- Fehlerdialoge über die erfassten MessageBoxA/W-Importe der nativen SGL-DLL.
- Kritische Windows-Exceptions in einer getrennten Datei. FIRST-CHANCE
  bedeutet ausdrücklich nicht zwingend einen Absturz: manche Exceptions
  werden vom Programm behandelt. Mit Prozess-Endcode/Zeitpunkt abgleichen.
- Installer-Validierung, Sicherung, Dateiänderung, Ablehnung und Rückbau.

LOGDATEIEN UND GRENZEN
Runtime: a3hd-runtime.s0.log bis s3.log im Spielordner; bei fehlenden
Schreibrechten unter %TEMP%\A3HD. Setup: a3hd-setup.s0.log bis s3.log
unter %TEMP%\A3HD. Pro Slot werden bis zu zwei ältere Dateien .1.log/.2.log
aufbewahrt. Jede normale Datei ist auf1MiB begrenzt; Rotation erhält die
jüngsten Einträge. Kritische Exceptions: .crash.log und .crash.1.log,
je maximal64KiB. Vier Slots ermöglichen parallele Schreiber ohne Vermischung.
Die kleinen .lock-Dateien reservieren aktive Slots; keine Spieldateien.

Zusätzlich bleibt a3hd.log mit älteren Renderer-Details erhalten, beim neuen
Start als a3hd.previous.log gesichert. Sein Inhalt ist weiterhin begrenzt.
Vorhandene 1.0.2-Ausweichlogs a3hd-slot-0.log bis a3hd-slot-7.log werden
mitgesammelt. DDrawCompat schreibt bei Verwendung DDrawCompat-anstoss3.log.
Der Sammler berücksichtigt Spielordner, TEMP/A3HD und Windows VirtualStore.
Bei Dateien über2MiB kopiert er nur das Ende und kennzeichnet die Kürzung.
SAMMLUNG.txt nennt kopierte und nicht lesbare/übersprungene Dateien.

Berichte können ältere Sitzungen und persönliche Pfade/Fehlertexte enthalten.
Vor dem Hochladen prüfen. Es werden ausschließlich festgelegte Logs,
Konfigurationen und Nachweise kopiert, keine Spiel-EXEs/DLLs, Saves oder Bilder.

Was weiterhin nicht garantiert ist: lückenlose Aufzeichnung aller APIs,
Crash-Symbole/Stacks, Probleme vor dem ersten Aufruf des HD-Renderers ohne
Startüberwachung, vom Betriebssystem erzwungenes Beenden, Stromausfall,
Fail-fast oder unbeschreibbare/volle Datenträger. Sehr viele normale
Grafikaufrufe werden begrenzt; Fehler und D3D3-Geräteversuche bleiben aktiv.
Ein ausbleibender Logeintrag beweist nicht, dass kein Fehler vorlag.

OPTIONALER 3D-KOMPATIBILITÄTSTEST
Erst den Fehler mit installiertem Logging dokumentieren. Danach kann
"Optional: 3D-Testpatch installieren" gewählt werden. Installiert denselben
geprüften DDrawCompat0.7.2-Wrapper wie das separate Test1-Paket, mit eigener
Sicherung. Er ersetzt ausschließlich den exakt bekannten GOG-Wrapper oder
wird bei bislang fehlendem Wrapper ergänzt. Fremde Wrapper/Konfigurationen
werden abgelehnt. Erneut über Startprotokoll testen und einen zweiten Bericht
sammeln. 3D wird nicht pauschal abgeschaltet, kein D3D9On12-Modus erzwungen.
DDrawCompat0.7.2 ist ein Upstream-Pre-release unter0BSD:
https://github.com/narzoul/DDrawCompat/releases/tag/v0.7.2
Lizenz: LICENSE-DDrawCompat.txt. Windows-Erfolg bleibt zu bestätigen.

RÜCKBAU UND FRÜHERE PATCHES
Spiel schließen; „Community-Update zurücknehmen“ stellt den unmittelbar
vorherigen Renderer, gl.cfg und gegebenenfalls den zuvor entfernten GOG-
Wrapper wieder her. Ein schon vorher installierter separater Startfix oder
Diagnosepatch wird damit nicht deinstalliert. Seine Nachweise bleiben erhalten.

Wurde der GOG-Wrapper beim Community-Update entfernt und anschließend der
optionale 3D-Test installiert, zuerst „3D-Testpatch zurücknehmen“ wählen.
Das Setup verweigert andernfalls den Haupt-Rückbau ohne Dateien zu ändern.
Ein bereits vor dem Community-Update vorhandener optionaler Wrapper bleibt
beim Haupt-Rückbau erhalten und kann separat zurückgenommen werden.

A3HD-Community.txt und A3HD-Community-Backup-* sowie A3HD-3D-Patch.txt und
A3HD-3D-Backup-* nicht löschen. Ältere Nachweise/Backups ebenfalls behalten.
Fremdänderungen an verwalteten Dateien werden nicht überschrieben; bei einer
Ablehnung Diagnose sammeln. Ein unterbrochener Rückbau ist wiederholbar.
Vor Verwendung älterer Installer neue Schichten in umgekehrter Reihenfolge
zurücknehmen. Logs bleiben zur Fehleranalyse erhalten.

UNTERSTÜTZTE BESTEHENDE HD-STÄNDE
Bekannte deutsche GOG-1.40-EXEs, registrierte Balancing-Stände und geprüfte
AJ/CD/CD-Test3-EXEs mit passender Original-Grafik-DLL und bekanntem HD-1.0-,
Startfix/Test3-, 1.0.2- oder 1.0.3-Renderer. Keine pauschale CBS-Unterstützung.
Eine manuelle Versionsauswahl umgeht niemals die Hashprüfung.

KOMMANDOZEILE
A3HD-Setup.exe /install "C:\Spiele\Anstoss3" auto
A3HD-Setup.exe /restore "C:\Spiele\Anstoss3"
A3HD-Setup.exe /diagnose "C:\Spiele\Anstoss3"
A3HD-Setup.exe /launch "C:\Spiele\Anstoss3"
A3HD-Setup.exe /collect "C:\Spiele\Anstoss3" "C:\Berichte"
A3HD-Setup.exe /compat-install "C:\Spiele\Anstoss3" auto
A3HD-Setup.exe /compat-restore "C:\Spiele\Anstoss3"
Statt auto bei install/compat-install auch gog oder cd möglich.
Lokale absolute Windows-Pfade mit Rückwärtsschrägstrichen verwenden.

QUELLCODE UND PRÜFSTAND
source enthält C-Quellen, Buildskript und Tests. Python 3 plus llvm-mingw i686:
A3_MINGW=/pfad/bin A3_CC=/pfad/bin/i686-w64-mingw32-clang python3 build.py
Integrationstests benötigen den Entwickler-Checkout mit legalen Testkopien.
PRUEFSTAND.txt beschreibt bestätigte Tests und offene Windows-Rückmeldungen.
Lizenz des mitgelieferten DDrawCompat: LICENSE-DDrawCompat.txt (0BSD).
