Skip to content

Free fork of NotProton: Windows Steam games in Mac Steam, on CodeWeavers' Wine and Apple's Game Porting Toolkit

fix(setup): point to antivirus and firewall blocks in setup errors (#2442)

Raymond Chin5100b570f087
diff --git a/app/Sources/BridgeplayApp/Model/FreeEngineWinecx.swift b/app/Sources/BridgeplayApp/Model/FreeEngineWinecx.swift
index 5ae09d7..1770ca0 100644
--- a/app/Sources/BridgeplayApp/Model/FreeEngineWinecx.swift
+++ b/app/Sources/BridgeplayApp/Model/FreeEngineWinecx.swift
@@ -587,7 +587,10 @@ enum FreeEngineWinecx {
let name = "\(file.resource).\(file.ext)"
guard let source = bundle.url(forResource: file.resource, withExtension: file.ext) else {
AppLog.note("bundled file: \(name) not found in \(bundle.bundleURL.path(percentEncoded: false))")
- throw StepFailure(step: step, detail: "Bridgeplay is missing its \(name). Reinstall Bridgeplay.")
+ throw StepFailure(step: step, detail: String(localized: """
+ Bridgeplay is missing its \(name). An antivirus or endpoint protection app may have \
+ quarantined it. Restore or allow the file, or exclude Bridgeplay.app, then reinstall Bridgeplay.
+ """))
}
let path = source.path(percentEncoded: false)
let actual: String
@@ -595,11 +598,17 @@ enum FreeEngineWinecx {
actual = try Digest.sha256(of: source)
} catch {
AppLog.note("bundled file: \(name) at \(path) can't be read: \(error.localizedDescription)")
- throw StepFailure(step: step, detail: "Bridgeplay can't read its \(name). Reinstall Bridgeplay.")
+ throw StepFailure(step: step, detail: String(localized: """
+ Bridgeplay can't read its \(name). An antivirus or endpoint protection app may be blocking it. \
+ Allow the file, or exclude Bridgeplay.app, then reinstall Bridgeplay.
+ """))
}
guard actual == file.sha256 || SignedPin.matches(source, sha256: file.sha256) else {
AppLog.note("bundled file: \(name) at \(path) has sha256 \(actual), expected \(file.sha256)")
- throw StepFailure(step: step, detail: "Bridgeplay's \(name) doesn't match its pinned checksum. Reinstall Bridgeplay.")
+ throw StepFailure(step: step, detail: String(localized: """
+ Bridgeplay's \(name) doesn't match its pinned checksum. An antivirus or endpoint protection app \
+ may have changed it. Allow the file, or exclude Bridgeplay.app, then reinstall Bridgeplay.
+ """))
}
return source
}
diff --git a/app/Sources/BridgeplayApp/Resources/Localization/Localizable.xcstrings b/app/Sources/BridgeplayApp/Resources/Localization/Localizable.xcstrings
index a1a67ea..1a46484 100644
--- a/app/Sources/BridgeplayApp/Resources/Localization/Localizable.xcstrings
+++ b/app/Sources/BridgeplayApp/Resources/Localization/Localizable.xcstrings
@@ -2351,6 +2351,22 @@
}
}
},
+ "Bridgeplay can't read its %@. An antivirus or endpoint protection app may be blocking it. Allow the file, or exclude Bridgeplay.app, then reinstall Bridgeplay." : {
+ "localizations" : {
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Bridgeplay non riesce a leggere il file %@. Un antivirus o un'app di protezione endpoint potrebbe bloccarlo. Consenti il file, oppure escludi Bridgeplay.app, quindi reinstalla Bridgeplay."
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Bridgeplay 无法读取 %@。杀毒软件或终端防护应用可能阻止了该文件。请允许该文件,或将 Bridgeplay.app 加入排除列表,然后重新安装 Bridgeplay。"
+ }
+ }
+ }
+ },
"Bridgeplay cannot use Steam from a folder with a colon in its name." : {
"localizations" : {
"it" : {
@@ -2415,18 +2431,18 @@
}
}
},
- "Bridgeplay could not reach %@'s servers. Please check your internet connection and try again." : {
+ "Bridgeplay could not reach %@'s servers. Check your internet connection. A firewall app (such as LuLu or Little Snitch), VPN or proxy may also be blocking Bridgeplay. Allow it and try again." : {
"localizations" : {
"it" : {
"stringUnit" : {
"state" : "translated",
- "value" : "Bridgeplay non è riuscito a raggiungere i server di %@. Controlla la connessione a internet e riprova."
+ "value" : "Bridgeplay non è riuscito a raggiungere i server di %@. Controlla la connessione a internet. Anche un'app firewall (come LuLu o Little Snitch), una VPN o un proxy potrebbero bloccare Bridgeplay. Consentine l'accesso e riprova."
}
},
"zh-Hans" : {
"stringUnit" : {
"state" : "translated",
- "value" : "Bridgeplay 无法连接 %@ 服务器。请检查网络连接,然后重试。"
+ "value" : "Bridgeplay 无法连接 %@ 服务器。请检查网络连接。防火墙应用(如 LuLu 或 Little Snitch)、VPN 或代理也可能阻止了 Bridgeplay。请允许其访问,然后重试。"
}
}
}
@@ -2639,6 +2655,22 @@
}
}
},
+ "Bridgeplay is missing its %@. An antivirus or endpoint protection app may have quarantined it. Restore or allow the file, or exclude Bridgeplay.app, then reinstall Bridgeplay." : {
+ "localizations" : {
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "In Bridgeplay manca il file %@. Un antivirus o un'app di protezione endpoint potrebbe averlo messo in quarantena. Ripristina o consenti il file, oppure escludi Bridgeplay.app, quindi reinstalla Bridgeplay."
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Bridgeplay 缺少 %@。杀毒软件或终端防护应用可能已将其隔离。请恢复或允许该文件,或将 Bridgeplay.app 加入排除列表,然后重新安装 Bridgeplay。"
+ }
+ }
+ }
+ },
"Bridgeplay is rebuilding the prefix for %@." : {
"localizations" : {
"it" : {
@@ -2879,6 +2911,22 @@
}
}
},
+ "Bridgeplay's %@ doesn't match its pinned checksum. An antivirus or endpoint protection app may have changed it. Allow the file, or exclude Bridgeplay.app, then reinstall Bridgeplay." : {
+ "localizations" : {
+ "it" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Il file %@ di Bridgeplay non corrisponde al checksum previsto. Un antivirus o un'app di protezione endpoint potrebbe averlo modificato. Consenti il file, oppure escludi Bridgeplay.app, quindi reinstalla Bridgeplay."
+ }
+ },
+ "zh-Hans" : {
+ "stringUnit" : {
+ "state" : "translated",
+ "value" : "Bridgeplay 的 %@ 与预设校验值不符。杀毒软件或终端防护应用可能修改了该文件。请允许该文件,或将 Bridgeplay.app 加入排除列表,然后重新安装 Bridgeplay。"
+ }
+ }
+ }
+ },
"Bridgeplay's default." : {
"localizations" : {
"it" : {
diff --git a/app/Sources/BridgeplayApp/Support/PinnedDownload.swift b/app/Sources/BridgeplayApp/Support/PinnedDownload.swift
index bf6d4bb..3de8855 100644
--- a/app/Sources/BridgeplayApp/Support/PinnedDownload.swift
+++ b/app/Sources/BridgeplayApp/Support/PinnedDownload.swift
@@ -97,7 +97,7 @@ enum PinnedDownload {
}
} catch {
refusals.append("\(host): \(error.localizedDescription)")
- kinds.insert(.unreachable)
+ kinds.insert(Self.connectionFailed(error) ? .unreachable : .failed)
continue
}
defer { try? FileManager.default.removeItem(at: body) }
@@ -161,6 +161,23 @@ enum PinnedDownload {
case unreachable
case mismatch
case answered
+ case failed
+ }
+
+ // Only these point at the network, a firewall, VPN or proxy. A cancel, a full disk or a
+ // file error is not, and must not get that advice.
+ static func connectionFailed(_ error: Error) -> Bool {
+ guard let error = error as? URLError else { return false }
+ switch error.code {
+ case .notConnectedToInternet, .cannotFindHost, .cannotConnectToHost, .dnsLookupFailed,
+ .timedOut, .networkConnectionLost, .secureConnectionFailed, .internationalRoamingOff,
+ .dataNotAllowed, .cannotLoadFromNetwork,
+ // A proxy that inspects TLS shows its own certificate for every host.
+ .serverCertificateUntrusted, .serverCertificateHasUnknownRoot:
+ return true
+ default:
+ return false
+ }
}
private static func reason(_ kinds: Set<Refusal>, from source: String) -> String {
@@ -168,7 +185,10 @@ enum PinnedDownload {
return String(localized: "Something is wrong with the downloaded files. Please check for a Bridgeplay update.")
}
if kinds == [.unreachable] {
- return String(localized: "Bridgeplay could not reach \(source)'s servers. Please check your internet connection and try again.")
+ return String(localized: """
+ Bridgeplay could not reach \(source)'s servers. Check your internet connection. A firewall app \
+ (such as LuLu or Little Snitch), VPN or proxy may also be blocking Bridgeplay. Allow it and try again.
+ """)
}
return String(localized: "Bridgeplay could not download the files it needs from \(source). Please try again later.")
}
diff --git a/app/Tests/BridgeplayAppTests/FreeEngineWinecxTests.swift b/app/Tests/BridgeplayAppTests/FreeEngineWinecxTests.swift
index 815cf10..daff052 100644
--- a/app/Tests/BridgeplayAppTests/FreeEngineWinecxTests.swift
+++ b/app/Tests/BridgeplayAppTests/FreeEngineWinecxTests.swift
@@ -784,7 +784,10 @@ struct FreeEngineWinecxTests {
#expect(try FreeEngineWinecx.bundledSource(file("fixture", pin), in: bundle).lastPathComponent == "fixture.dll")
#expect(detail(file("absent", pin))?.contains("missing its absent.dll") == true)
- #expect(detail(file("fixture", String(repeating: "0", count: 64)))?.contains("doesn't match") == true)
+ #expect(detail(file("absent", pin))?.contains("antivirus") == true)
+ let changed = detail(file("fixture", String(repeating: "0", count: 64)))
+ #expect(changed?.contains("doesn't match") == true)
+ #expect(changed?.contains("antivirus") == true)
let root = try makeDirectory("bundled-root")
defer { try? FileManager.default.removeItem(at: root) }
@@ -794,6 +797,8 @@ struct FreeEngineWinecxTests {
let path = fixture.path(percentEncoded: false)
try FileManager.default.setAttributes([.posixPermissions: 0], ofItemAtPath: path)
defer { try? FileManager.default.setAttributes([.posixPermissions: 0o644], ofItemAtPath: path) }
- #expect(detail(file("fixture", pin))?.contains("can't read") == true)
+ let unreadable = detail(file("fixture", pin))
+ #expect(unreadable?.contains("can't read") == true)
+ #expect(unreadable?.contains("antivirus") == true)
}
}
diff --git a/app/Tests/BridgeplayAppTests/PinnedDownloadTests.swift b/app/Tests/BridgeplayAppTests/PinnedDownloadTests.swift
index 3ea9f16..61de8c1 100644
--- a/app/Tests/BridgeplayAppTests/PinnedDownloadTests.swift
+++ b/app/Tests/BridgeplayAppTests/PinnedDownloadTests.swift
@@ -113,6 +113,48 @@ struct PinnedDownloadTests {
#expect(reported.all.filter { !$0.contains(" / ") }.count == 1)
}
+ // Fails every request with the URLError code named by the host, e.g. https://refused.invalid/.
+ private final class Failing: URLProtocol, @unchecked Sendable {
+ static let codes: [String: URLError.Code] = [
+ "refused.invalid": .cannotConnectToHost, "untrusted.invalid": .serverCertificateUntrusted,
+ "cancelled.invalid": .cancelled,
+ ]
+
+ override class func canInit(with request: URLRequest) -> Bool { codes[request.url?.host() ?? ""] != nil }
+ override class func canonicalRequest(for request: URLRequest) -> URLRequest { request }
+ override func startLoading() {
+ client?.urlProtocol(self, didFailWithError: URLError(Self.codes[request.url!.host()!]!))
+ }
+ override func stopLoading() {}
+ }
+
+ private func failure(from host: String) async throws -> StepFailure {
+ let work = try scratchDirectory("pinned")
+ defer { try? FileManager.default.removeItem(at: work) }
+ return try await #require(throws: StepFailure.self) {
+ _ = try await PinnedDownload.obtain(
+ file: "package.tar", sha256: String(repeating: "0", count: 64),
+ bases: [URL(string: "https://\(host)/")!],
+ into: work.appending(path: "downloads"), step: "test",
+ session: PinnedDownload.session(deadline: 30, protocols: [Failing.self]))
+ }
+ }
+
+ @Test("A host that can't be reached points at the connection, a firewall, VPN or proxy",
+ arguments: ["refused.invalid", "untrusted.invalid"])
+ func unreachableNamesAFirewall(host: String) async throws {
+ let detail = try await failure(from: host).detail
+ #expect(detail.contains("could not reach"))
+ #expect(detail.contains("firewall"))
+ }
+
+ @Test("A failure that isn't the network is not blamed on a firewall")
+ func otherFailureIsNotAFirewall() async throws {
+ let detail = try await failure(from: "cancelled.invalid").detail
+ #expect(!detail.contains("could not reach"))
+ #expect(!detail.contains("firewall"))
+ }
+
@Test("A download has an overall deadline, not only an idle one")
func downloadsHaveADeadline() {
#expect(PinnedDownload.session.configuration.timeoutIntervalForResource <= 4 * 60 * 60)
diff --git a/compat/README.md b/compat/README.md
index 48bbd7a..dfc5e39 100644
--- a/compat/README.md
+++ b/compat/README.md
@@ -2,7 +2,7 @@
Generated by `scripts/compat-table.py` from `games.json`; do not edit by hand. These are results a maintainer checked (`scripts/np-test-game.sh <appid>`, or a *Game report* issue). Players' one-tap reports from the app are posted to [Compatibility reports](https://github.com/raymondchins/Bridgeplay/discussions/categories/compatibility-reports) and counted on [bridgeplay.dev/compatibility](https://bridgeplay.dev/compatibility).
-platinum: 16 / gold: 4 / silver: 1 / bronze: 2 / borked: 6 / untested: 18
+platinum: 17 / gold: 4 / silver: 1 / bronze: 2 / borked: 8 / untested: 18
| Game | AppID | Status | Tested on | Backend | Engine | API | Anti-cheat | Last tested | Fork commit | Notes |
|---|---|---|---|---|---|---|---|---|---|---|
@@ -14,6 +14,7 @@ platinum: 16 / gold: 4 / silver: 1 / bronze: 2 / borked: 6 / untested: 18
| Ghostrunner | 1139900 | platinum | M5 Max · macOS 27 | d3dmetal | winecx-11.15 | D3D11+D3D12 | none known | 2026-10-09 | - | - |
| Horizon Zero Dawn™ Complete Edition | 1151640 | platinum | M5 Max · macOS 27 | d3dmetal | winecx-11.15 | D3D12 | none known | 2026-10-09 | - | - |
| It Takes Two | 1426210 | platinum | M5 Max · macOS 27 | d3dmetal | winecx-11.15 | D3D11 | none known | 2026-10-09 | - | - |
+| Mars First Logistics | 1532200 | platinum | M1 Pro · macOS 26.1 | d3dmetal | winecx-11.17 | unknown | none known | 2026-11-01 | - | Runs out of the box. From a player report (#2194). |
| Marvel's Spider-Man 2 | 2651280 | platinum | M5 Max · macOS 27 | wined3d | winecx-11.15 | D3D12 | none known | 2026-10-21 | - | - |
| Megabonk | 3405340 | platinum | M5 Max · macOS 27 | d3dmetal | winecx-11.15 | D3D11+D3D12 | none known | 2026-10-09 | - | - |
| Mortal Kombat 1 | 1971870 | platinum | M5 Max · macOS 27 | d3dmetal | winecx-11.15 | D3D12 | none known | 2026-10-09 | - | - |
@@ -34,6 +35,8 @@ platinum: 16 / gold: 4 / silver: 1 / bronze: 2 / borked: 6 / untested: 18
| DOOM: The Dark Ages | 3017860 | borked | - | - | winecx-11.15 | Vulkan | none known | 2026-10-09 | - | requires hardware ray tracing; MoltenVK exposes no RT extensions |
| Half-Life: Alyx | 546560 | borked | - | - | winecx-11.15 | D3D11+Vulkan | none known | 2026-10-09 | - | VR only |
| Indiana Jones and the Great Circle | 2677660 | borked | - | - | winecx-11.15 | Vulkan | none known | 2026-10-09 | - | requires hardware ray tracing |
+| PGA TOUR 2K25 | 2385530 | borked | M3 · macOS 27.0.1 | d3dmetal | winecx-11.17 | unknown | none known | 2026-11-01 | - | The window opens, then the game crashes 14-72s in on every launch (access violation). Denuvo under Rosetta is suspected, not confirmed. From a player report (#2162). |
+| Planet Zoo 2 | 3219030 | borked | M4 · macOS 27.2 | - | winecx-11.17 | unknown | none known | 2026-10-28 | - | Does not run. From a player report (#1488). |
| Watch_Dogs™ | 243470 | borked | M4 · macOS 27 | - | winecx-11.17 | D3D11 | none known | 2026-10-24 | - | Started 2 times in 10 tries; even then, heavy shading and display glitches leave almost nothing visible. From a player report (#786). |
| DARK SOULS™ III | 374320 | untested | - | dxmt | - | D3D11 | none known | - | - | - |
| Deep Rock Galactic | 548430 | untested | - | dxmt | - | D3D11+D3D12 | none known | - | - | - |
diff --git a/compat/games.json b/compat/games.json
index 20f2a80..86cb80c 100644
--- a/compat/games.json
+++ b/compat/games.json
@@ -587,5 +587,44 @@
"last_tested": "2026-10-23",
"fork_commit": null,
"tested_on": "M3 Pro · macOS 27.0.1"
+ },
+ {
+ "appid": 1532200,
+ "name": "Mars First Logistics",
+ "api": "unknown",
+ "anticheat": "none known",
+ "status": "platinum",
+ "backend": "d3dmetal",
+ "engine": "winecx-11.17",
+ "notes": "Runs out of the box. From a player report (#2194).",
+ "last_tested": "2026-11-01",
+ "fork_commit": null,
+ "tested_on": "M1 Pro · macOS 26.1"
+ },
+ {
+ "appid": 2385530,
+ "name": "PGA TOUR 2K25",
+ "api": "unknown",
+ "anticheat": "none known",
+ "status": "borked",
+ "backend": "d3dmetal",
+ "engine": "winecx-11.17",
+ "notes": "The window opens, then the game crashes 14-72s in on every launch (access violation). Denuvo under Rosetta is suspected, not confirmed. From a player report (#2162).",
+ "last_tested": "2026-11-01",
+ "fork_commit": null,
+ "tested_on": "M3 · macOS 27.0.1"
+ },
+ {
+ "appid": 3219030,
+ "name": "Planet Zoo 2",
+ "api": "unknown",
+ "anticheat": "none known",
+ "status": "borked",
+ "backend": null,
+ "engine": "winecx-11.17",
+ "notes": "Does not run. From a player report (#1488).",
+ "last_tested": "2026-10-28",
+ "fork_commit": null,
+ "tested_on": "M4 · macOS 27.2"
}
]