Skip to content

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

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.json
new file mode 100644
index 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."
+ }
+ }
+}