Free fork of NotProton: Windows Steam games in Mac Steam, on CodeWeavers' Wine and Apple's Game Porting Toolkit
Swift apple-silicond3dmetaldxmtdxvkgame-porting-toolkitgptkmac-gamingmacosmetalfxrosetta-2steamsteam-playwinewinecx
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.swiftindex 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.xcstringsindex 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.swiftindex 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 unreachablecase mismatchcase 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.swiftindex 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.swiftindex 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.mdindex 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.jsonindex 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"}]