Shader compatibility and Windows startup fixes
This preview corrects the shader pack shipped with v0.2.0. Its old Vulkan shader layout could cause a white screen or device loss after the intro. All three downloads now contain the matching ABI 8 shaders.
- Add shader-pack version checks during packaging and loading. Old, incompatible, truncated, empty and zero-entry packs fail with an error instead of silently reaching the graphics path.
- Keep packaged launchers using their bundled shaders and tools, including when extracted inside a source checkout.
- Include the Microsoft D3D12 Agility runtime in the Windows ZIP, addressing the missing runtime behind some Windows 10 D3D12 startup failures (PR #14).
- Keep Camera motion input, the skeleton debug window, controller handoff and two-player support from v0.2.0.
Shader compatibility and launcher fixes: PR #18.
Updating
Extract the complete new archive into a fresh folder. Do not copy the old shaders.pack over the new one. On Windows, retain the D3D12/, shader-tools/ and pose/ folders and the bundled DLLs beside the programs.
| Download | Support |
|---|---|
| Windows x64 ZIP | Windows 10/11; D3D12 or Vulkan; Camera motion and skeleton debug window included |
| Linux x64 tar.gz | Vulkan; Camera motion is not enabled in this prebuilt package |
| Android arm64 APK | Android 9+; Vulkan; Camera motion is not enabled |
Android version is 0.2.1, version code 8, signed with the existing release certificate for in-place updates. The Android licences ZIP accompanies the APK. SHA256SUMS.txt covers all four downloads.
Validation and remaining issues
- Local Windows build: 106/106 native tests passed; Linux build: 100/100 passed.
- Python tooling: 236 tests run, successful with 11 skipped.
- Windows extracted archive tested through a single-player tutorial race for 7,200 frames per backend, with audio enabled, on D3D12 and Vulkan. Screenshots checked for the white-screen, aspect and exposure regression.
- Linux extracted archive reached 180 presented frames under Vulkan.
- Checked matching shader packs in every download, Windows D3D12 runtime signature/hash, Camera dependency hashes, and Android version, native libraries, alignment and signing-certificate continuity.
- Windows, Linux, macOS build checks and Android launcher CI passed. Native code was rebuilt locally; Linux/Android reused existing generated guest objects after verifying byte-identical generated source files. No new physical Android gameplay test was performed.
The shader mismatch was reproduced locally and corrected. The reported device-specific slowdown and Grand Prix crash in #16 and #17 still need affected-user confirmation; this release does not claim to resolve every crash. Both issues remain open.
This remains a preview. You need your own USA/Europe Sonic Free Riders disc image; the launcher installs its data. No disc data, save files or camera recordings are included. VRM features are not included.