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
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.jsondeleted file mode 100644index 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."- }- }-}