Skip to content

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

An engine missing the 32-bit half of one of Wine's own DLLs counts as damaged. The check behind 'Install the engine again' took a builtin as present when either lib folder had it, so an engine whose 32-bit shcore.dll and combase.dll were gone still looked whole: the 32-bit SteamSetup.exe died with exit 53 and those DLLs not found, and the app offered a fresh installer again, which can never help (highball#494, the same log as #153). Every engine ships all 24 listed builtins in both halves (all 31 on the M4, x86-64 and arm64, checked 2026-10-25), and a 32-bit program only loads the 32-bit copy, so a name missing from either half now counts. 590 tests pass on the M4.

Gauthier Piarrette3aeed7dabcfc
diff --git a/Sources/HighballKit/EngineIntegrity.swift b/Sources/HighballKit/EngineIntegrity.swift
index 15945d6..69ec737 100644
--- a/Sources/HighballKit/EngineIntegrity.swift
+++ b/Sources/HighballKit/EngineIntegrity.swift
@@ -46,11 +46,15 @@ public enum EngineIntegrity {
}
/// Of the DLLs Wine could not find, its own that are absent from this engine on disk.
- /// Empty when the engine is intact, which is the normal answer.
+ /// Empty when the engine is intact, which is the normal answer. Every engine ships each of
+ /// `builtins` in both halves (all 31 on the M4, x86-64 and arm64, 2026-10-25), and a 32-bit
+ /// program only ever loads the 32-bit copy, so a name missing from either half counts:
+ /// SteamSetup.exe died on missing 32-bit shcore.dll and combase.dll while the 64-bit copies
+ /// made the engine look whole, and the app offered a fresh installer again (highball#494).
public static func gone(fromEngineAt root: URL, notFound: [String], arch: String = "x86_64") -> [String] {
let dirs = libraryDirectories(engineRoot: root, arch: arch)
return notFound.filter { name in
- builtins.contains(name) && !dirs.contains { FileManager.default.fileExists(atPath: $0.appending(path: name).path) }
+ builtins.contains(name) && !dirs.allSatisfy { FileManager.default.fileExists(atPath: $0.appending(path: name).path) }
}
}
diff --git a/Tests/HighballKitTests/EngineIntegrityTests.swift b/Tests/HighballKitTests/EngineIntegrityTests.swift
index e3cc346..ca327b5 100644
--- a/Tests/HighballKitTests/EngineIntegrityTests.swift
+++ b/Tests/HighballKitTests/EngineIntegrityTests.swift
@@ -34,7 +34,8 @@ final class EngineIntegrityTests: XCTestCase {
}
func testOnlyWineOwnDllsAbsentFromTheEngineCount() throws {
- let root = try engineTree(shipping: ["ole32.dll", "shell32.dll"])
+ let all = ["shcore.dll", "shlwapi.dll", "shell32.dll", "combase.dll", "ole32.dll"]
+ let root = try engineTree(shipping: all, shipping32: ["ole32.dll", "shell32.dll"])
// shcore/shlwapi/combase are gone from the engine; ole32 and shell32 are still there,
// so their "not found" lines are the loader's fallout, not more missing files.
XCTAssertEqual(EngineIntegrity.gone(fromEngineAt: root, notFound: EngineIntegrity.librariesNotFound(in: output)),
@@ -42,13 +43,21 @@ final class EngineIntegrityTests: XCTestCase {
}
func testAnIntactEngineReportsNothing() throws {
- let root = try engineTree(shipping: ["shcore.dll", "shlwapi.dll", "shell32.dll", "combase.dll", "ole32.dll"])
+ let all = ["shcore.dll", "shlwapi.dll", "shell32.dll", "combase.dll", "ole32.dll"]
+ let root = try engineTree(shipping: all, shipping32: all)
XCTAssertEqual(EngineIntegrity.gone(fromEngineAt: root, notFound: EngineIntegrity.librariesNotFound(in: output)), [])
}
- func testThe32BitHalfCountsAsShipping() throws {
- let root = try engineTree(shipping: [], shipping32: ["shcore.dll", "shlwapi.dll", "shell32.dll", "combase.dll", "ole32.dll"])
- XCTAssertEqual(EngineIntegrity.gone(fromEngineAt: root, notFound: EngineIntegrity.librariesNotFound(in: output)), [])
+ /// highball#494: the 32-bit SteamSetup.exe died on missing 32-bit copies while the 64-bit ones
+ /// were there, and the app took the engine for whole and offered a fresh installer again.
+ func testAHalfMissingCounts() throws {
+ let all = ["shcore.dll", "shlwapi.dll", "shell32.dll", "combase.dll", "ole32.dll"]
+ let lost32 = try engineTree(shipping: all, shipping32: ["shlwapi.dll", "shell32.dll", "ole32.dll"])
+ XCTAssertEqual(EngineIntegrity.gone(fromEngineAt: lost32, notFound: EngineIntegrity.librariesNotFound(in: output)),
+ ["shcore.dll", "combase.dll"])
+ let lost64 = try engineTree(shipping: [], shipping32: all)
+ XCTAssertEqual(EngineIntegrity.gone(fromEngineAt: lost64, notFound: EngineIntegrity.librariesNotFound(in: output)),
+ ["shcore.dll", "shlwapi.dll", "shell32.dll", "combase.dll", "ole32.dll"])
}
func testTheAlertNamesTheFilesAndOffersTheEngineBack() {