Skip to content

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

Engines r22 (default) and r23 (D3DMetal 4 line): the Mac driver stops doubling HORZRES and VERTRES in retina mode, a fourth byte edit to winemac.so (athei/wine fa43d6db2). A retina process saw 6912x4468 there and 3456x2234 everywhere else on an M1 Pro, and Red Dead Redemption 2's 1080p fullscreen came out cropped for a player with Retina on (highball#261). With retina off the shift was by zero, so nothing else changes; only the 160 KB driver archive (winemac-focus-20261006) is new, r21 stays bundled for rollback

Gauthier Piarrettea800553ebed3
diff --git a/Scripts/build-winemac-focus.sh b/Scripts/build-winemac-focus.sh
index c54ca9c..c956b81 100755
--- a/Scripts/build-winemac-focus.sh
+++ b/Scripts/build-winemac-focus.sh
@@ -3,7 +3,7 @@
# dist/winemac-focus-<tag>.tar.xz holds winemac.so at its top level, and the manifest lays it over
# engine/lib/wine/x86_64-unix/winemac.so once the Wine archive has unpacked (order 1).
# The change itself, in source form and with the reasons, is spike/patches/winemac-sikarugir10.0-focus.patch.
-# This Sikarugir revision has no public source, so it goes in as three byte edits to Gcenx's own
+# This Sikarugir revision has no public source, so it goes in as four byte edits to Gcenx's own
# binary, each checked against the bytes it replaces: a Wine archive with any other winemac.so
# stops the build instead of patching the wrong place.
# Usage: Scripts/build-winemac-focus.sh [tag] -> prints the archive's sha256 and size
@@ -39,6 +39,8 @@ EDITS = [
'makeFocused: discard mask GOT_FOCUS|LOST_FOCUS (0x30000000) becomes LOST_FOCUS (0x20000000) (CrossOver Hack #18896)'),
(0x1c584, '741d', '9090',
'windowDidBecomeKey: no early return when Wine made the window key, so Wine hears about it (CrossOver Hack #18896)'),
+ (0x25001, '41d3e6', '0f1f00',
+ 'macdrv_GetDeviceCaps: shll %cl,%r14d (HORZRES/VERTRES doubled when retina_on) becomes a 3-byte nop, so a retina process sees the same size as GetSystemMetrics (athei fa43d6db2, highball#261)'),
]
for off, old, new, why in EDITS:
old_b, new_b = bytes.fromhex(old), bytes.fromhex(new)
diff --git a/Tests/HighballKitTests/BundledEngineTests.swift b/Tests/HighballKitTests/BundledEngineTests.swift
index c2a19cb..09e2c72 100644
--- a/Tests/HighballKitTests/BundledEngineTests.swift
+++ b/Tests/HighballKitTests/BundledEngineTests.swift
@@ -85,6 +85,8 @@ final class BundledEngineTests: XCTestCase {
/// On 2026-10-03 ntdll.so is replaced again (wineserver comes from the same archive) so data
/// execution prevention stays on under Rosetta, where Wine turning it off made every write to
/// an executable page fault (highball#165).
+ /// On 2026-10-06 winemac.so gains a fourth edit so retina mode stops doubling HORZRES and
+ /// VERTRES (highball#261), on the default line (r22) and on the D3DMetal 4 line (r23).
/// Everything else is byte-identical, so it is not downloaded again, and every new archive
/// comes from Highball's own release pages (a component URL has to be ours to stay immutable,
/// #27/#28).
@@ -98,7 +100,8 @@ final class BundledEngineTests: XCTestCase {
}
func one(_ id: String) throws -> EngineManifest { try XCTUnwrap(all.first { $0.id == id }, "\(id) missing") }
for (current, baseID) in [("x64-sikarugir10.0_6-r19", "x64-sikarugir10.0_6-r5"), ("x64-sikarugir10.0_6-r21", "x64-sikarugir10.0_6-r5"),
- ("x64-sikarugir10.0_6-r20", "x64-sikarugir10.0_6-r6")] {
+ ("x64-sikarugir10.0_6-r22", "x64-sikarugir10.0_6-r5"),
+ ("x64-sikarugir10.0_6-r20", "x64-sikarugir10.0_6-r6"), ("x64-sikarugir10.0_6-r23", "x64-sikarugir10.0_6-r6")] {
let r = try one(current), base = try one(baseID)
XCTAssertEqual(r.minMacOS, base.minMacOS, "\(current) must keep \(baseID)'s floor")
XCTAssertEqual(r.baseEnv?["D3DM_MTL4"], base.baseEnv?["D3DM_MTL4"], "\(current) must keep \(baseID)'s Metal 4 setting")
@@ -126,7 +129,7 @@ final class BundledEngineTests: XCTestCase {
// The msync fix is byte edits to the same archive's wineserver and ntdll.so
// (Scripts/build-wine10-msync.sh), one archive behind two single-file components. r21's
// archive (Scripts/build-wine10-dep.sh) carries those edits plus the DEP one.
- let archive = current == "x64-sikarugir10.0_6-r21" ? "wine10-dep-" : "wine10-msync-"
+ let archive = ["x64-sikarugir10.0_6-r21", "x64-sikarugir10.0_6-r22"].contains(current) ? "wine10-dep-" : "wine10-msync-"
for (name, into) in [("wineserver", "engine/bin/wineserver"), ("ntdll-unix", "engine/lib/wine/x86_64-unix/ntdll.so")] {
let c = try XCTUnwrap(r.components[name])
XCTAssertEqual(c.extract?.into, into, "\(current)/\(name) replaces one file, the Wine archive's own")
@@ -144,16 +147,30 @@ final class BundledEngineTests: XCTestCase {
XCTAssertTrue(audio.url.absoluteString.hasPrefix("https://github.com/gauthierpiarrette/highball-engine/releases/download/audiobuf-"),
"\(current)'s audio library must come from Highball's own release page: \(audio.url)")
}
- XCTAssertEqual(all.last?.id, "x64-sikarugir10.0_6-r21", "r21 is the default engine")
+ XCTAssertEqual(all.last?.id, "x64-sikarugir10.0_6-r22", "r22 is the default engine")
+ // r22 and r23 are r21 and r20 with only the driver changed: the retina fix rides one new
+ // archive, and every other download is reused.
+ for (fixed, before) in [("x64-sikarugir10.0_6-r22", "x64-sikarugir10.0_6-r21"), ("x64-sikarugir10.0_6-r23", "x64-sikarugir10.0_6-r20")] {
+ let r = try one(fixed), b = try one(before)
+ XCTAssertEqual(r.components["winemac"]?.version, "20261006", "\(fixed) carries the retina-fixed driver")
+ XCTAssertEqual(b.components["winemac"]?.version, "20260930", "\(before) keeps the driver it shipped with")
+ for (name, c) in b.components where name != "winemac" {
+ XCTAssertEqual(r.components[name]?.sha256, c.sha256, "\(fixed)/\(name) must be \(before)'s, only the driver changes")
+ }
+ XCTAssertEqual(r.minMacOS, b.minMacOS)
+ }
// The update to r21 moves r17 and r19 environments straight over, and leaves GPTK 4 ones (r18)
// for their own line's r20, which is where the walk must send them.
let shipped = Set(all.flatMap { $0.components.keys })
- XCTAssertTrue(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r17"), to: try one("x64-sikarugir10.0_6-r21"), shipped: shipped))
- XCTAssertTrue(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r19"), to: try one("x64-sikarugir10.0_6-r21"), shipped: shipped))
- XCTAssertFalse(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r18"), to: try one("x64-sikarugir10.0_6-r21"), shipped: shipped))
- XCTAssertEqual(EngineStore.successor(for: try one("x64-sikarugir10.0_6-r18"), among: all, shipped: shipped, macOS: "27.0")?.id,
- "x64-sikarugir10.0_6-r20")
- for rollback in ["x64-sikarugir10.0_6-r13", "x64-sikarugir10.0_6-r15", "x64-sikarugir10.0_6-r17", "x64-sikarugir10.0_6-r19"] {
+ for from in ["x64-sikarugir10.0_6-r17", "x64-sikarugir10.0_6-r19", "x64-sikarugir10.0_6-r21"] {
+ XCTAssertTrue(EngineStore.canMoveBottle(on: try one(from), to: try one("x64-sikarugir10.0_6-r22"), shipped: shipped), "\(from) moves to r22")
+ }
+ XCTAssertFalse(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r18"), to: try one("x64-sikarugir10.0_6-r22"), shipped: shipped))
+ for gptk4 in ["x64-sikarugir10.0_6-r18", "x64-sikarugir10.0_6-r20"] {
+ XCTAssertEqual(EngineStore.successor(for: try one(gptk4), among: all, shipped: shipped, macOS: "27.0")?.id,
+ "x64-sikarugir10.0_6-r23", "\(gptk4) environments stay on the D3DMetal 4 line and get its retina fix")
+ }
+ for rollback in ["x64-sikarugir10.0_6-r13", "x64-sikarugir10.0_6-r15", "x64-sikarugir10.0_6-r17", "x64-sikarugir10.0_6-r19", "x64-sikarugir10.0_6-r21"] {
XCTAssertNotNil(all.first { $0.id == rollback }, "\(rollback) stays offered for rollback")
}
}
diff --git a/spike/engine-manifest.json b/spike/engine-manifest.json
index 9578192..ff4ddb8 100644
--- a/spike/engine-manifest.json
+++ b/spike/engine-manifest.json
@@ -1,13 +1,14 @@
{
"$schema": "https://highball.app/schemas/engine-manifest/v0",
- "id": "x64-sikarugir10.0_6-r21",
- "displayName": "Wine 10.0 (Sikarugir) r21",
+ "id": "x64-sikarugir10.0_6-r22",
+ "displayName": "Wine 10.0 (Sikarugir) r22",
"arch": "x86_64",
"minMacOS": "14.0",
"requires": [
"rosetta2"
],
"notes": [
+ "r22 (2026-10-06): r21 with the Mac driver's retina screen size fixed (winemac component). Retina resolution on, the Mac driver reported HORZRES and VERTRES twice the screen size that GetSystemMetrics, EnumDisplaySettings and DESKTOPHORZRES report (6912x4468 against 3456x2234 on an M1 Pro, 7680x4320 against 3840x2160 on an M4's 1920x1080 display), so a game sizing its window or its fullscreen picture from them got it twice too large: Team Fortress 2 placed its window off screen (athei), and Red Dead Redemption 2's 1080p fullscreen came out cropped for a player with Retina on (highball#261). With retina off the doubling shift was by zero, so nothing changes there. Every other component is byte-identical, so only the 160 KB winemac archive is new.",
"r21 (2026-10-03): r19 plus the data execution prevention edit to ntdll.so (see the ntdll-unix component), the Wine 10 counterpart of the Wine 11 engine's r17. Every other file is byte-identical to r19.",
"r19 (2026-10-01): r17 plus the audio buffer library (audiobuf component, highball#127). At 48 kHz the Mac asked Wine's audio driver for 10.7 ms at a time, more than a game that keeps one 10 ms period queued has, and the driver played the shortfall as silence. Measured on an M4 with macOS 27.0 with raw captures of each game's menu music: Counter-Strike 2 went from 324 dropouts in two minutes to none, and Half-Life 2, Among Us and Five Nights at Freddy's had none either way. The cap is per process, so other apps keep their audio as it was. Every other component is byte-identical to r17, so only a 2 KB archive is new.",
"r17 (2026-10-01): r15 with msync's registration leak fixed (wineserver and ntdll-unix components, highball#224). A wait on several objects that lost a race left the thread registered in the wineserver and nothing removed it, so an object that is rarely signaled gained a list node each time: the pool ran out (\"msync: warn: node memory pool exhausted\" on every allocation after that) and the wineserver grew for as long as the game ran. Measured on an M4 with macOS 27.0 with a reproducer (a worker sets an auto-reset event in a loop while the main thread waits on two objects): r15's wineserver went from 19 MB to 83 MB in 30 s with the pool exhausted, with these two files it stayed at 17 MB with no warning and waits ran faster (about 979k a second against 596k). Heartopia (90 s) and Five Nights at Freddy's (60 s, 32-bit) ran under msync on it with a steady wineserver. Every other component is byte-identical to r15, so only a 435 KB archive is new.",
@@ -127,17 +128,17 @@
},
"winemac": {
"kind": "patch",
- "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/winemac-focus-20260930/winemac-focus-20260930.tar.xz",
- "sha256": "0192214d7d5c7cc8acd13dcacb0c27e8313ef0c64c51b91a93deff0a851a8974",
- "size": 162192,
- "license": "LGPL-2.1+ (Wine; the change in source form is spike/patches/winemac-sikarugir10.0-focus.patch)",
- "version": "20260930",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/winemac-focus-20261006/winemac-focus-20261006.tar.xz",
+ "sha256": "5bf89e7c5c1309d2e4d53c40d70ef98bba33b7d9dbff4e0976524ac537949f08",
+ "size": 162264,
+ "license": "LGPL-2.1+ (Wine; the changes in source form are spike/patches/winemac-sikarugir10.0-focus.patch and spike/patches/winemac-sikarugir10.0-retina.patch)",
+ "version": "20261006",
"order": 1,
"extract": {
"subpath": "winemac.so",
"into": "engine/lib/wine/x86_64-unix/winemac.so"
},
- "note": "The Wine archive's winemac.so (sha256 4cbf65e3…) with three byte edits, made and checked by Scripts/build-winemac-focus.sh, re-signed ad hoc under its own identifier: upstream b568eaac4a (no made-up WM_MOUSEACTIVATE when macOS gives a window focus, Wine bug 48121) and both halves of CrossOver Hack #18896 (the driver no longer drops the focus event for a window Wine made key). Replaces the file after the Wine archive unpacks (order 1)."
+ "note": "The Wine archive's winemac.so (sha256 4cbf65e3…) with four byte edits, made and checked by Scripts/build-winemac-focus.sh, re-signed ad hoc under its own identifier: upstream b568eaac4a (no made-up WM_MOUSEACTIVATE when macOS gives a window focus, Wine bug 48121), both halves of CrossOver Hack #18896 (the driver no longer drops the focus event for a window Wine made key), and in macdrv_GetDeviceCaps the shift that doubled HORZRES and VERTRES in retina mode becomes a nop (athei/wine fa43d6db2, highball#261). Replaces the file after the Wine archive unpacks (order 1)."
},
"wineserver": {
"kind": "patch",
@@ -202,10 +203,10 @@
"GST_PLUGIN_PATH": "${frameworks}/GStreamer.framework/Versions/1.0/lib/gstreamer-1.0"
},
"verified": {
- "date": "2026-10-03",
+ "date": "2026-10-06",
"macos": "27.0",
- "chip": "Apple M4",
- "result": "d3d9stall with DEP as it comes reports DEP on, Lock+write 1.3 to 1.7 s over two runs and no lock over 50 ms, where r19 spent 48 to 51 s with stalls of up to 46 s; dep=on gets STATUS_ACCESS_DENIED. Then, from the same Steam environment moved to this engine: Five Nights at Freddy's (32-bit) reached its menu on DXVK's Direct3D 9, Among Us, Counter-Strike 2 and Vindictus (Steam Connector) their windows. Nothing was played past those screens, and no program that writes code into data pages was tried."
+ "chip": "Apple M1 Pro",
+ "result": "The new winemac.so in a copy of the default engine's tree, probed with GetDeviceCaps, GetSystemMetrics and EnumDisplaySettings: Retina off, 1728x1117 everywhere, as before. Retina on, HORZRES and VERTRES 3456x2234, matching GetSystemMetrics and DESKTOPHORZRES, where the original driver gives 6912x4468. No game run on this revision yet. The published archive was downloaded and matches this manifest's checksum."
},
"licenses": {
"apple-gptk-license-2023-08-17": {
diff --git a/spike/engines/x64-sikarugir10.0_6-r21.json b/spike/engines/x64-sikarugir10.0_6-r21.json
new file mode 100644
index 0000000..9578192
--- /dev/null
+++ b/spike/engines/x64-sikarugir10.0_6-r21.json
@@ -0,0 +1,219 @@
+{
+ "$schema": "https://highball.app/schemas/engine-manifest/v0",
+ "id": "x64-sikarugir10.0_6-r21",
+ "displayName": "Wine 10.0 (Sikarugir) r21",
+ "arch": "x86_64",
+ "minMacOS": "14.0",
+ "requires": [
+ "rosetta2"
+ ],
+ "notes": [
+ "r21 (2026-10-03): r19 plus the data execution prevention edit to ntdll.so (see the ntdll-unix component), the Wine 10 counterpart of the Wine 11 engine's r17. Every other file is byte-identical to r19.",
+ "r19 (2026-10-01): r17 plus the audio buffer library (audiobuf component, highball#127). At 48 kHz the Mac asked Wine's audio driver for 10.7 ms at a time, more than a game that keeps one 10 ms period queued has, and the driver played the shortfall as silence. Measured on an M4 with macOS 27.0 with raw captures of each game's menu music: Counter-Strike 2 went from 324 dropouts in two minutes to none, and Half-Life 2, Among Us and Five Nights at Freddy's had none either way. The cap is per process, so other apps keep their audio as it was. Every other component is byte-identical to r17, so only a 2 KB archive is new.",
+ "r17 (2026-10-01): r15 with msync's registration leak fixed (wineserver and ntdll-unix components, highball#224). A wait on several objects that lost a race left the thread registered in the wineserver and nothing removed it, so an object that is rarely signaled gained a list node each time: the pool ran out (\"msync: warn: node memory pool exhausted\" on every allocation after that) and the wineserver grew for as long as the game ran. Measured on an M4 with macOS 27.0 with a reproducer (a worker sets an auto-reset event in a loop while the main thread waits on two objects): r15's wineserver went from 19 MB to 83 MB in 30 s with the pool exhausted, with these two files it stayed at 17 MB with no warning and waits ran faster (about 979k a second against 596k). Heartopia (90 s) and Five Nights at Freddy's (60 s, 32-bit) ran under msync on it with a steady wineserver. Every other component is byte-identical to r15, so only a 435 KB archive is new.",
+ "r15 (2026-09-30): r13 with the Mac driver's focus fixed (winemac component, highball#182). Wine 10.0's driver sent a game a made-up WM_MOUSEACTIVATE with a title-bar hit before giving it focus back, and Unity takes that as a click in the title bar and then ignores the focus gain: after Cmd+Tab, a click on another app or a Dock restore, Unity games kept drawing and dropped every click and key until restarted (Among Us, Umamusume, Heartopia; upstream b568eaac4a, Wine bug 48121, fixed in wine-10.6). Separately, when a game made its own window key without becoming the foreground window (Heartopia's Unity player at start), the driver dropped the focus event macOS sent back, so Wine kept the desktop as foreground and raw input never reached the game: its mouse was dead from the first frame (CrossOver Hack #18896, which CrossOver 26.3 carries). Measured on an M4 with macOS 27.0 before publishing, with this winemac.so in place: Among Us, Umamusume and Heartopia take input after every way of leaving and coming back that failed before, Heartopia takes its first click at start where it took none, Five Nights at Freddy's and the Half-Life 2 demo are unchanged, and the Steam client ran on it throughout. DXMT also carries a fix for a start-up crash (Among Us, 8 of 12 launches on r13, 0 of 12 on this build), see the dxmt component. Every other component is byte-identical to r13, so only the 160 KB winemac archive and the 19 MB DXMT archive are new.",
+ "r13 (2026-09-28): r11 with Highball's DXMT build (fork branch highball-20260928, 5c50790) in place of upstream v0.80. DXMT opens Wine's D3DKMT adapter by a LUID made from the GPU's IOKit registry ID, which this Wine's Mac driver does not assign (Wine 11's does), so no D3DKMT device existed and an Unreal game that creates a shared render target at start died with CreateTexture2D E_FAIL: ContractVille (highball#202) and the Gold Mining Simulator 2 demo (highball#215), while the same games start on the Wine 11 engines. This build no longer fails a shared texture when no D3DKMT device is there: the texture is created as a private one, which is all the game's own rendering needs, and the log says so once. Measured on an M1 Pro, macOS 27.0, before publishing: ContractVille no longer crashes at start on DXMT here (it then meets this Wine's own stall on its loading screen, a separate fault its entry describes), CloverPit's demo still runs. Every other component is byte-identical to r11, so only the 19 MB DXMT archive is new.",
+ "r11 (2026-09-27): r9 without the lsfg component. Its author asked for lsfg-metal to leave Highball over a licensing dispute he did not want to carry, so it is no longer distributed: no engine ships it and the archives come down once this build has reached everyone. Every remaining component is byte-identical to r5, so nothing new downloads. An environment already on r9 keeps the files it has; frame generation is simply not offered on this engine.",
+ "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.",
+ "r5 (2026-09-18): adds the d9vk-modern component, the DXVK-MacOS 3.1 Direct3D 9 that the withdrawn r4 candidate had put on every launch's search path, now as a directory nothing loads by itself. A game's recipe copies it beside the game with a per-program override (the legacy CS:GO copy mechanism). Every other component is byte-identical to r3, so existing downloads are reused; only the 10 MB d9vk archive is new, and it was already published for r4."
+ ],
+ "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": {
+ "extract": {
+ "into": "renderers/dxmt/wine",
+ "subpath": "highball"
+ },
+ "kind": "renderer",
+ "license": "MIT (Highball branch of DXMT: SwapDeviceContextState, cross-process opt-in)",
+ "sha256": "96feaf5d98d3c6cdc3edea9503e2891d435df8d5bfdf7d3f6998a56ec62bbd58",
+ "size": 18923969,
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/dxmt-highball-20260930T161516Z-a444716/dxmt-highball-20260930T161516Z-a444716.tar.gz",
+ "note": "DXMT from Highball's fork (gauthierpiarrette/dxmt, branch highball-20260928 at 5c50790): upstream main of 2026-09-16 (v0.80 plus five months of upstream work, among it keyed-mutex and shared-resource support and DXGI functions Steam's overlay can hook) plus four Highball changes: cross-process swapchains behind DXMT_ALLOW_CROSS_PROCESS_SWAPCHAIN (off by default), SwapDeviceContextState implemented instead of aborting, 2D textures answering IDXGISurface, and the one that matters on this Wine: a shared texture with no D3DKMT device behind it is created as a private one, with one error line, instead of failing the game. On this Wine the driver assigns GPU LUIDs of its own, so DXMT's lookup of its adapter fails (the build also tries the primary display's name, which fails here too) and there is never a D3DKMT device; before this build every shared texture then died at creation. This revision's DXMT is that branch plus a444716 (branch highball-20260930): the encoding context's Metal device is declared before the command helpers whose constructors build pipelines through it. Declared after them it was still uninitialised memory there, and a game could die at start in newComputePipelineStateWithDescriptor sent to a garbage object: Among Us's 64-bit build did in 8 of 12 launches on r13, and in none of 12 with this build. The bug is in upstream DXMT too."
+ },
+ "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-modern": {
+ "kind": "renderer",
+ "order": 1,
+ "version": "dxvk-macos-3.1-20260916",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/d9vk-dxvk-macos-3.1-20260916/d9vk-dxvk-macos-3.1-20260916.tar.xz",
+ "sha256": "0fabdffde07ef1ef041e95181ca1507db96919cf70acfa91a15c159718ad7611",
+ "size": 9766808,
+ "license": "zlib",
+ "extract": {
+ "subpath": "renderers/d9vk/wine",
+ "into": "renderers/d9vk-modern/wine"
+ },
+ "layout": [
+ "x86_64-windows/d3d9.dll",
+ "i386-windows/d3d9.dll"
+ ],
+ "note": "The metalsharp DXVK-MacOS v3.1-macos1.0 Direct3D 9 (DXVK 3.1 with the Gcenx MoltenVK work), both architectures, stamped as Wine builtins. Not on any launch's search path: the template's DXVK-Kegworks 1.10.4 d9vk stays the Direct3D 9 every game gets. A game's recipe copies this one beside the game's executable with a per-program native override when the row says the newer layer is the one that runs it (RaceRoom, highball-db#60). It rendered RaceRoom for one reporter and drew it in grayscale for another, and froze Five Nights at Freddy's, when the r4 candidate put it on every launch's path, which is why it is opt-in per game."
+ },
+ "winemac": {
+ "kind": "patch",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/winemac-focus-20260930/winemac-focus-20260930.tar.xz",
+ "sha256": "0192214d7d5c7cc8acd13dcacb0c27e8313ef0c64c51b91a93deff0a851a8974",
+ "size": 162192,
+ "license": "LGPL-2.1+ (Wine; the change in source form is spike/patches/winemac-sikarugir10.0-focus.patch)",
+ "version": "20260930",
+ "order": 1,
+ "extract": {
+ "subpath": "winemac.so",
+ "into": "engine/lib/wine/x86_64-unix/winemac.so"
+ },
+ "note": "The Wine archive's winemac.so (sha256 4cbf65e3…) with three byte edits, made and checked by Scripts/build-winemac-focus.sh, re-signed ad hoc under its own identifier: upstream b568eaac4a (no made-up WM_MOUSEACTIVATE when macOS gives a window focus, Wine bug 48121) and both halves of CrossOver Hack #18896 (the driver no longer drops the focus event for a window Wine made key). Replaces the file after the Wine archive unpacks (order 1)."
+ },
+ "wineserver": {
+ "kind": "patch",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/wine10-dep-20261003/wine10-dep-20261003.tar.xz",
+ "sha256": "be0a6de062b21b111c38aaaded76160c75ba3c167f7f6740b31cff3b8902a298",
+ "size": 434608,
+ "license": "LGPL-2.1+ (Wine; the same change in source form, for the CrossOver tree, is highball-engine's patches/0014-msync-unregister-early-return.patch, and for the DEP edit patches/0013-ntdll-nx-compat-from-main-image-permanent-under-rosetta.patch)",
+ "version": "20261003",
+ "order": 1,
+ "extract": {
+ "subpath": "wineserver",
+ "into": "engine/bin/wineserver"
+ },
+ "note": "The Wine archive's wineserver (sha256 6dfe1f9d…) with one byte edit, made and checked by Scripts/build-wine10-dep.sh (the same bytes as wine10-msync-20261001, repackaged), re-signed ad hoc under its own identifier: a wait registration that meets a signaled object at index i unregisters objects 0..i-1 whenever i > 0 (it skipped i = 1 and left object 0 registered). Replaces the file after the Wine archive unpacks (order 1). Shares its archive with the ntdll-unix component, which is downloaded once."
+ },
+ "ntdll-unix": {
+ "kind": "patch",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/wine10-dep-20261003/wine10-dep-20261003.tar.xz",
+ "sha256": "be0a6de062b21b111c38aaaded76160c75ba3c167f7f6740b31cff3b8902a298",
+ "size": 434608,
+ "license": "LGPL-2.1+ (Wine; the same change in source form, for the CrossOver tree, is highball-engine's patches/0014-msync-unregister-early-return.patch, and for the DEP edit patches/0013-ntdll-nx-compat-from-main-image-permanent-under-rosetta.patch)",
+ "version": "20261003",
+ "order": 1,
+ "extract": {
+ "subpath": "ntdll.so",
+ "into": "engine/lib/wine/x86_64-unix/ntdll.so"
+ },
+ "note": "The Wine archive's ntdll.so (sha256 8eae29d1…) with the msync edit of wine10-msync-20261001 plus one more, made and checked by Scripts/build-wine10-dep.sh, re-signed ad hoc under its own identifier: in NtSetInformationProcess the ProcessExecuteFlags case always answers STATUS_ACCESS_DENIED, as Windows's AlwaysOn policy does, so data execution prevention stays on for every process. Before, a single loaded module without IMAGE_DLLCHARACTERISTICS_NX_COMPAT (most 32-bit games from before 2010) turned it off for the whole process, every readable mapping got PROT_EXEC, and under Rosetta a writable and executable page costs a Mach round trip on first touch, so a Direct3D 9 game streaming vertices through DXVK paid for every buffer write (highball#165, athei). Measured on an M4, macOS 27.0, with athei's d3d9stall: r19 spent 48 to 51 s in Lock+write per 1500 frames with two to four stalls over a second, this file 1.3 to 1.7 s with none. A program that writes code into data pages would now fault where it used to run; none is known yet."
+ },
+ "audiobuf": {
+ "kind": "runtime",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/audiobuf-20261001/audiobuf-20261001.tar.xz",
+ "sha256": "037da88d5da0226b3e06778a2038a40d13bb278b8ff859b07eb0261b63a6f268",
+ "size": 2232,
+ "license": "MIT (Highball's own, source spike/audiobuf/audiobuf.c)",
+ "version": "20261001",
+ "order": 1,
+ "extract": {
+ "subpath": "libhbaudiobuf.dylib",
+ "into": "frameworks/libhbaudiobuf.dylib"
+ },
+ "note": "Highball's audio buffer library, built by Scripts/build-audiobuf.sh. Bottle.environment inserts it into Wine's processes with DYLD_INSERT_LIBRARIES, and it caps an output audio unit's I/O buffer at 5 ms before Wine starts it, so a game that keeps one 10 ms period queued no longer drops audio at 48 kHz (highball#127). HB_AUDIOBUF=0 in an environment's variables leaves it out."
+ }
+ },
+ "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-10-03",
+ "macos": "27.0",
+ "chip": "Apple M4",
+ "result": "d3d9stall with DEP as it comes reports DEP on, Lock+write 1.3 to 1.7 s over two runs and no lock over 50 ms, where r19 spent 48 to 51 s with stalls of up to 46 s; dep=on gets STATUS_ACCESS_DENIED. Then, from the same Steam environment moved to this engine: Five Nights at Freddy's (32-bit) reached its menu on DXVK's Direct3D 9, Among Us, Counter-Strike 2 and Vindictus (Steam Connector) their windows. Nothing was played past those screens, and no program that writes code into data pages was tried."
+ },
+ "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."
+ }
+ }
+}
diff --git a/spike/engines/x64-sikarugir10.0_6-r23.json b/spike/engines/x64-sikarugir10.0_6-r23.json
new file mode 100644
index 0000000..b9c55fd
--- /dev/null
+++ b/spike/engines/x64-sikarugir10.0_6-r23.json
@@ -0,0 +1,214 @@
+{
+ "$schema": "https://highball.app/schemas/engine-manifest/v0",
+ "id": "x64-sikarugir10.0_6-r23",
+ "displayName": "Wine 10.0 (Sikarugir) r23, D3DMetal 4.0 beta 2",
+ "arch": "x86_64",
+ "minMacOS": "27.0",
+ "requires": [
+ "rosetta2"
+ ],
+ "notes": [
+ "r23 (2026-10-06): r20, the D3DMetal 4 line for macOS 27, with the Mac driver's retina screen size fixed (winemac component), the same change as the default engine's r22. Retina resolution on, the Mac driver reported HORZRES and VERTRES twice the screen size that GetSystemMetrics, EnumDisplaySettings and DESKTOPHORZRES report (6912x4468 against 3456x2234 on an M1 Pro, 7680x4320 against 3840x2160 on an M4's 1920x1080 display), so a game sizing its window or its fullscreen picture from them got it twice too large: Team Fortress 2 placed its window off screen (athei), and Red Dead Redemption 2's 1080p fullscreen came out cropped for a player with Retina on (highball#261). With retina off the doubling shift was by zero, so nothing changes there. Every other component is byte-identical, so only the 160 KB winemac archive is new.",
+ "r20 (2026-10-01): r18 plus the audio buffer library (audiobuf component, highball#127). At 48 kHz the Mac asked Wine's audio driver for 10.7 ms at a time, more than a game that keeps one 10 ms period queued has, and the driver played the shortfall as silence. Measured on the default line (r17 with the library, see r19) on an M4 with macOS 27.0, with raw captures of each game's menu music: Counter-Strike 2 went from 324 dropouts in two minutes to none, and Half-Life 2, Among Us and Five Nights at Freddy's had none either way. The cap is per process, so other apps keep their audio as it was. Every other component is byte-identical to r18, so only a 2 KB archive is new.",
+ "r18 (2026-10-01): r16 with msync's registration leak fixed (wineserver and ntdll-unix components, highball#224). A wait on several objects that lost a race left the thread registered in the wineserver and nothing removed it, so an object that is rarely signaled gained a list node each time: the pool ran out (\"msync: warn: node memory pool exhausted\" on every allocation after that) and the wineserver grew for as long as the game ran. Measured on an M4 with macOS 27.0 with a reproducer (a worker sets an auto-reset event in a loop while the main thread waits on two objects): r16's wineserver went from 19 MB to 83 MB in 30 s with the pool exhausted, with these two files it stayed at 17 MB with no warning and waits ran faster (about 979k a second against 596k). The same two files were measured on r15 (Heartopia 90 s and Five Nights at Freddy's 60 s under msync); this line differs only by D3DMetal 4, which does not touch them. Every other component is byte-identical to r16, so only a 435 KB archive is new.",
+ "r16 (2026-09-30): r14 with the Mac driver's focus fixed (winemac component, highball#182). Wine 10.0's driver sent a game a made-up WM_MOUSEACTIVATE with a title-bar hit before giving it focus back, and Unity takes that as a click in the title bar and then ignores the focus gain: after Cmd+Tab, a click on another app or a Dock restore, Unity games kept drawing and dropped every click and key until restarted (Among Us, Umamusume, Heartopia; upstream b568eaac4a, Wine bug 48121, fixed in wine-10.6). Separately, when a game made its own window key without becoming the foreground window (Heartopia's Unity player at start), the driver dropped the focus event macOS sent back, so Wine kept the desktop as foreground and raw input never reached the game: its mouse was dead from the first frame (CrossOver Hack #18896, which CrossOver 26.3 carries). Measured on an M4 with macOS 27.0 before publishing, with this winemac.so in place: Among Us, Umamusume and Heartopia take input after every way of leaving and coming back that failed before, Heartopia takes its first click at start where it took none, Five Nights at Freddy's and the Half-Life 2 demo are unchanged, and the Steam client ran on it throughout. DXMT also carries a fix for a start-up crash (Among Us, 8 of 12 launches on r13, 0 of 12 on this build), see the dxmt component. Every other component is byte-identical to r14, so only the 160 KB winemac archive and the 19 MB DXMT archive are new.",
+ "r14 (2026-09-28): r12 with Highball's DXMT build (fork branch highball-20260928, 5c50790) in place of upstream v0.80. DXMT opens Wine's D3DKMT adapter by a LUID made from the GPU's IOKit registry ID, which this Wine's Mac driver does not assign (Wine 11's does), so no D3DKMT device existed and an Unreal game that creates a shared render target at start died with CreateTexture2D E_FAIL: ContractVille (highball#202) and the Gold Mining Simulator 2 demo (highball#215), while the same games start on the Wine 11 engines. This build no longer fails a shared texture when no D3DKMT device is there: the texture is created as a private one, which is all the game's own rendering needs, and the log says so once. Measured on an M1 Pro, macOS 27.0, before publishing: ContractVille no longer crashes at start on DXMT here (it then meets this Wine's own stall on its loading screen, a separate fault its entry describes), CloverPit's demo still runs. Every other component is byte-identical to r12, so only the 19 MB DXMT archive is new.",
+ "r12 (2026-09-27): r10 without the lsfg component. Its author asked for lsfg-metal to leave Highball over a licensing dispute he did not want to carry, so it is no longer distributed: no engine ships it and the archives come down once this build has reached everyone. Every remaining component is byte-identical to r6, so nothing new downloads. An environment already on r10 keeps the files it has; frame generation is simply not offered on this engine.",
+ "r6 = r5 with D3DMetal from Game Porting Toolkit 4.0 beta 2 (highball#85). Only D3DMetal (DirectX 12) games see a difference; DXMT and DXVK are unchanged. Offered on macOS 27 or newer.",
+ "baseEnv D3DM_MTL4=0: D3DMetal 4.0b2's Metal 4 backend ended HumanitZ's menu quietly within a minute, twice, with no message and nothing from Metal validation (which, by slowing the work, let it survive), so it is a timing bug in Apple's beta. On the Metal 3 path inside 4.0b2 the same title held for the whole run at a fifth of the memory (about 260 MB resident against 1.26 GB on r5), and The Last Caretaker demo drew at 99% GPU where r5 sat at 2% (its black screen). Set D3DM_MTL4=1 in a game's environment to try the Metal 4 backend. Measured 2026-09-19 on an M1 Pro, macOS 27.0, session locked (process, GPU load and logs; no captures).",
+ "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.",
+ "r5 (2026-09-18): adds the d9vk-modern component, the DXVK-MacOS 3.1 Direct3D 9 that the withdrawn r4 candidate had put on every launch's search path, now as a directory nothing loads by itself. A game's recipe copies it beside the game with a per-program override (the legacy CS:GO copy mechanism). Every other component is byte-identical to r3, so existing downloads are reused; only the 10 MB d9vk archive is new, and it was already published for r4."
+ ],
+ "components": {
+ "d3dmetal": {
+ "kind": "renderer",
+ "url": "https://github.com/gauthierpiarrette/highball/releases/download/engine-components/d3dmetal-4.0b2-gptk4.tar.xz",
+ "sha256": "96cbbe89b71cb07cc33bd761ae4b79452b9cdf3198593dfb779036caf85f07a9",
+ "size": 16462052,
+ "license": "apple-gptk-license-2023-08-17",
+ "version": "D3DMetal-4.0b2 (Game Porting Toolkit 4.0 beta 2, redist/lib; Apple Software Signing chain verified 2026-09-19)",
+ "order": 1,
+ "extract": {
+ "subpath": "renderers/d3dmetal",
+ "into": "renderers/d3dmetal"
+ },
+ "layout": [
+ "external/D3DMetal.framework",
+ "external/libd3dshared.dylib",
+ "wine/x86_64-windows/{d3d10,d3d11,d3d12,dxgi,nvapi64,nvngx-on-metalfx}.dll",
+ "wine/x86_64-unix/*.so -> ../../external/libd3dshared.dylib"
+ ],
+ "note": "Apple's D3DMetal from GPTK 4 (Metal 4), laid over the Template's GPTK 3 copy: rendererDir prefers renderers/d3dmetal. Same Apple licence text as GPTK 3 (identical modulo whitespace, 2026-09-19), so the same licence id and acceptance apply. The framework's own minimum is macOS 14, but it is offered on 27 or newer only, where it was measured."
+ },
+ "d3dmetal-tsshim": {
+ "extract": {
+ "into": "renderers/d3dmetal-tsshim/wine",
+ "subpath": "renderers/d3dmetal-tsshim/wine"
+ },
+ "kind": "renderer",
+ "license": "MIT",
+ "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.",
+ "order": 1,
+ "sha256": "453f33ef1442ec8d24e9a44d901d35d4d07431c05ae8318c30567facc78d9ef3",
+ "size": 46116,
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/d3dmetal-tsshim-20260915/d3dmetal-tsshim-20260915.tar.xz",
+ "version": "20260915"
+ },
+ "d9vk-modern": {
+ "extract": {
+ "into": "renderers/d9vk-modern/wine",
+ "subpath": "renderers/d9vk/wine"
+ },
+ "kind": "renderer",
+ "license": "zlib",
+ "note": "The metalsharp DXVK-MacOS v3.1-macos1.0 Direct3D 9 (DXVK 3.1 with the Gcenx MoltenVK work), both architectures, stamped as Wine builtins. Not on any launch's search path: the template's DXVK-Kegworks 1.10.4 d9vk stays the Direct3D 9 every game gets. A game's recipe copies this one beside the game's executable with a per-program native override when the row says the newer layer is the one that runs it (RaceRoom, highball-db#60). It rendered RaceRoom for one reporter and drew it in grayscale for another, and froze Five Nights at Freddy's, when the r4 candidate put it on every launch's path, which is why it is opt-in per game.",
+ "order": 1,
+ "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"
+ },
+ "dxmt": {
+ "extract": {
+ "into": "renderers/dxmt/wine",
+ "subpath": "highball"
+ },
+ "kind": "renderer",
+ "license": "MIT (Highball branch of DXMT: SwapDeviceContextState, cross-process opt-in)",
+ "sha256": "96feaf5d98d3c6cdc3edea9503e2891d435df8d5bfdf7d3f6998a56ec62bbd58",
+ "size": 18923969,
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/dxmt-highball-20260930T161516Z-a444716/dxmt-highball-20260930T161516Z-a444716.tar.gz",
+ "note": "DXMT from Highball's fork (gauthierpiarrette/dxmt, branch highball-20260928 at 5c50790): upstream main of 2026-09-16 (v0.80 plus five months of upstream work, among it keyed-mutex and shared-resource support and DXGI functions Steam's overlay can hook) plus four Highball changes: cross-process swapchains behind DXMT_ALLOW_CROSS_PROCESS_SWAPCHAIN (off by default), SwapDeviceContextState implemented instead of aborting, 2D textures answering IDXGISurface, and the one that matters on this Wine: a shared texture with no D3DKMT device behind it is created as a private one, with one error line, instead of failing the game. On this Wine the driver assigns GPU LUIDs of its own, so DXMT's lookup of its adapter fails (the build also tries the primary display's name, which fails here too) and there is never a D3DKMT device; before this build every shared texture then died at creation. This revision's DXMT is that branch plus a444716 (branch highball-20260930): the encoding context's Metal device is declared before the command helpers whose constructors build pipelines through it. Declared after them it was still uninitialised memory there, and a game could die at start in newComputePipelineStateWithDescriptor sent to a garbage object: Among Us's 64-bit build did in 8 of 12 launches on r13, and in none of 12 with this build. The bug is in upstream DXMT too."
+ },
+ "moltenvk": {
+ "extract": {
+ "into": "frameworks/libMoltenVK.dylib",
+ "subpath": "libMoltenVK.dylib"
+ },
+ "kind": "runtime",
+ "license": "Apache-2.0",
+ "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.",
+ "order": 1,
+ "sha256": "fbed7b80d6dc2aeaba6fa7047c1fe64827d5004c28029fb43c2bc34f80c35228",
+ "size": 1674937,
+ "url": "https://github.com/gauthierpiarrette/highball/releases/download/engine-components/moltenvk-1.4.1-shadow-import-1-x86_64.tar.gz",
+ "version": "1.4.1+shadow-import-1"
+ },
+ "runtime": {
+ "extract": {
+ "into": "frameworks",
+ "subpath": "Template-1.0.11.app/Contents/Frameworks"
+ },
+ "kind": "frameworks",
+ "license": "mixed (LGPL-2.1 GStreamer, Apache-2.0 MoltenVK, LGPL gnutls, ...)",
+ "sha256": "9fa15479e7ff6abd99c1d07be285fb95f41fc6991586502427152b1f7d6ccb8a",
+ "size": 84533420,
+ "url": "https://github.com/Sikarugir-App/Wrapper/releases/download/v1.0/Template-1.0.11.tar.xz"
+ },
+ "wine": {
+ "extract": {
+ "into": "engine",
+ "strip": "wswine.bundle"
+ },
+ "kind": "engine",
+ "license": "LGPL-2.1+",
+ "sha256": "9da7ee0cbf386522f3a9906943726d9c3c125dbbd9ab120e3cde80e88d6091b2",
+ "size": 166304096,
+ "url": "https://github.com/Sikarugir-App/Engines/releases/download/v1.0/WS12WineSikarugir10.0_6.tar.xz",
+ "version": "wine-10.0 (Sikarugir) revision 6"
+ },
+ "winetricks": {
+ "kind": "tool",
+ "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.",
+ "sha256": "f35c29737ca08a583569e6a3752d52fbe23333c5acfad5f16c4177d25eaf3f4b",
+ "url": "https://raw.githubusercontent.com/Winetricks/winetricks/5a59ea07513b24093bd90fad943ecf9543cf05bc/src/winetricks"
+ },
+ "winemac": {
+ "kind": "patch",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/winemac-focus-20261006/winemac-focus-20261006.tar.xz",
+ "sha256": "5bf89e7c5c1309d2e4d53c40d70ef98bba33b7d9dbff4e0976524ac537949f08",
+ "size": 162264,
+ "license": "LGPL-2.1+ (Wine; the changes in source form are spike/patches/winemac-sikarugir10.0-focus.patch and spike/patches/winemac-sikarugir10.0-retina.patch)",
+ "version": "20261006",
+ "order": 1,
+ "extract": {
+ "subpath": "winemac.so",
+ "into": "engine/lib/wine/x86_64-unix/winemac.so"
+ },
+ "note": "The Wine archive's winemac.so (sha256 4cbf65e3…) with four byte edits, made and checked by Scripts/build-winemac-focus.sh, re-signed ad hoc under its own identifier: upstream b568eaac4a (no made-up WM_MOUSEACTIVATE when macOS gives a window focus, Wine bug 48121), both halves of CrossOver Hack #18896 (the driver no longer drops the focus event for a window Wine made key), and in macdrv_GetDeviceCaps the shift that doubled HORZRES and VERTRES in retina mode becomes a nop (athei/wine fa43d6db2, highball#261). Replaces the file after the Wine archive unpacks (order 1)."
+ },
+ "wineserver": {
+ "kind": "patch",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/wine10-msync-20261001/wine10-msync-20261001.tar.xz",
+ "sha256": "c5f47326fab52d92bd072225c385365da12e615ac2b732dd51c6d085570fcac9",
+ "size": 434740,
+ "license": "LGPL-2.1+ (Wine; the same change in source form, for the CrossOver tree, is highball-engine's patches/0014-msync-unregister-early-return.patch)",
+ "version": "20261001",
+ "order": 1,
+ "extract": {
+ "subpath": "wineserver",
+ "into": "engine/bin/wineserver"
+ },
+ "note": "The Wine archive's wineserver (sha256 6dfe1f9d…) with one byte edit, made and checked by Scripts/build-wine10-msync.sh, re-signed ad hoc under its own identifier: a wait registration that meets a signaled object at index i unregisters objects 0..i-1 whenever i > 0 (it skipped i = 1 and left object 0 registered). Replaces the file after the Wine archive unpacks (order 1). Shares its archive with the ntdll-unix component, which is downloaded once."
+ },
+ "ntdll-unix": {
+ "kind": "patch",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/wine10-msync-20261001/wine10-msync-20261001.tar.xz",
+ "sha256": "c5f47326fab52d92bd072225c385365da12e615ac2b732dd51c6d085570fcac9",
+ "size": 434740,
+ "license": "LGPL-2.1+ (Wine; the same change in source form, for the CrossOver tree, is highball-engine's patches/0014-msync-unregister-early-return.patch)",
+ "version": "20261001",
+ "order": 1,
+ "extract": {
+ "subpath": "ntdll.so",
+ "into": "engine/lib/wine/x86_64-unix/ntdll.so"
+ },
+ "note": "The Wine archive's ntdll.so (sha256 8eae29d1…) with one edit, made and checked by Scripts/build-wine10-msync.sh, re-signed ad hoc under its own identifier: a wait on several objects that finds one available while its registration is in flight now calls server_remove_wait before returning, as its timeout path does, instead of leaving the wineserver holding the registration. Replaces the file after the Wine archive unpacks (order 1)."
+ },
+ "audiobuf": {
+ "kind": "runtime",
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/audiobuf-20261001/audiobuf-20261001.tar.xz",
+ "sha256": "037da88d5da0226b3e06778a2038a40d13bb278b8ff859b07eb0261b63a6f268",
+ "size": 2232,
+ "license": "MIT (Highball's own, source spike/audiobuf/audiobuf.c)",
+ "version": "20261001",
+ "order": 1,
+ "extract": {
+ "subpath": "libhbaudiobuf.dylib",
+ "into": "frameworks/libhbaudiobuf.dylib"
+ },
+ "note": "Highball's audio buffer library, built by Scripts/build-audiobuf.sh. Bottle.environment inserts it into Wine's processes with DYLD_INSERT_LIBRARIES, and it caps an output audio unit's I/O buffer at 5 ms before Wine starts it, so a game that keeps one 10 ms period queued no longer drops audio at 48 kHz (highball#127). HB_AUDIOBUF=0 in an environment's variables leaves it out."
+ }
+ },
+ "baseEnv": {
+ "DYLD_FALLBACK_FRAMEWORK_PATH": "${frameworks}",
+ "DYLD_FALLBACK_LIBRARY_PATH": "${frameworks}:${frameworks}/GStreamer.framework/Versions/1.0/lib",
+ "GST_PLUGIN_PATH": "${frameworks}/GStreamer.framework/Versions/1.0/lib/gstreamer-1.0",
+ "WINEDEBUG": "fixme-all",
+ "D3DM_MTL4": "0"
+ },
+ "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)",
+ "renderers/d3dmetal (GPTK 4.0 beta 2 redist: D3DMetal-4.0b2)"
+ ],
+ "summary": "Apple Game Porting Toolkit license: non-commercial use/distribution only; no modification; use scoped to developing, testing or evaluating games on Apple hardware.",
+ "text": "spike/d3dmetal-license.txt"
+ }
+ },
+ "verified": {
+ "date": "2026-10-06",
+ "macos": "27.0",
+ "chip": "Apple M1 Pro",
+ "result": "The new winemac.so in a copy of the default engine's tree, probed with GetDeviceCaps, GetSystemMetrics and EnumDisplaySettings: Retina off, 1728x1117 everywhere, as before. Retina on, HORZRES and VERTRES 3456x2234, matching GetSystemMetrics and DESKTOPHORZRES, where the original driver gives 6912x4468. No game run on this revision yet. The published archive was downloaded and matches this manifest's checksum."
+ }
+}
diff --git a/spike/patches/winemac-sikarugir10.0-retina.patch b/spike/patches/winemac-sikarugir10.0-retina.patch
new file mode 100644
index 0000000..61a11fa
--- /dev/null
+++ b/spike/patches/winemac-sikarugir10.0-retina.patch
@@ -0,0 +1,32 @@
+winemac: HORZRES and VERTRES are not doubled in retina mode.
+
+From athei/wine fa43d6db2 ("winemac: Don't double HORZRES and VERTRES in retina mode",
+LGPL like Wine). macdrv_GetDeviceCaps doubled both caps whenever retina mode was on, on top of
+the fallback that already reports monitors in pixels, so a retina process saw the screen twice as
+large there as through GetSystemMetrics and EnumDisplaySettings.
+
+Measured on an M4 (1920x1080 display, macOS 27.0, 2026-10-06) with a probe on x64-crossover26.3-r17,
+the same on the default Wine 10 engine: Retina resolution off, every call says 1920x1080. Retina on,
+GetSystemMetrics, EnumDisplaySettings and DESKTOPHORZRES say 3840x2160 and HORZRES/VERTRES say
+7680x4320. Team Fortress 2 centres its window from HORZRES (athei), and Red Dead Redemption 2 at
+1920x1080 fullscreen comes out cropped for a player with Retina on (highball#261).
+
+--- a/dlls/winemac.drv/gdi.c
++++ b/dlls/winemac.drv/gdi.c
+@@ -213,15 +213,10 @@ static INT macdrv_GetDeviceCaps(PHYSDEV dev, INT cap)
+ case VERTSIZE:
+ ret = vert_size;
+ break;
+- case HORZRES:
+- case VERTRES:
+ default:
+ pthread_mutex_unlock(&device_data_mutex);
+ dev = GET_NEXT_PHYSDEV( dev, pGetDeviceCaps );
+- ret = dev->funcs->pGetDeviceCaps( dev, cap );
+- if ((cap == HORZRES || cap == VERTRES) && retina_on)
+- ret *= 2;
+- return ret;
++ return dev->funcs->pGetDeviceCaps( dev, cap );
+ }
+
+ TRACE("cap %d -> %d\n", cap, ret);