Run Windows games on Apple Silicon — free, open source, with an open compatibility database that tells you what actually works.
Swift apple-silicond3dmetaldxmtdxvkfexgame-porting-toolkitgamingmac-gamingmacosmetalmoltenvksteamswiftuivkd3d-protonwhisky-alternativewindows-gameswinewine-wrapper
Before a D3DMetal Play, every pre-launch notice Steam can record is recorded as seen, not only "controller recommended". With a DualSense connected, Forza Horizon 6 never started on an M5 Max. Steam's console_log.txt stopped at "waiting for user response to ShowInterstitials" on every Play, because a PlayStation controller brings Steam's question whether to use Steam Input for it (CurrentGamepadSteamInputOptIn), which cannot draw on D3DMetal either. The notices, their keys, modes and versions come from the steamui code of Steam client 1788652215, and each is written the way the client's own MarkInterstitialSeen does it: the version, and for a once-per-game notice the game in its list and the checkbox. A version below Steam's is raised, and a "don't show again" the player ticked stays. The M4 the launch was verified on has no controller, so the DualSense case itself is not reproduced here
Gauthier Piarrette63e8b0bfc55b
diff --git a/Sources/HighballApp/AppState.swift b/Sources/HighballApp/AppState.swiftindex 43b6a7f..ace860f 100644--- a/Sources/HighballApp/AppState.swift+++ b/Sources/HighballApp/AppState.swift@@ -2330,13 +2330,14 @@ final class AppState {case .noClient, .serves:break}- // A client on the D3DMetal stack cannot draw Steam's "controller recommended" notice, so- // a first launch would wait on it for good. No client runs at this point when the launch- // cold-starts one, which is when the record can be written (see SteamLaunchNotice).+ // A client on the D3DMetal stack cannot draw Steam's pre-launch notices ("controller+ // recommended", the Steam Input question a PlayStation controller brings), so a launch+ // would wait on one for good. No client runs at this point when the launch cold-starts+ // one, which is when the record can be written (see SteamLaunchNotice).if served == .d3dmetal, runner.runningSteamEnvironment() == nil {let root = bottle.driveC.appending(path: "Program Files (x86)/Steam")if SteamLaunchNotice.markSeen(steamRoot: root, appID: game.appid) > 0 {- await MainActor.run { self.appendLog("Recorded Steam's controller notice for \(game.name) as seen: Steam cannot show it in D3DMetal mode.") }+ await MainActor.run { self.appendLog("Recorded Steam's pre-launch notices for \(game.name) as seen: Steam cannot show them in D3DMetal mode.") }}}let note = headerNote, servedRenderer = serveddiff --git a/Sources/HighballKit/SteamLaunchNotice.swift b/Sources/HighballKit/SteamLaunchNotice.swiftindex 5a7880d..ae3f7f0 100644--- a/Sources/HighballKit/SteamLaunchNotice.swift+++ b/Sources/HighballKit/SteamLaunchNotice.swift@@ -1,6 +1,6 @@import Foundation-/// Steam's "controller recommended" notice, which a D3DMetal launch cannot show.+/// Steam's pre-launch notices, such as "controller recommended", which a D3DMetal launch cannot show.////// Before the first start of a game tagged "gamepad recommended", Steam's launch stops at/// `ShowInterstitials` and its web UI draws a notice saying a controller is recommended. Once it@@ -22,14 +22,43 @@ import Foundation/// as seen before a D3DMetal launch takes nothing away. Steam keeps the file in memory while it/// runs and writes it back on exit, so this has to happen while no client runs: the caller/// does it right before a cold start.+///+/// "Controller recommended" is one of several such notices, and which one Steam shows depends on+/// the Mac. With a DualSense connected, Forza Horizon 6 never started on an M5 Max: Steam's+/// console_log.txt stopped at "waiting for user response to ShowInterstitials" on every Play+/// (2026-10-06, Steam client 1788652215). With a PlayStation controller Steam asks whether to use+/// Steam Input for it (CurrentGamepadSteamInputOptIn) instead, and the M4 these launches were+/// verified on has no controller. So every notice Steam can record as seen is recorded, each the+/// way the client's own MarkInterstitialSeen does it.public enum SteamLaunchNotice {- static let appsKey = "Deck_ConfiguratorInterstitialApps_GamepadRecommended"- static let fixedKeys = [("Deck_ConfiguratorInterstitialsVersionSeen_GamepadRecommended", "1"),- ("Deck_ConfiguratorInterstitialsCheckbox_GamepadRecommended", "0")]+ /// Steam's pre-launch notices, its "ConfiguratorInterstitials", as client 1788652215 defines+ /// them in steamui: the name in their storage keys, whether Steam asks once per game (an apps+ /// list and a "don't show again" checkbox) or once for every game, and the version it compares+ /// the stored one against (shown again when the stored one is lower). Two more ask every time+ /// (GamepadRequired, VRRequired) and keep nothing that could be recorded.+ static let notices: [(name: String, perGame: Bool, version: Int)] = [+ ("GamepadRecommended", true, 1),+ ("CurrentGamepadSteamInputOptIn", true, 1),+ ("CurrentGamepadUnsupported", true, 1),+ ("AppTextInputDoesNotAutomaticallyInvokesKeyboard", true, 1),+ ("AppLauncherInteractionIssues", true, 1),+ ("AppHasSmallText", true, 1),+ ("IntroToVRTheater", true, 1),+ ("HDRRequiresUserAction", true, 1),+ ("UnclaimedEntitlement", true, 1),+ ("Intro", false, 3),+ ("NonVerifiedGame", false, 5),+ ("Gyro", false, 4),+ ("RemotePlayConfirm", false, 3),+ ("ExternalControllersAndSIAPI", false, 1),+ ("IntroToActionSets", false, 1),+ ("IntroToSteamInputGames", false, 1),+ ]- /// Pure: the text of a `localconfig.vdf` with the notice recorded as seen for `appID`, or nil- /// when nothing needs to change or the file has no `WebStorage` block to put it in (a client- /// that has never shown its web UI; nothing is invented then).+ /// Pure: the text of a `localconfig.vdf` with every notice recorded as seen for `appID`, or+ /// nil when nothing needs to change or the file has no `WebStorage` block to put it in (a+ /// client that has never shown its web UI; nothing is invented then). A version below Steam's+ /// is raised, a "don't show again" the player ticked stays.public static func markingSeen(in text: String, appID: Int) -> String? {let crlf = text.contains("\r\n")var lines = text.replacingOccurrences(of: "\r\n", with: "\n").components(separatedBy: "\n")@@ -45,26 +74,31 @@ public enum SteamLaunchNotice {}func line(_ key: String, _ value: String) -> String { "\t\t\"\(key)\"\t\t\"\(value)\"" }var changed = false- if let i = (ws + 2..<end).first(where: { pair(lines[$0])?.key == appsKey }) {- let current = pair(lines[i])?.value ?? "[]"- var apps = (try? JSONDecoder().decode([Int].self, from: Data(current.utf8))) ?? []+ func index(of key: String) -> Int? { (ws + 2..<end).first(where: { pair(lines[$0])?.key == key }) }+ func value(of key: String) -> String? { index(of: key).flatMap { pair(lines[$0])?.value } }+ func set(_ key: String, _ value: String) {+ if let i = index(of: key) { lines[i] = line(key, value) } else { lines.insert(line(key, value), at: end); end += 1 }+ changed = true+ }+ for notice in notices {+ let seenKey = "Deck_ConfiguratorInterstitialsVersionSeen_" + notice.name+ if (value(of: seenKey).flatMap { Int($0) } ?? 0) < notice.version { set(seenKey, String(notice.version)) }+ guard notice.perGame else { continue }+ let checkboxKey = "Deck_ConfiguratorInterstitialsCheckbox_" + notice.name+ if index(of: checkboxKey) == nil { set(checkboxKey, "0") }+ let appsKey = "Deck_ConfiguratorInterstitialApps_" + notice.name+ var apps = value(of: appsKey).flatMap { try? JSONDecoder().decode([Int].self, from: Data($0.utf8)) } ?? []if !apps.contains(appID) {apps.append(appID)- lines[i] = line(appsKey, "[" + apps.map(String.init).joined(separator: ",") + "]")- changed = true+ set(appsKey, "[" + apps.map(String.init).joined(separator: ",") + "]")}- } else {- lines.insert(line(appsKey, "[\(appID)]"), at: end); end += 1; changed = true- }- for (key, value) in fixedKeys where !(ws + 2..<end).contains(where: { pair(lines[$0])?.key == key }) {- lines.insert(line(key, value), at: end); end += 1; changed = true}guard changed else { return nil }let joined = lines.joined(separator: "\n")return crlf ? joined.replacingOccurrences(of: "\n", with: "\r\n") : joined}- /// Records the notice as seen for `appID` in every Steam user's `localconfig.vdf` under+ /// Records the notices as seen for `appID` in every Steam user's `localconfig.vdf` under/// `steamRoot`. Call it only while no Steam client runs in the environment. Returns how many/// files changed.@discardableResultdiff --git a/Tests/HighballKitTests/SteamLaunchNoticeTests.swift b/Tests/HighballKitTests/SteamLaunchNoticeTests.swiftindex cebe6d6..6ce50a5 100644--- a/Tests/HighballKitTests/SteamLaunchNoticeTests.swift+++ b/Tests/HighballKitTests/SteamLaunchNoticeTests.swift@@ -23,7 +23,7 @@ final class SteamLaunchNoticeTests: XCTestCase {}"""- func testAFirstGameAddsTheThreeValuesInsideWebStorage() throws {+ func testAFirstGameAddsEveryNoticeInsideWebStorage() throws {let out = try XCTUnwrap(SteamLaunchNotice.markingSeen(in: base, appID: 2483190))let lines = out.components(separatedBy: "\n")let ws = try XCTUnwrap(lines.firstIndex(of: "\t\"WebStorage\""))@@ -33,7 +33,8 @@ final class SteamLaunchNoticeTests: XCTestCase {XCTAssertTrue(block.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_GamepadRecommended\"\t\t\"1\""))XCTAssertTrue(block.contains("\"Deck_ConfiguratorInterstitialsCheckbox_GamepadRecommended\"\t\t\"0\""))XCTAssertTrue(block.contains("\"SomethingElse\""), "the block's own values stay")- XCTAssertEqual(lines.count, base.components(separatedBy: "\n").count + 3, "three lines added, nothing removed")+ let added = SteamLaunchNotice.notices.reduce(0) { $0 + ($1.perGame ? 3 : 1) }+ XCTAssertEqual(lines.count, base.components(separatedBy: "\n").count + added, "one line per value, nothing removed")XCTAssertTrue(out.hasSuffix("\t\"friends\"\n\t{\n\t}\n}"), "what follows the block is untouched")}@@ -42,7 +43,39 @@ final class SteamLaunchNoticeTests: XCTestCase {XCTAssertNil(SteamLaunchNotice.markingSeen(in: first, appID: 2483190), "already recorded")let second = try XCTUnwrap(SteamLaunchNotice.markingSeen(in: first, appID: 1551360))XCTAssertTrue(second.contains("\"Deck_ConfiguratorInterstitialApps_GamepadRecommended\"\t\t\"[2483190,1551360]\""))- XCTAssertEqual(second.components(separatedBy: "VersionSeen").count, 2, "the fixed values are not added twice")+ XCTAssertEqual(second.components(separatedBy: "VersionSeen_GamepadRecommended\"").count, 2, "the fixed values are not added twice")+ }++ /// With a DualSense connected, Steam asks whether to use Steam Input for it before the launch+ /// instead, and Forza Horizon 6 waited on that for good on an M5 Max (2026-10-06).+ func testThePlayStationQuestionAndTheOneTimeNoticesAreRecordedToo() throws {+ let out = try XCTUnwrap(SteamLaunchNotice.markingSeen(in: base, appID: 2483190))+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialApps_CurrentGamepadSteamInputOptIn\"\t\t\"[2483190]\""))+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_CurrentGamepadSteamInputOptIn\"\t\t\"1\""))+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsCheckbox_CurrentGamepadSteamInputOptIn\"\t\t\"0\""))+ // A once-for-every-game notice keeps only its version, the way Steam stores it.+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_IntroToSteamInputGames\"\t\t\"1\""))+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_Intro\"\t\t\"3\""))+ XCTAssertFalse(out.contains("Deck_ConfiguratorInterstitialApps_IntroToSteamInputGames"))+ // The two Steam asks every time keep nothing to record.+ XCTAssertFalse(out.contains("GamepadRequired"))+ XCTAssertFalse(out.contains("VRRequired"))+ }++ func testAnOldVersionIsRaisedAndThePlayersOwnChoiceStays() throws {+ let stored = base.replacingOccurrences(of: "\t\t\"SomethingElse\"\t\t\"1\"", with: """+ \t\t"SomethingElse"\t\t"1"+ \t\t"Deck_ConfiguratorInterstitialsVersionSeen_Gyro"\t\t"2"+ \t\t"Deck_ConfiguratorInterstitialsVersionSeen_Intro"\t\t"7"+ \t\t"Deck_ConfiguratorInterstitialsCheckbox_CurrentGamepadSteamInputOptIn"\t\t"1"+ """)+ let out = try XCTUnwrap(SteamLaunchNotice.markingSeen(in: stored, appID: 2483190))+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_Gyro\"\t\t\"4\""), "below Steam's version 4, so raised")+ XCTAssertFalse(out.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_Gyro\"\t\t\"2\""))+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsVersionSeen_Intro\"\t\t\"7\""), "a newer one stays")+ XCTAssertTrue(out.contains("\"Deck_ConfiguratorInterstitialsCheckbox_CurrentGamepadSteamInputOptIn\"\t\t\"1\""), "don't show again stays ticked")+ XCTAssertEqual(out.components(separatedBy: "VersionSeen_Gyro\"").count, 2, "replaced in place, not added")+ XCTAssertNil(SteamLaunchNotice.markingSeen(in: out, appID: 2483190), "a second pass finds it done")}func testWindowsLineEndingsSurviveAndNoWebStorageMeansNoEdit() throws {