Skip to content

Run Windows games on Apple Silicon — free, open source, with an open compatibility database that tells you what actually works.

pull candidate engine r4: the DXVK 3.1 macOS fork's Direct3D 9 renders RaceRoom in grayscale and freezes FNAF (highball-db#60, highball#67)

Gauthier Piarrettec9145ee03051
diff --git a/spike/engines/x64-sikarugir10.0_6-r4.json b/spike/engines/x64-sikarugir10.0_6-r4.json
deleted file mode 100644
index 7b03609..0000000
--- a/spike/engines/x64-sikarugir10.0_6-r4.json
+++ /dev/null
@@ -1,166 +0,0 @@
-{
- "$schema": "https://highball.app/schemas/engine-manifest/v0",
- "id": "x64-sikarugir10.0_6-r4",
- "displayName": "Wine 10.0 (Sikarugir) + DXMT 0.80 + D3DMetal 3.0 + MoltenVK 1.4.1 (shadow-import patch) + DXVK 3.1 macOS fork for Direct3D 9",
- "arch": "x86_64",
- "minMacOS": "14.0",
- "requires": [
- "rosetta2"
- ],
- "notes": [
- "Engine is Gcenx's Sikarugir build of upstream Wine 10.0: exports macdrv_functions from winemac.so (required by both DXMT and D3DMetal bridges) and supports WINEDLLPATH_PREPEND for per-bottle renderer overlays.",
- "Vanilla Gcenx wine-devel 11.15 lacks the macdrv_functions export -> DXMT and D3DMetal do NOT work on it. Verified 2026-08-23 with nm.",
- "Runtime dylibs (GStreamer, MoltenVK, gnutls, freetype, SDL2, icu...) are NOT inside the engine; they come from the Sikarugir Wrapper Template's Frameworks/ and are found via DYLD_FALLBACK_LIBRARY_PATH.",
- "Wine 10 still ships a wine64 binary but the loader is `wine`; use `wine` so Wine 11 engines work unchanged.",
- "D3DMetal is NOT downloaded separately: the Template's frameworks/renderer/d3dmetal overlay is used, but only exposed once the user has accepted the Apple GPTK license (recorded in manifest.json as acceptedLicenses).",
- "r1 (2026-09-02): adds the moltenvk component. Everything else is byte-identical to r0, so existing downloads are reused; only the 5 MB MoltenVK tarball is new.",
- "r2 (2026-09-07): adds the d3dmetal-tsshim component, a d3d12.dll in front of D3DMetal's that serves DirectX 12 timestamp queries (D3DMetal 3.0 resolves them to zero at a reported 60 Hz, which crashes Guardians of the Galaxy, highball#63). Everything else is byte-identical to r1, so existing downloads are reused; only the 46 KB shim tarball is new. Source: spike/tsshim, Scripts/build-tsshim.sh.",
- "r3 (2026-09-15): the d3dmetal-tsshim component rebuilt so its exports carry Microsoft's d3d12 ordinals (GetBehaviorValue 100, D3D12CreateDevice 101, ... 110), which D3DMetal mirrors. The r2 shim numbered them from 1, so a game that binds d3d12 imports by ordinal (Path of Exile 2 delay-loads D3D12CreateDevice as ordinal 101) died at startup with 'ordinal 101 out of range' and Wine's exception 0xc06d007f (highball-db#53). Everything else is byte-identical to r2, so existing downloads are reused; only the 46 KB shim tarball is new. Source: spike/tsshim, Scripts/build-tsshim.sh 20260915.",
- "r4 (2026-09-16): candidate, not the default. Adds a d9vk component that replaces the template's DXVK-Kegworks 1.10.4 Direct3D 9 with the metalsharp DXVK-MacOS 3.1 build (DXVK 3.1 plus the Gcenx MoltenVK work). Three reports pointed at the old layer: RaceRoom's VK_ERROR_DEVICE_LOST (highball-db#60, fixed for the reporter by this swap), FNAF 2 freezing on DXVK (highball#67), Left 4 Dead at 3 fps (highball#108). Verified here with Unigine Heaven on Direct3D 9 rendering through it on the stock MoltenVK 1.4.1. Every other component is byte-identical to r3. Becomes the default once Portal, Portal 2 and Five Nights at Freddy's are rechecked on it."
- ],
- "components": {
- "wine": {
- "kind": "engine",
- "url": "https://github.com/Sikarugir-App/Engines/releases/download/v1.0/WS12WineSikarugir10.0_6.tar.xz",
- "sha256": "9da7ee0cbf386522f3a9906943726d9c3c125dbbd9ab120e3cde80e88d6091b2",
- "size": 166304096,
- "license": "LGPL-2.1+",
- "extract": {
- "strip": "wswine.bundle",
- "into": "engine"
- },
- "version": "wine-10.0 (Sikarugir) revision 6"
- },
- "runtime": {
- "kind": "frameworks",
- "url": "https://github.com/Sikarugir-App/Wrapper/releases/download/v1.0/Template-1.0.11.tar.xz",
- "sha256": "9fa15479e7ff6abd99c1d07be285fb95f41fc6991586502427152b1f7d6ccb8a",
- "size": 84533420,
- "license": "mixed (LGPL-2.1 GStreamer, Apache-2.0 MoltenVK, LGPL gnutls, ...)",
- "extract": {
- "subpath": "Template-1.0.11.app/Contents/Frameworks",
- "into": "frameworks"
- },
- "provides": [
- "GStreamer.framework 1.0",
- "libMoltenVK.dylib",
- "renderer/dxmt v0.74",
- "renderer/d3dmetal 3.0",
- "renderer/dxvk 1.10.3-async",
- "renderer/d9vk 1.10.4-async",
- "renderer/cnc-ddraw 7.1.0.0"
- ]
- },
- "dxmt": {
- "kind": "renderer",
- "url": "https://github.com/3Shain/dxmt/releases/download/v0.80/dxmt-v0.80-builtin.tar.gz",
- "sha256": "8f260e36b5739e68f3bad613381441385c4dc7b85b78ba8de653d5a6a264529d",
- "size": 18681669,
- "license": "MIT",
- "extract": {
- "subpath": "v0.80",
- "into": "renderers/dxmt/wine"
- },
- "layout": [
- "x86_64-unix/winemetal.so",
- "x86_64-windows/{d3d11,dxgi,d3d10core,winemetal,nvapi64,nvngx}.dll",
- "i386-windows/{d3d11,dxgi,d3d10core,winemetal}.dll"
- ],
- "env": {
- "WINEDLLPATH_PREPEND": "${renderers}/dxmt/wine"
- },
- "replacesTemplateRenderer": "dxmt v0.74"
- },
- "d3dmetal-tsshim": {
- "kind": "renderer",
- "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/d3dmetal-tsshim-20260915/d3dmetal-tsshim-20260915.tar.xz",
- "sha256": "453f33ef1442ec8d24e9a44d901d35d4d07431c05ae8318c30567facc78d9ef3",
- "size": 46116,
- "license": "MIT",
- "version": "20260915",
- "order": 1,
- "extract": {
- "subpath": "renderers/d3dmetal-tsshim/wine",
- "into": "renderers/d3dmetal-tsshim/wine"
- },
- "layout": [
- "x86_64-windows/d3d12.dll"
- ],
- "note": "A d3d12.dll in front of D3DMetal's that serves DirectX 12 timestamp queries (D3DMetal 3.0 resolves them to zero at a reported 60 Hz). Exports carry Microsoft's d3d12 ordinals (D3D12CreateDevice at 101), which D3DMetal mirrors, so games that bind d3d12 imports by ordinal load through it. Kill switch HB_D3D12_TSSHIM=0 idles the patches; the DLL stays in front. Source: spike/tsshim, Scripts/build-tsshim.sh."
- },
- "winetricks": {
- "kind": "tool",
- "url": "https://raw.githubusercontent.com/Winetricks/winetricks/5a59ea07513b24093bd90fad943ecf9543cf05bc/src/winetricks",
- "sha256": "f35c29737ca08a583569e6a3752d52fbe23333c5acfad5f16c4177d25eaf3f4b",
- "license": "LGPL-2.1",
- "note": "Pinned to upstream commit 5a59ea07 (20260125+dev, 2026-08-07) — the exact bytes 0.7.x verified with dotnet48. The old branch URL drifted and broke every fresh engine install (issues #27/#28); URLs here must be immutable."
- },
- "moltenvk": {
- "kind": "runtime",
- "url": "https://github.com/gauthierpiarrette/highball/releases/download/engine-components/moltenvk-1.4.1-shadow-import-1-x86_64.tar.gz",
- "sha256": "fbed7b80d6dc2aeaba6fa7047c1fe64827d5004c28029fb43c2bc34f80c35228",
- "size": 1674937,
- "license": "Apache-2.0",
- "version": "1.4.1+shadow-import-1",
- "order": 1,
- "extract": {
- "subpath": "libMoltenVK.dylib",
- "into": "frameworks/libMoltenVK.dylib"
- },
- "note": "MoltenVK 1.4.1 rebuilt with Highball's shadow-import patch (spike/patches/moltenvk-shadow-import.patch, Scripts/build-moltenvk.sh). Replaces the Template's libMoltenVK.dylib. Off unless a launch sets MVK_SHADOW_IMPORT=1: with it, Wine's wow64 host-memory imports are backed by a private Metal buffer synced on every submit, which is what makes 32-bit native-Vulkan games (The Sims Legacy Collection) render instead of losing the device on every vkQueueSubmit."
- },
- "d9vk": {
- "extract": {
- "into": "renderers/d9vk/wine",
- "subpath": "renderers/d9vk/wine"
- },
- "kind": "renderer",
- "layout": [
- "x86_64-windows/d3d9.dll",
- "i386-windows/d3d9.dll"
- ],
- "license": "zlib",
- "note": "Direct3D 9 overlay built from metalsharp/DXVK-MacOS v3.1-macos1.0 (DXVK 3.1 with the Gcenx MoltenVK compatibility work), replacing the DXVK-Kegworks 1.10.4 d3d9 the Sikarugir template ships. Both architectures, stamped as Wine builtins. Candidate after RaceRoom's device loss (highball-db#60), FNAF 2's freeze (highball#67) and Left 4 Dead's 3 fps (highball#108) on the old layer. Upstream DXVK 3.x itself cannot run on MoltenVK (it requires the geometryShader feature Metal lacks); the fork carries the MoltenVK work.",
- "sha256": "0fabdffde07ef1ef041e95181ca1507db96919cf70acfa91a15c159718ad7611",
- "size": 9766808,
- "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/d9vk-dxvk-macos-3.1-20260916/d9vk-dxvk-macos-3.1-20260916.tar.xz",
- "version": "dxvk-macos-3.1-20260916",
- "order": 1
- }
- },
- "alternatives": {
- "wine-devel-11.15": {
- "url": "https://github.com/Gcenx/macOS_Wine_builds/releases/download/11.15/wine-devel-11.15-osx64.tar.xz",
- "sha256": "3f8e89a4874953a69e7be3dcdcc262d0346e462a9374bd116770fffb9e2a99d2",
- "status": "usable for WineD3D/DXVK only; no macdrv_functions export; needs external GStreamer.framework (pkg install, sudo)"
- },
- "gptk-3.0-3": {
- "url": "https://github.com/Gcenx/game-porting-toolkit/releases/download/Game-Porting-Toolkit-3.0-3/game-porting-toolkit-3.0-3.tar.xz",
- "sha256": "d377683937340f914823dbb2e1252b329cbf834ff58907d0293db8cebf0e392e",
- "size": 239200808,
- "status": "canonical source of D3DMetal 3.0; not needed because the Template's renderer/d3dmetal carries the same framework with bridges built for this engine"
- }
- },
- "baseEnv": {
- "WINEDEBUG": "fixme-all",
- "DYLD_FALLBACK_LIBRARY_PATH": "${frameworks}:${frameworks}/GStreamer.framework/Versions/1.0/lib",
- "DYLD_FALLBACK_FRAMEWORK_PATH": "${frameworks}",
- "GST_PLUGIN_PATH": "${frameworks}/GStreamer.framework/Versions/1.0/lib/gstreamer-1.0"
- },
- "verified": {
- "date": "2026-08-23",
- "macos": "14.6",
- "chip": "Apple M1 Pro",
- "wineboot": "ok (88s)",
- "steam-install": "ok (13s)"
- },
- "licenses": {
- "apple-gptk-license-2023-08-17": {
- "applies": [
- "renderers/d3dmetal (bundled in the Sikarugir Template: D3DMetal.framework sha1 1405e5c6… identical to GPTK 3.0-3)"
- ],
- "text": "spike/d3dmetal-license.txt",
- "summary": "Apple Game Porting Toolkit license: non-commercial use/distribution only; no modification; use scoped to developing, testing or evaluating games on Apple hardware."
- }
- }
-}