Skip to content

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

Games no longer break up their sound into short silences (highball#127, #187)

Gauthier Piarrette94e3bfbced85
diff --git a/Scripts/build-audiobuf.sh b/Scripts/build-audiobuf.sh
new file mode 100755
index 0000000..55ab7c5
--- /dev/null
+++ b/Scripts/build-audiobuf.sh
@@ -0,0 +1,17 @@
+#!/bin/zsh
+# Build the audio buffer library as an engine component: dist/audiobuf-<tag>.tar.xz holds
+# libhbaudiobuf.dylib (x86_64 for Wine's processes, arm64 so an arm64 helper Wine starts can load it
+# too), ad hoc signed like the engine's other libraries. The manifest lays it at
+# frameworks/libhbaudiobuf.dylib, and Bottle.environment inserts it when it is there (highball#127).
+# Usage: Scripts/build-audiobuf.sh [tag] -> prints the archive's sha256 and size
+set -euo pipefail
+cd "$(dirname "$0")/.."
+TAG="${1:-$(date +%Y%m%d)}"
+OUT=dist/audiobuf; rm -rf "$OUT"; mkdir -p "$OUT" dist
+clang -arch x86_64 -arch arm64 -dynamiclib -O2 -mmacosx-version-min=14.0 -o "$OUT/libhbaudiobuf.dylib" spike/audiobuf/audiobuf.c \
+ -framework AudioToolbox -framework CoreAudio
+codesign -f -s - "$OUT/libhbaudiobuf.dylib"
+codesign -v "$OUT/libhbaudiobuf.dylib"
+lipo -info "$OUT/libhbaudiobuf.dylib"
+tar -C "$OUT" -cJf "dist/audiobuf-$TAG.tar.xz" libhbaudiobuf.dylib
+echo "dist/audiobuf-$TAG.tar.xz sha256 $(shasum -a 256 "dist/audiobuf-$TAG.tar.xz" | cut -d' ' -f1) size $(stat -f %z "dist/audiobuf-$TAG.tar.xz")"
diff --git a/Sources/HighballKit/Bottle.swift b/Sources/HighballKit/Bottle.swift
index 8ab4879..9a67d73 100644
--- a/Sources/HighballKit/Bottle.swift
+++ b/Sources/HighballKit/Bottle.swift
@@ -798,6 +798,16 @@ public struct Bottle: Sendable {
env["DISABLE_LSFGM"] = "1"
if case .unavailable(let reason) = frameGeneration { env["HB_LSFG_UNAVAILABLE"] = reason }
}
+ // Wine's Mac audio driver let the device pull its whole buffer at once, 10.7 ms at 48 kHz,
+ // more than a game that keeps one 10 ms period queued has, and played the shortfall as
+ // silence: 324 dropouts in two minutes of Counter-Strike 2's menu (highball#127, Deadlock
+ // #187). An engine that ships libhbaudiobuf.dylib gets it inserted into Wine's processes,
+ // where it caps the audio unit's buffer at 5 ms. HB_AUDIOBUF=0 in an environment's
+ // variables leaves it out.
+ if let lib = engine.audioBufferLibrary, env["HB_AUDIOBUF"] != "0" {
+ let inserted = (env["DYLD_INSERT_LIBRARIES"] ?? "").split(separator: ":").map(String.init)
+ env["DYLD_INSERT_LIBRARIES"] = ([lib.path] + inserted.filter { $0 != lib.path }).joined(separator: ":")
+ }
return env
}
diff --git a/Sources/HighballKit/EngineStore.swift b/Sources/HighballKit/EngineStore.swift
index 05c0017..903907a 100644
--- a/Sources/HighballKit/EngineStore.swift
+++ b/Sources/HighballKit/EngineStore.swift
@@ -501,6 +501,12 @@ public struct InstalledEngine: Sendable {
}
public var engineDir: URL { root.appending(path: "engine", directoryHint: .isDirectory) }
public var frameworksDir: URL { root.appending(path: "frameworks", directoryHint: .isDirectory) }
+ /// The library that keeps Wine's audio pulls under half a period (highball#127), when the
+ /// engine ships it as a component. Bottle.environment inserts it into Wine's processes.
+ public var audioBufferLibrary: URL? {
+ let lib = frameworksDir.appending(path: "libhbaudiobuf.dylib")
+ return FileManager.default.fileExists(atPath: lib.path) ? lib : nil
+ }
public var renderersDir: URL { root.appending(path: "renderers", directoryHint: .isDirectory) }
public var wineBinary: URL { engineDir.appending(path: "bin/wine") }
public var wineserverBinary: URL { engineDir.appending(path: "bin/wineserver") }
diff --git a/Sources/HighballKit/SteamRestart.swift b/Sources/HighballKit/SteamRestart.swift
index 490d4ae..04d411f 100644
--- a/Sources/HighballKit/SteamRestart.swift
+++ b/Sources/HighballKit/SteamRestart.swift
@@ -81,6 +81,12 @@ public enum SteamRestart {
if liveFrameGen != wantedFrameGen {
reasons.append("it runs with frame generation \(frameGenerationName(of: live)) and the game wants \(frameGenerationName(of: wanted))")
}
+ // A library inserted into Wine's processes (the audio buffer fix, highball#127) loads when a
+ // process starts and the game inherits it from the client, so a client started without it
+ // would hand the game a launch without it.
+ if live["DYLD_INSERT_LIBRARIES"] != wanted["DYLD_INSERT_LIBRARIES"] {
+ reasons.append("it runs with different inserted libraries than the game wants")
+ }
// The game inherits the client's DLL overrides too, and two of their sources are not in
// `custom`: the environment's DLL overrides field and a recipe's dllOverride steps. So
// winhttp=n,b added while Steam ran never reached the game, and a mod loader sitting
diff --git a/Tests/HighballKitTests/BundledEngineTests.swift b/Tests/HighballKitTests/BundledEngineTests.swift
index b7580a3..1cd034f 100644
--- a/Tests/HighballKitTests/BundledEngineTests.swift
+++ b/Tests/HighballKitTests/BundledEngineTests.swift
@@ -45,7 +45,8 @@ final class BundledEngineTests: XCTestCase {
/// v0.80's D3DKMT adapter lookup fails on this Wine and every shared texture then died at
/// creation (ContractVille, highball#202). The Mac driver's winemac.so is replaced on
/// 2026-09-30 so a game gets its focus back after the player leaves it (highball#182), and
- /// wineserver and ntdll.so on 2026-10-01 so msync stops leaking wait registrations (highball#224).
+ /// wineserver and ntdll.so on 2026-10-01 so msync stops leaking wait registrations (highball#224),
+ /// and the audio buffer library is added the same day so games stop dropping sound (highball#127).
/// 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).
@@ -58,12 +59,12 @@ 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-r17", "x64-sikarugir10.0_6-r5"), ("x64-sikarugir10.0_6-r18", "x64-sikarugir10.0_6-r6")] {
+ for (current, baseID) in [("x64-sikarugir10.0_6-r19", "x64-sikarugir10.0_6-r5"), ("x64-sikarugir10.0_6-r20", "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")
- XCTAssertEqual(Set(r.components.keys), Set(base.components.keys).union(["winemac", "wineserver", "ntdll-unix"]),
- "\(current) has exactly \(baseID)'s components plus the driver and the msync fix")
+ XCTAssertEqual(Set(r.components.keys), Set(base.components.keys).union(["winemac", "wineserver", "ntdll-unix", "audiobuf"]),
+ "\(current) has exactly \(baseID)'s components plus the driver, the msync fix and the audio library")
for (name, component) in base.components where name != "dxmt" {
XCTAssertEqual(r.components[name]?.sha256, component.sha256, "\(name) drifted from \(baseID), so its download is not reused")
}
@@ -94,16 +95,23 @@ final class BundledEngineTests: XCTestCase {
}
XCTAssertEqual(r.components["wineserver"]?.sha256, r.components["ntdll-unix"]?.sha256, "both files come from one archive, downloaded once")
XCTAssertFalse(EngineManifest.needsPrefixRefresh(from: base, to: r), "\(current) keeps the Wine archive, so environments move without the Windows setup")
+
+ // The audio library lands where InstalledEngine.audioBufferLibrary looks for it, from
+ // Highball's own release page.
+ let audio = try XCTUnwrap(r.components["audiobuf"])
+ XCTAssertEqual(audio.extract?.into, "frameworks/libhbaudiobuf.dylib", "\(current)'s audio library must land where Bottle.environment looks")
+ 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-r17", "r17 is the default engine")
- // The update to r17 moves r15 environments straight over, and leaves GPTK 4 ones (r16) for
- // their own line's r18, which is where the walk must send them.
+ XCTAssertEqual(all.last?.id, "x64-sikarugir10.0_6-r19", "r19 is the default engine")
+ // The update to r19 moves r17 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-r15"), to: try one("x64-sikarugir10.0_6-r17"), shipped: shipped))
- XCTAssertFalse(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r16"), to: try one("x64-sikarugir10.0_6-r17"), shipped: shipped))
- XCTAssertEqual(EngineStore.successor(for: try one("x64-sikarugir10.0_6-r16"), among: all, shipped: shipped, macOS: "27.0")?.id,
- "x64-sikarugir10.0_6-r18")
- for rollback in ["x64-sikarugir10.0_6-r13", "x64-sikarugir10.0_6-r15"] {
+ XCTAssertTrue(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r17"), to: try one("x64-sikarugir10.0_6-r19"), shipped: shipped))
+ XCTAssertFalse(EngineStore.canMoveBottle(on: try one("x64-sikarugir10.0_6-r18"), to: try one("x64-sikarugir10.0_6-r19"), 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"] {
XCTAssertNotNil(all.first { $0.id == rollback }, "\(rollback) stays offered for rollback")
}
}
diff --git a/Tests/HighballKitTests/EnvironmentTests.swift b/Tests/HighballKitTests/EnvironmentTests.swift
index 9f83abe..cd5bbc1 100644
--- a/Tests/HighballKitTests/EnvironmentTests.swift
+++ b/Tests/HighballKitTests/EnvironmentTests.swift
@@ -241,6 +241,23 @@ final class EnvironmentTests: XCTestCase {
return engine
}
+ /// highball#127: an engine that ships the audio buffer library gets it inserted into Wine's
+ /// processes, a library the player set keeps its place after it, and HB_AUDIOBUF=0 leaves it out.
+ func testTheAudioBufferLibraryIsInsertedOnlyWhenTheEngineShipsIt() throws {
+ let engine = try d3dmetalEngine()
+ defer { try? FileManager.default.removeItem(at: engine.root) }
+ var bottle = Bottle(url: URL(fileURLWithPath: "/tmp/hb-test-bottle"), settings: BottleSettings(name: "t", engineID: engine.id))
+ XCTAssertNil(try bottle.environment(engine: engine)["DYLD_INSERT_LIBRARIES"], "an engine without the library inserts nothing")
+ let lib = engine.frameworksDir.appending(path: "libhbaudiobuf.dylib")
+ try Data().write(to: lib)
+ XCTAssertEqual(try bottle.environment(engine: engine)["DYLD_INSERT_LIBRARIES"], lib.path)
+ bottle.settings.environment["DYLD_INSERT_LIBRARIES"] = "/x/own.dylib"
+ XCTAssertEqual(try bottle.environment(engine: engine)["DYLD_INSERT_LIBRARIES"], "\(lib.path):/x/own.dylib",
+ "a library the player inserts stays, after ours")
+ bottle.settings.environment["HB_AUDIOBUF"] = "0"
+ XCTAssertEqual(try bottle.environment(engine: engine)["DYLD_INSERT_LIBRARIES"], "/x/own.dylib", "HB_AUDIOBUF=0 leaves ours out")
+ }
+
// d3dmetal ships 64-bit only, so 32-bit direct3d 10/11 goes to dxmt after it, not to wined3d
func testD3DMetalFallsBackToDXMTFor32BitGames() throws {
let engine = try d3dmetalEngine()
diff --git a/Tests/HighballKitTests/SteamRestartTests.swift b/Tests/HighballKitTests/SteamRestartTests.swift
index 160b605..7228b4c 100644
--- a/Tests/HighballKitTests/SteamRestartTests.swift
+++ b/Tests/HighballKitTests/SteamRestartTests.swift
@@ -127,4 +127,13 @@ final class SteamRestartTests: XCTestCase {
XCTAssertEqual(SteamRestart.rendererName(ofLive: ["WINEDLLPATH_PREPEND": "/e/x/renderers/dxmt/wine:\(base)/d9vk/wine"]), "dxmt")
XCTAssertEqual(SteamRestart.rendererName(ofLive: [:]), "wined3d")
}
+
+ /// The audio buffer library loads when a process starts and the game inherits it from the
+ /// client, so a client running without it is restarted for a launch that wants it (highball#127).
+ func testAClientWithoutTheAudioLibraryIsRestartedForALaunchThatWantsIt() {
+ let base = ["WINEDLLPATH_PREPEND": "/e/dxmt", "WINEMSYNC": "1"]
+ var wanted = base; wanted["DYLD_INSERT_LIBRARIES"] = "/e/frameworks/libhbaudiobuf.dylib"
+ XCTAssertNotNil(SteamRestart.reason(live: base, wanted: wanted, wantedRenderer: "dxmt"))
+ XCTAssertNil(SteamRestart.reason(live: wanted, wanted: wanted, wantedRenderer: "dxmt"))
+ }
}
diff --git a/spike/audiobuf/audiobuf.c b/spike/audiobuf/audiobuf.c
new file mode 100644
index 0000000..8ffdea6
--- /dev/null
+++ b/spike/audiobuf/audiobuf.c
@@ -0,0 +1,34 @@
+/* audiobuf: loaded into Wine's processes with DYLD_INSERT_LIBRARIES, it caps an output audio
+ * unit's I/O buffer at 5 ms (half of Wine's 10 ms shared-mode period) just before Wine starts the
+ * unit. The device otherwise asks Wine's render callback for its whole buffer at once, 512 frames,
+ * 10.7 ms at 48 kHz, and a game that keeps about one period queued (Counter-Strike 2) then had too
+ * little at most pulls and Wine played the rest as silence (highball#127). The buffer size is per
+ * process. Shipped as an engine component for the Sikarugir builds, whose Wine has no source to patch;
+ * the Wine 11 engine carries the same cap in its own winecoreaudio (highball-engine patch 0015).
+ * Build: Scripts/build-audiobuf.sh */
+#include <AudioToolbox/AudioToolbox.h>
+#include <CoreAudio/CoreAudio.h>
+#include <stdio.h>
+#include <stdlib.h>
+
+static OSStatus hb_AudioUnitInitialize(AudioUnit unit)
+{
+ AudioStreamBasicDescription hw;
+ UInt32 hw_size = sizeof(hw), cur = 0, cur_size = sizeof(cur);
+ if (AudioUnitGetProperty(unit, kAudioUnitProperty_StreamFormat, kAudioUnitScope_Output, 0, &hw, &hw_size) == noErr
+ && hw.mSampleRate > 0
+ && AudioUnitGetProperty(unit, kAudioDevicePropertyBufferFrameSize, kAudioUnitScope_Global, 0, &cur, &cur_size) == noErr) {
+ UInt32 frames = (UInt32)(hw.mSampleRate * 0.005);
+ if (frames > 0 && cur > frames) {
+ OSStatus st = AudioUnitSetProperty(unit, kAudioDevicePropertyBufferFrameSize, kAudioUnitScope_Global, 0, &frames, sizeof(frames));
+ if (getenv("HB_AUDIOBUF_DEBUG"))
+ fprintf(stderr, "audiobuf: I/O buffer %u -> %u frames at %.0f Hz, status %d\n", (unsigned)cur, (unsigned)frames, hw.mSampleRate, (int)st);
+ }
+ }
+ return AudioUnitInitialize(unit);
+}
+
+__attribute__((used)) static const struct { const void *replacement; const void *replacee; } interposers[]
+ __attribute__((section("__DATA,__interpose"))) = {
+ { (const void *)hb_AudioUnitInitialize, (const void *)AudioUnitInitialize },
+};
diff --git a/spike/engine-manifest.json b/spike/engine-manifest.json
index b536079..4033b8a 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-r17",
- "displayName": "Wine 10.0 (Sikarugir, focus and msync fixes) + DXMT (Highball build, 2026-09) + D3DMetal 3.0 + MoltenVK 1.4.1 (shadow-import patch) + DXVK 3.1 macOS fork Direct3D 9 (opt-in per game)",
+ "id": "x64-sikarugir10.0_6-r19",
+ "displayName": "Wine 10.0 (Sikarugir, focus, msync and audio fixes) + DXMT (Highball build, 2026-09) + D3DMetal 3.0 + MoltenVK 1.4.1 (shadow-import patch) + DXVK 3.1 macOS fork Direct3D 9 (opt-in per game)",
"arch": "x86_64",
"minMacOS": "14.0",
"requires": [
"rosetta2"
],
"notes": [
+ "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.",
@@ -164,6 +165,20 @@
"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."
}
},
"alternatives": {
@@ -189,7 +204,7 @@
"date": "2026-10-01",
"macos": "27.0",
"chip": "Apple M4",
- "result": "r15 with this manifest's wineserver and ntdll.so placed by hand (engine copy x64-sikarugir10.0_6-r15t): a new environment boots, the msync reproducer runs with a flat wineserver and no pool warning, Heartopia and Five Nights at Freddy's run under msync through Steam. The published archive was downloaded and matches this manifest's checksum."
+ "result": "The library measured on r17 placed by hand (DYLD_INSERT_LIBRARIES on the environment): Counter-Strike 2 324 dropouts to none, Half-Life 2, Among Us and Five Nights at Freddy's unchanged at none, each game started and played its menu. The published archive was downloaded and matches this manifest's checksum."
},
"licenses": {
"apple-gptk-license-2023-08-17": {
diff --git a/spike/engines/x64-crossover26.3-r14.json b/spike/engines/x64-crossover26.3-r14.json
new file mode 100644
index 0000000..52ffc32
--- /dev/null
+++ b/spike/engines/x64-crossover26.3-r14.json
@@ -0,0 +1,145 @@
+{
+ "$schema": "https://highball.app/schemas/engine-manifest/v0",
+ "arch": "x86_64",
+ "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",
+ "DXMT_ALLOW_CROSS_PROCESS_SWAPCHAIN": "1"
+ },
+ "components": {
+ "d3dmetal-tsshim": {
+ "extract": {
+ "into": "renderers/d3dmetal-tsshim/wine",
+ "subpath": "renderers/d3dmetal-tsshim/wine"
+ },
+ "kind": "renderer",
+ "layout": [
+ "x86_64-windows/d3d12.dll"
+ ],
+ "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"
+ },
+ "dxmt": {
+ "extract": {
+ "into": "renderers/dxmt/wine",
+ "subpath": "highball"
+ },
+ "kind": "renderer",
+ "license": "MIT (Highball branch of DXMT: SwapDeviceContextState, cross-process opt-in)",
+ "sha256": "0b86f0c793e99ae88bb4ff5f8575403ad138598a44a90248c71d6bc3ec18923b",
+ "size": 18922634,
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/dxmt-highball-20260904T194518Z-7421db2/dxmt-highball-20260904T194518Z-7421db2.tar.gz"
+ },
+ "moltenvk": {
+ "extract": {
+ "into": "frameworks/libMoltenVK.dylib",
+ "subpath": "libMoltenVK.dylib"
+ },
+ "kind": "runtime",
+ "license": "Apache-2.0",
+ "note": "MoltenVK 1.4.2 rebuilt with two Highball patches (spike/patches/moltenvk-shadow-import.patch and moltenvk-linear-fallback.patch, Scripts/build-moltenvk.sh). Shadow import is off unless a launch sets MVK_SHADOW_IMPORT=1 (32-bit native-Vulkan games such as The Sims Legacy Collection). Linear fallback is always on: a linear-tiled image that Metal cannot back with linear memory (3D, mipmapped or array images) is created with optimal tiling instead of failing vkCreateImage, which is what takes Red Dead Redemption 2 from an exit at 98 per cent to the main menu and the story.",
+ "order": 1,
+ "sha256": "d54eda91b65a8aa72a5242a87181394495b5cc88ea3d58ef1a5ce8240a2bc447",
+ "size": 1728530,
+ "url": "https://github.com/gauthierpiarrette/highball/releases/download/engine-components/moltenvk-1.4.2-shadow-import-1-linear-fallback-1-x86_64.tar.gz",
+ "version": "1.4.2+shadow-import-1+linear-fallback-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",
+ "subpath": "engine"
+ },
+ "kind": "engine",
+ "license": "LGPL-2.1+",
+ "note": "Built from CodeWeavers' crossover-sources-26.3.0.tar.gz (sha pinned in highball-engine/inputs.json) by highball-engine's build workflow with patches 0001-0003, 0005-0012, 0014 and 0015, from the audio-trial branch (main without the held 0013). 0009 swaps %gs:0x20 between Tib.FiberData (what PE code reads as GetCurrentFiber()) and the pthread QoS class (what macOS's libdispatch and pthread read) at every crossing between PE and unix code, so a fiber-based game no longer corrupts the scheduling slot: with 0008 alone Metaphor: ReFantazio opened a black window and hung in libdispatch. Stripped; Wine Mono 10.4.1 and Gecko 2.47.4 included.",
+ "sha256": "6777facb2b76577aa2d3d669f829ddff9701d8d61a4f7910ce2e48ed63fb177c",
+ "size": 334863665,
+ "url": "https://github.com/gauthierpiarrette/highball-engine/releases/download/engine-wine-11.0-20261001T024555Z-0015-coreaudio-trial/engine-wine-11.0-20261001T024555Z-0015-coreaudio-trial.tar.gz",
+ "version": "wine-11.0 (CrossOver 26.3 tree) Highball build 2026-10-01, patches 0001-0012, 0014 and 0015 (0015: winecoreaudio keeps the device I/O buffer under half a period)"
+ },
+ "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"
+ },
+ "nvapi-stub": {
+ "extract": {
+ "into": "engine/lib/wine/i386-windows/nvapi.dll",
+ "subpath": "nvapi.dll"
+ },
+ "kind": "runtime",
+ "license": "MIT (Highball)",
+ "order": 1,
+ "note": "A 32-bit nvapi.dll stub (spike/nvapi-stub, 40 lines of C) placed in the engine's i386 DLL directory with Wine's builtin marker. Games that see an NVIDIA adapter insist on NVIDIA's driver library and load it from the system directory only, so a stub beside the game does nothing; this one answers NvAPI_Initialize with OK and everything else with 'not implemented'. It only matters for a bottle or application given an NVIDIA identity (Highball's default is AMD), which is what lets legacy CS:GO pass its shadow-map check on wined3d.",
+ "sha256": "cbda8aeee87e84ecf98c06759d2123b073dc99a7aa1c639480fade33383d18a2",
+ "size": 1759,
+ "url": "https://github.com/gauthierpiarrette/highball/releases/download/engine-components/nvapi-stub-2-i386.tar.gz",
+ "version": "2",
+ "refreshesPrefix": true
+ }
+ },
+ "displayName": "Wine 11.0 (CrossOver 26.3) r14",
+ "id": "x64-crossover26.3-r14",
+ "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)"
+ ],
+ "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"
+ }
+ },
+ "minMacOS": "14.0",
+ "notes": [
+ "r14 (2026-10-01): r13 plus patch 0015. Wine's audio driver let the Mac pull its whole buffer at once, 10.7 ms at 48 kHz, more than a game that keeps one 10 ms period queued has, and played the shortfall as silence (highball#127). The driver now sets the audio unit's buffer to half its period before starting it. Measured on an M4 with macOS 27.0: Counter-Strike 2's menu music over the same 95 s had 20 dropouts on r12 and none with this build's driver. Every other component is byte-identical to r13.",
+ "r13 (2026-10-01): r12 plus patch 0014. A wait on several objects under msync that returned early left the thread registered in the wineserver, and nothing ever removed it, so a long session filled msync's node pool (\"msync: warn: node memory pool exhausted\", 242 million lines in one My Summer Car log) and the wineserver grew until the game stalled (highball#224). Measured on an M4 with macOS 27.0 with a reproducer: r12's wineserver went from 30 MB to 77 MB in 30 s, r13's stayed at 39 MB for 2 minutes with no warning, waits no slower. Heartopia ran 90 s under msync on it with a steady wineserver. Every other component is byte-identical to r12.",
+ "r12 (2026-09-24): r11 plus patch 0012, athei's x87sidecar cooperative attach with a loader check. The check alone changes every 32-bit launch: get_alternate_wineloader() used to name an i386-unix loader that does not exist in this wow64-only build, and env.c then relaunched the program through start.exe /exec, so every 32-bit game ran as a child of a detached start.exe. Measured 2026-09-24: two processes on r11, one on this build. With ROSETTA_X87_PATH pointing at athei's x87sidecar (not shipped yet) an i386 program is accelerated: Half-Life 2 timedemo 131 to 174 fps on wined3d, M1 Pro, macOS 27.0, measured on the 6788a14 trial build with WINEARCH=wow64; on this build the attach was verified with a test program only. Every other component is byte-identical to r11. Smoked 2026-09-24 on a clone of re-w11: The Last Flame (DXMT) and Five Nights at Freddy's (Wine's own Direct3D) draw, the 32-bit game runs as one process.",
+ "Known on r11 and r12 (highball#198, 2026-09-24, cause found 2026-09-25): a Direct3D 9 game on the DXVK mode gets a window that never draws and every memory mapping fails with VK_ERROR_OUT_OF_HOST_MEMORY when the environment carries MVK_SHADOW_IMPORT=1, which the Sims recipe set for the whole environment; Highball 0.9.38 scopes a game recipe's variables to that game. Until then remove that line from the environment's variables when not playing the Sims there, or use Wine's own Direct3D for the game, which is also the faster mode on these engines (Five Nights at Freddy's 40 fps on DXVK against 76 on the default engine's).",
+ "r11 (2026-09-20): r10 with patches 0010 and 0011. 0010 (Proton 164af86d): the Media Foundation source reader lets the video processor's allocator create sample textures, so a game's media player gets a real shared handle from DXMT instead of null (The Last Flame's menu video now plays, highball#99; 3Shain/dxmt#135). 0011: on macOS %gs:0x68, where MSVC-built code such as Unity's Mono reads GetLastError() directly, is kept in step with TEB->LastErrorValue, so a Unity game's error paths no longer see garbage (The Last Flame's Start threw IOException Unknown error on a missing save). DXMT_ALLOW_CROSS_PROCESS_SWAPCHAIN=1 is in the base environment: CEF launcher windows paint on Wine 11 with it. Known: winedmo.so still links a Homebrew FFmpeg 9 the engine does not ship, so Wine's MF sources fall back to GStreamer; unchanged from r10.",
+ "r10 (2026-09-15): r9 with MoltenVK 1.4.2 (July 2026) in place of 1.4.1, same two Highball patches. 1.4.2 fixes heap placement checks, imported texture residency, cached texture invalidation and an occlusion query crash, all candidates for Red Dead Redemption 2's trees popping in and out on Apple Silicon (highball#93). A candidate engine, not the default: pick it under Advanced. Everything else is byte-identical to r9.",
+ "r9 (2026-09-15): r8 with the d3dmetal-tsshim component rebuilt so its exports carry Microsoft's d3d12 ordinals (D3D12CreateDevice at 101), which D3DMetal mirrors. The earlier 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). The Wine build and every other component are byte-identical to r8, so existing downloads are reused; only the 46 KB shim tarball is new.",
+ "r8 (2026-09-12): r7 plus patch 0009, the fiber and QoS slot swap. On r5 to r7 a game whose job threads switch fibers and also drive the window could hang black at full CPU, because the fiber pointer the 0008 mirror keeps in the thread slot is what macOS reads there as the thread's QoS class (Metaphor: ReFantazio, highball#80, measured with its free demo). r8 gives the slot to whichever side is running. Nothing else changed from r7.",
+ "r7 (2026-09-11): r6 plus a 32-bit NVAPI stub in the engine. With it, legacy CS:GO plays on macOS 26 through wined3d with an NVIDIA identity scoped to csgo.exe (the csgo-legacy recipe), the route CrossOver users take: DXVK's D3D9 on this Mac either loses the device on Source's HDR pass or stalls after the map load, and wined3d needs the NVIDIA shadow-map path, which needs NVAPI to answer. Nothing else changed from r6.",
+ "r6 (2026-09-11): r5 plus the MoltenVK linear-fallback patch. Red Dead Redemption 2 loads, reaches its main menu and starts the story on this engine (M1 Pro, macOS 26.6.2, 1280x720 windowed, about 60 fps in menus); every earlier engine exits at 98 per cent of the first load because MoltenVK refuses the game's linear 3D, mipmapped and array images. Nothing else changed from r5.",
+ "r5 (2026-09-09): r4 plus patch 0008, the fiber mirror. Marvel's Guardians of the Galaxy reaches gameplay on this engine and crashes on Play Game on every earlier one, verified twice from a clean start on an M1 Pro, macOS 26.6.2, at 27.5 fps in the opening scene. A reproducer that needs no game (private/notes/fibertest4.c) faults identically to the game on r4 and runs clean here.",
+ "Cost of 0008, measured: offset 0x20 holds the thread's pthread QoS class on macOS, so a thread that uses fibers loses that scheduling hint. Windows and macOS both fix that offset, so a correct GetCurrentFiber() and an intact QoS cache cannot coexist. Confined to threads that call the fiber APIs, and a stress run of 8 threads and 6.4M switches showed TLS and thread creation unaffected (320000 wrong fiber values on r4, 0 here).",
+ "Optional engine (2026-09-07): Highball's own build of the CrossOver 26.3 Wine tree (Wine 11.0) with the same DXMT, D3DMetal, MoltenVK and Template runtime as the default engine. Not the default: a bottle moves to it from its Advanced settings, or Highball offers it when a launcher's recipe names it (the EA app). Verified here: EA app install and sign-in, The Sims 4 through it (DXMT, 128 fps on an M1 Pro), Steam with GTA V install, Rockstar launcher sign-in window, Ubisoft Connect window.",
+ "Games were not re-verified on this engine (CS:GO's cascaded shadow maps are known to differ), which is why it is offered for the launchers that need it, one environment at a time, and never becomes the default on its own. Steam's own client renders here (CEF), as do the Rockstar and Ubisoft sign-in windows; their account services were the wall in testing, not the engine.",
+ "Why it exists: Wine 10 (the default engine) cannot start the EA app's vital background service or run its .NET setup steps, and its winemac lacks the cross-process remote-layer route that the Rockstar and Ubisoft launchers' browsers need (highball#15, #56, #60). This tree carries Highball's patches for both.",
+ "Three patches make the tree behave like the default engine: the Windows user follows the macOS user (CrossOver hack 12735 reverted), WINEDLLPATH_PREPEND is honoured so the renderer overlays apply, and wined3d's automatic renderer is OpenGL first as upstream. winemac.so exports macdrv_functions, so the DXMT and D3DMetal bridges work. This engine ships no winemetal.dll of its own; the DXMT overlay carries it. Wine Mono and Gecko are included.",
+ "DXMT here is Highball's branch (cross-process swapchains, DXMT_ALLOW_CROSS_PROCESS_SWAPCHAIN=1), needed by the EA client. D3DMetal is the Template's 3.0 with the timestamp shim in front, as on the default engine. Accepted licences carry over when a bottle moves.",
+ "Moving a bottle here re-runs the Windows setup (different Wine build); moving back is the same step. Nothing installed in the bottle is removed either way.",
+ "r11, the base environment (2026-09-18): DXMT_ALLOW_CROSS_PROCESS_SWAPCHAIN=1 for every process. On the Wine 11 tree, browser UIs whose GPU process draws into another process's window need it or DXMT refuses the swapchain: Rockstar's sign-in then paints (verified 2026-09-05 and 2026-09-18), Battle.net's client stops crashing but its window stays black, and Steam's window comes into being where two cold starts without the flag created none, but it too stays black (measured on r10, 2026-09-18). So the flag is necessary on Wine 11 and not sufficient for Steam or Battle.net; the black browser is a separate Wine 11 problem still open.",
+ "Direct3D 9 on this engine (0.9.38): in the automatic modes, DXMT and D3DMetal, a Direct3D 9 game uses Wine's own Direct3D, because DXVK's d3d9 on this tree is the slow path (Half-Life 2 131 fps on wined3d against 17 on DXVK, Five Nights at Freddy's 40 fps on DXVK against 76 with the Wine 10 engine's DXVK, measured 2026-09-24/25, highball#198). The explicit DXVK mode still gets DXVK's d3d9."
+ ],
+ "requires": [
+ "rosetta2"
+ ],
+ "verified": {
+ "date": "2026-10-01",
+ "macos": "27.0",
+ "chip": "Apple M4",
+ "result": "This build's winecoreaudio.so laid over r12 (engine copy x64-crossover26.3-r12a): Counter-Strike 2 at 48 kHz, 20 dropouts in 95 s to none, no failure from the new call. Not yet installed end to end from this manifest."
+ },
+ "direct3D9": "wined3d"
+}
diff --git a/spike/engines/x64-sikarugir10.0_6-r17.json b/spike/engines/x64-sikarugir10.0_6-r17.json
new file mode 100644
index 0000000..b536079
--- /dev/null
+++ b/spike/engines/x64-sikarugir10.0_6-r17.json
@@ -0,0 +1,203 @@
+{
+ "$schema": "https://highball.app/schemas/engine-manifest/v0",
+ "id": "x64-sikarugir10.0_6-r17",
+ "displayName": "Wine 10.0 (Sikarugir, focus and msync fixes) + DXMT (Highball build, 2026-09) + D3DMetal 3.0 + MoltenVK 1.4.1 (shadow-import patch) + DXVK 3.1 macOS fork Direct3D 9 (opt-in per game)",
+ "arch": "x86_64",
+ "minMacOS": "14.0",
+ "requires": [
+ "rosetta2"
+ ],
+ "notes": [
+ "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-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)."
+ }
+ },
+ "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-01",
+ "macos": "27.0",
+ "chip": "Apple M4",
+ "result": "r15 with this manifest's wineserver and ntdll.so placed by hand (engine copy x64-sikarugir10.0_6-r15t): a new environment boots, the msync reproducer runs with a flat wineserver and no pool warning, Heartopia and Five Nights at Freddy's run under msync through Steam. The published archive was downloaded and matches this manifest's checksum."
+ },
+ "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-r20.json b/spike/engines/x64-sikarugir10.0_6-r20.json
new file mode 100644
index 0000000..1384125
--- /dev/null
+++ b/spike/engines/x64-sikarugir10.0_6-r20.json
@@ -0,0 +1,213 @@
+{
+ "$schema": "https://highball.app/schemas/engine-manifest/v0",
+ "id": "x64-sikarugir10.0_6-r20",
+ "displayName": "Wine 10.0 (Sikarugir) r20, D3DMetal 4.0 beta 2",
+ "arch": "x86_64",
+ "minMacOS": "27.0",
+ "requires": [
+ "rosetta2"
+ ],
+ "notes": [
+ "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-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-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-01",
+ "macos": "27.0",
+ "chip": "Apple M4",
+ "result": "Not run as a whole: the library it adds to r18 is the one measured on r17 (see r19), and D3DMetal 4 does not touch audio. The published archive was downloaded and matches this manifest's checksum."
+ }
+}