Run Windows games on Apple Silicon — free, open source, with an open compatibility database that tells you what actually works.
Swift apple-silicond3dmetaldxmtdxvkfexgame-porting-toolkitgamingmac-gamingmacosmetalmoltenvksteamswiftuivkd3d-protonwhisky-alternativewindows-gameswinewine-wrapper
engine r4 (candidate): Direct3D 9 from the DXVK 3.1 macOS fork in place of DXVK-Kegworks 1.10.4 (highball-db#60, highball#67, highball#108)
Gauthier Piarrette26f7e2fca7a0
diff --git a/spike/engines/x64-sikarugir10.0_6-r4.json b/spike/engines/x64-sikarugir10.0_6-r4.jsonnew file mode 100644index 0000000..7b03609--- /dev/null+++ b/spike/engines/x64-sikarugir10.0_6-r4.json@@ -0,0 +1,166 @@+{+ "$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."+ }+ }+}