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
docs: rename NotProton paths, tools, logs and env vars to Bridgeplay
raymondchinsfdd3ed597043
diff --git a/NOTICE b/NOTICEindex aa8b617..fd36bcb 100644--- a/NOTICE+++ b/NOTICE@@ -57,7 +57,7 @@ sha256 pins are in docs/WINECX.md and each patch directory's README.Wine 11.15 (WineHQ release tarball):winemac-winehq-11.15.so winemac-patch/dxmt_export.c-All files above are in app/Sources/NotProtonApp/Resources/. The engine's ntdll+All files above are in app/Sources/BridgeplayApp/Resources/. The engine's ntdllis patched at setup with detours built from ntdll-patch/ (detour*.bin in thesame folder). nvapi64-shim.dll is Bridgeplay's own code, built from nvapi-shim/.@@ -102,7 +102,7 @@ MIT licensed, seehttps://github.com/sparkle-project/Sparkle/blob/2.10.0/LICENSEThe app's interface uses the Geist and Unbounded typefaces, bundled in-app/Sources/NotProtonApp/Resources/Fonts/ under the SIL Open Font License 1.1+app/Sources/BridgeplayApp/Resources/Fonts/ under the SIL Open Font License 1.1(OFL-Geist.txt, OFL-Unbounded.txt there). Game covers shown in the app are readfrom the user's own Steam library cache or Steam's CDN at run time; none shipwith Bridgeplay.@@ -122,12 +122,12 @@ These third party files carry their original notices from the project authors:The WineCX engine gets an x86_64 SDL2 from the app bundle, for controller supportin winebus.so (docs/WINECX.md):- app/Sources/NotProtonApp/Resources/libSDL2-2.0.0.dylib+ app/Sources/BridgeplayApp/Resources/libSDL2-2.0.0.dylibSimple DirectMedia Layer 2.32.10 (SDL-release-2.32.10-0-g5d2495703),https://github.com/libsdl-org/SDL/tree/release-2.32.10, built x86_64 withwinemac-patch/sdl2-iokit-gamepad-collection.patch and signed ad hoc.Copyright (C) 1997-2025 Sam Lantinga <[email protected]>.zlib license, https://github.com/libsdl-org/SDL/blob/release-2.32.10/LICENSE.txt- app/Sources/NotProtonApp/Resources/winebus-winecx-11.15.so+ app/Sources/BridgeplayApp/Resources/winebus-winecx-11.15.sowinecx 5b45f45 (Wine, LGPL-2.1-or-later), built with SDL2 support.diff --git a/docs/BUILD-LOCAL.md b/docs/BUILD-LOCAL.mdindex 9daee8b..3031c0d 100644--- a/docs/BUILD-LOCAL.md+++ b/docs/BUILD-LOCAL.md@@ -29,9 +29,9 @@ output to `build/logs/<phase>.log`.| Path | What ||---|---|-| `build/NotProton.app` | ad-hoc signed app, passes `codesign --verify --strict` |-| `build/NotProton.zip` | `ditto -c -k --keepParent` of the app, as CI packages it |-| `out/NotProton.app` | the bundle `make app` writes; the script copies it to `build/` |+| `build/Bridgeplay.app` | ad-hoc signed app, passes `codesign --verify --strict` |+| `build/Bridgeplay.zip` | `ditto -c -k --keepParent` of the app, as CI packages it |+| `out/Bridgeplay.app` | the bundle `make app` writes; the script copies it to `build/` |At the end the script prints the version (from `dylib/version.h`: `make app` writes`BRIDGEPLAY_VERSION` into `CFBundleShortVersionString` and `BRIDGEPLAY_BUILD` intodiff --git a/docs/DEVELOPING.md b/docs/DEVELOPING.mdindex d105ec8..bc6eb64 100644--- a/docs/DEVELOPING.md+++ b/docs/DEVELOPING.md@@ -25,7 +25,9 @@----## NotProton+## NotProton (upstream)++_From upstream's README._NotProton enables the Steam Play experience from Linux Steam in the macOS Steam client.@@ -50,9 +52,9 @@ If a game has a native macOS version as well as a Windows one, Steam will downlo## Free Wine engine (no CrossOver needed)-NotProton can also run entirely on free software. Under Compatibility Tool, **Download & Set Up**+Bridgeplay can also run entirely on free software. Under Compatibility Tool, **Download & Set Up**fetches the WineHQ 11.15 macOS build from [Gcenx/macOS_Wine_builds](https://github.com/Gcenx/macOS_Wine_builds)-(hash pinned), unpacks it into `~/Library/Application Support/notproton/engines/` and sets the+(hash pinned), unpacks it into `~/Library/Application Support/bridgeplay/engines/` and sets thecompatibility tool up from it exactly like a CrossOver copy. No CrossOver license is involved; thelicense check is skipped only for loaders whose hash pins the free build.@@ -65,7 +67,7 @@ against. Differences from CrossOver to be aware of:Wine's own wined3d cannot reach feature level 11 on macOS OpenGL. D3DMetal is Apple's and needsCrossOver's Wine changes, so this engine does not use it; the WineCX engine can, with a GamePorting Toolkit you supply (`docs/WINECX.md`).-- DXMT needs macdrv functions upstream Wine hides; NotProton ships a rebuilt `winemac.so`+- DXMT needs macdrv functions upstream Wine hides; Bridgeplay ships a rebuilt `winemac.so`that exports them (see `winemac-patch/`).- D3D 12 has no fast path; vkd3d over the bundled MoltenVK is limited.- WineHQ has no msync/esync, so CPU-heavy games can run slower than under CrossOver or Sikarugir.@@ -96,5 +98,5 @@ Developer Notes:As far as the source structure goes, the macOS app itself is located in the ```app``` folder. The core logic is in ```dylib```.```lsteamclient``` is a macOS port of Valve's lsteamclient. ```steam-shim```is a port of Valve'ssteam-helper from Proton 9.0. ntdll-patch patches the copy of CrossOver that the app-makes/places in the ```~/Library/Application Support/notproton/runners/``` folder so that+makes/places in the ```~/Library/Application Support/bridgeplay/runners/``` folder so thatlsteamclient is loaded.diff --git a/docs/DXMT.md b/docs/DXMT.mdindex 15bd2c6..50b0e8a 100644--- a/docs/DXMT.md+++ b/docs/DXMT.md@@ -1,6 +1,6 @@# DXMT build-NotProton ships DXMT built from a pinned master commit, not the v0.80 release, to pick up+Bridgeplay ships DXMT built from a pinned master commit, not the v0.80 release, to pick upthe 262 commits since that release (D3D11 fixes, the macOS 27 HUD fix, Xcode 27 buildfixes, the WIP D3D12 backend).@@ -11,7 +11,7 @@ fixes, the WIP D3D12 backend).| Tarball | `dxmt-e94c312.tar.gz`, top-level directory `e94c312/` || License | LGPL-2.1-or-later since `ec357fd` (v0.80 was the last MIT release) |-## In NotProton+## In BridgeplayBoth free engines download this tarball from`https://github.com/raymondchins/Bridgeplay/releases/download/dxmt-e94c312/` into thediff --git a/docs/GAMEFIXES.md b/docs/GAMEFIXES.mdindex 5e8831e..6cdc14c 100644--- a/docs/GAMEFIXES.md+++ b/docs/GAMEFIXES.md@@ -2,12 +2,15 @@The `run` script reads two optional files for each game, named after its Steam app id:-1. `~/Library/Application Support/notproton/gamefixes-default/<appid>.conf`, shipped with NotProton-2. `~/Library/Application Support/notproton/gamefixes/<appid>.conf`, your own+1. `~/Library/Application Support/bridgeplay/gamefixes-default/<appid>.conf`, shipped with Bridgeplay+2. `~/Library/Application Support/bridgeplay/gamefixes/<appid>.conf`, your ownThe later file wins per key. A variable you set in the game's Steam launch options(`NAME=value %command%`) wins over both files.+Bridgeplay's own variables are spelled `BRIDGEPLAY_*` (`BRIDGEPLAY_RETINA=1`). The+`NOTPROTON_*` spelling from before 3.0.0 still works, in launch options and in conf files.+## FormatOne `KEY=VALUE` per line. Blank lines and lines starting with `#` are ignored, and so is@@ -25,12 +28,12 @@ logged, when:| `ARGS` | space-separated arguments of `A-Za-z0-9_+./:=,-` | Added to the game's command line after the launch options' own arguments. Ignored for installers and other helpers || `DLLOVERRIDES` | Wine syntax, e.g. `dinput8=n,b;xinput1_3=n` | Added to `WINEDLLOVERRIDES` after the backend's entries and before the launch options' || `MSYNC` | `0`, `1` | `1` turns msync on when the engine supports it; `0` turns it off |-| `RETINA` | `0`, `1` | Same as `NOTPROTON_RETINA` (High Resolution) |-| `FRAMEGEN` | `0`, `1`, `2`, `3`, `adaptive` | Same as `NOTPROTON_FRAMEGEN`: experimental frame generation in overlay-shim, adds up to half a frame of latency. `2` and `3` multiply the frame rate, `adaptive` fills up to the display refresh, `1` is the same as `2`, `0` is off (the default) |-| `FRAMEGEN_QUALITY` | `performance`, `balanced`, `quality` | Same as `NOTPROTON_FRAMEGEN_QUALITY`. `balanced` when unset |-| `FRAMEGEN_UI` | `0`, `1` | Same as `NOTPROTON_FRAMEGEN_UI`, Protect UI: keeps static HUD and menus sharp. On when unset |-| `FRAMEGEN_FALLBACK` | `0`, `1` | Same as `NOTPROTON_FRAMEGEN_FALLBACK`, Fast-motion fallback: skips generated frames that would smear. On when unset |-| `FRAMEGEN_ENGINE` | `own`, `metalfx` | Same as `NOTPROTON_FRAMEGEN_ENGINE`: the built-in optical flow (`own`, the default) or MetalFX frame interpolation |+| `RETINA` | `0`, `1` | Same as `BRIDGEPLAY_RETINA` (High Resolution) |+| `FRAMEGEN` | `0`, `1`, `2`, `3`, `adaptive` | Same as `BRIDGEPLAY_FRAMEGEN`: experimental frame generation in overlay-shim, adds up to half a frame of latency. `2` and `3` multiply the frame rate, `adaptive` fills up to the display refresh, `1` is the same as `2`, `0` is off (the default) |+| `FRAMEGEN_QUALITY` | `performance`, `balanced`, `quality` | Same as `BRIDGEPLAY_FRAMEGEN_QUALITY`. `balanced` when unset |+| `FRAMEGEN_UI` | `0`, `1` | Same as `BRIDGEPLAY_FRAMEGEN_UI`, Protect UI: keeps static HUD and menus sharp. On when unset |+| `FRAMEGEN_FALLBACK` | `0`, `1` | Same as `BRIDGEPLAY_FRAMEGEN_FALLBACK`, Fast-motion fallback: skips generated frames that would smear. On when unset |+| `FRAMEGEN_ENGINE` | `own`, `metalfx` | Same as `BRIDGEPLAY_FRAMEGEN_ENGINE`: the built-in optical flow (`own`, the default) or MetalFX frame interpolation || `NVAPI` | `0`, `1` | `1` turns on Apple's `nvapi64` and `nvngx` (DLSS on MetalFX) on an engine with a linked Game Porting Toolkit, for `d3dmetal` only, and makes D3DMetal report an NVIDIA GeForce RTX 4090 (`D3DM_VENDOR_ID=0x10de`, `D3DM_DEVICE_ID=0x2684`, `D3DM_DEVICE_DESCRIPTION`; a `D3DM_*` from a conf or the launch options wins), since games offer DLSS only on an NVIDIA adapter. Off by default, since an nvapi that answers sends some games down NVIDIA-only paths || `DLSS_FG` | `0`, `1` | With `NVAPI=1` on `d3dmetal`, `1` sets `CX_ACTIVE_GRAPHICS_BACKEND=d3dmetal` so WineCX reports hardware GPU scheduling, which DLSS frame generation requires. Off by default: [frankea/Whisky#231](https://github.com/frankea/Whisky/pull/231) saw MetalFX frame interpolation on an M5 with D3DMetal 4.0b2 hang WindowServer || `STDOUT_NULL` | `0`, `1` | `1` starts the game without a stdout handle, as Steam on Windows does. Source 2 treats any stdout as a console build (`Plat_IsConsoleApplication`) and then skips NGX, so Deadlock offers no DLSS |@@ -52,7 +55,7 @@ Wine uses the last entry for a DLL in `WINEDLLOVERRIDES`. The order is: backend,The backend is picked in this order:-1. `NOTPROTON_BACKEND=<name>` in the launch options+1. `BRIDGEPLAY_BACKEND=<name>` (or `NOTPROTON_BACKEND`) in the launch options2. `CX_GRAPHICS_BACKEND` in the launch options, which the Steam panel's Graphics menu sets.Any case is accepted. `d3dmetal`, `dxmt` and `dxvk` map to themselves, and `wined3d`,`opengl` and `wine` map to `wined3d`. Other values are logged and ignored@@ -96,7 +99,7 @@ Every other DLL that any backend ships is set to `b`. When you switch backends,left behind by another backend is replaced with Wine's own (the set-aside copy on anengine with D3DMetal; Apple's files are never copied into a prefix). `d3dmetal` also sets`CX_GRAPHICS_BACKEND=d3dmetal`. The run log-(`notproton-run.log`) shows each decision. The `notproton-backend` file in the game's+(`bridgeplay-run.log`) shows each decision. The `notproton-backend` file in the game'scompatdata folder has the current backend and why it was picked.## Examples@@ -140,15 +143,15 @@ RETINA=1## Native macOS games-A Mac build with no compatibility tool pinned runs through `~/.notproton/np-native`, not the+A Mac build with no compatibility tool pinned runs through `~/.bridgeplay/np-native`, not the`run` script, so the files above do not apply to it. np-native reads its own two files,-with variable names as they are (`NOTPROTON_FRAMEGEN=2`, `NP_PAD_MODE=hid`, `MTL_HUD_ENABLED=1`):+with variable names as they are (`BRIDGEPLAY_FRAMEGEN=2`, `NP_PAD_MODE=hid`, `MTL_HUD_ENABLED=1`):-1. `~/Library/Application Support/notproton/gamefixes/native-default.conf`, for every native game-2. `~/Library/Application Support/notproton/gamefixes/native/<appid>.conf`, which wins per key+1. `~/Library/Application Support/bridgeplay/gamefixes/native-default.conf`, for every native game+2. `~/Library/Application Support/bridgeplay/gamefixes/native/<appid>.conf`, which wins per keyThe Steam panel for such a game shows the Metal HUD, Frame Generation and the controllerlayer (`NP_PAD_MODE`: `hid`, `gc` or `off`). It writes the launch options as-`<home>/.notproton/np-native VAR=VALUE ... %command% <game args>`, and rewrites the older+`<home>/.bridgeplay/np-native VAR=VALUE ... %command% <game args>`, and rewrites the older`/usr/bin/arch -arm64 -x86_64 -e VAR=VALUE ... %command%` form into that one, dropping its`DYLD_INSERT_LIBRARIES`.diff --git a/docs/RELEASING.md b/docs/RELEASING.mdindex 3cdee6d..e4c1a9b 100644--- a/docs/RELEASING.md+++ b/docs/RELEASING.md@@ -78,3 +78,27 @@ archive, and never check on their own (`SUEnableAutomaticChecks` was false).the same app zipped as `NotProton.app`. Those users get it from Check for Updates…; itinstalls over `/Applications/NotProton.app`, and later updates come from the Bridgeplayfeed, matched by bundle identifier.++## The 3.0.0 rename++3.0.0 renames everything on disk from `notproton` to `bridgeplay`:++| Before | From 3.0.0 |+|---|---|+| `~/Library/Application Support/notproton` | `~/Library/Application Support/bridgeplay` |+| `~/Library/Caches/notproton` | `~/Library/Caches/bridgeplay` |+| `~/.notproton` (np-native, libnp_gamepad.dylib) | `~/.bridgeplay` |+| Steam tools `notproton-winecx-11.17`, `notproton-winehq`, … | `bridgeplay-winecx-11.17`, `bridgeplay-winehq`, … |+| `notproton-run.log`, `notproton-wine.log`, `notproton.log` | `bridgeplay-run.log`, `bridgeplay-wine.log`, `bridgeplay.log` |+| `NOTPROTON_*` in launch options and conf files | `BRIDGEPLAY_*` (the old spelling still works) |++Unchanged: `notproton.dylib`, `lib/notproton-backends`, the prefix markers in `compatdata`+(`notproton-build`, `notproton-backend`), the launcher bundle ids+`com.notproton.launcher.<appid>` and the `NOTPROTON_VERSION` define.++The app migrates on its first launch after the update, once Steam and every game are+closed: it moves the folders and switches games mapped to a `notproton*` tool to its+`bridgeplay*` name. What it replaces is backed up under+`~/Library/Application Support/bridgeplay/backups/migration-3.0.0/`. Nothing is needed in the+release steps; `scripts/release-local.sh` and `scripts/package-installer.sh` fall back to the+`notproton` folders on a Mac that has not migrated yet.diff --git a/docs/STATE.md b/docs/STATE.mdindex 10e566b..bdd9162 100644--- a/docs/STATE.md+++ b/docs/STATE.md@@ -6,15 +6,15 @@ Branch `integrate` = working fork state; nothing pushed except the `dxmt-e94c312- 14+ Windows-only games reach a full-screen window; Spider-Man 2 plays (77.9 fps, loads save). See compat/games.json.- Retina: D3DMetal back buffers sized in pixels (winemac patch, 233353d).- Xbox controllers: SDL-enabled winebus (9a0cbf5). Do NOT set winebus `Hidraw=1` for pads; it bypasses SDL.-- Controllers need no per-game Input Monitoring grant: the run script starts the launcher bundle directly instead of via `open`, so TCC attributes HID access to Steam (verified: all `kTCCServiceListenEvent` requests from Horizon `responsible=com.valvesoftware.steam`, authValue=2). `NOTPROTON_LAUNCH_SERVICES=1` restores the old `open` launch.-- Pads SDL doesn't know: `~/Library/Application Support/notproton/gamecontrollerdb.txt` is exported as `SDL_GAMECONTROLLERCONFIG`. GameSir G7 Pro dongle (3537:1022) mapping lives there; SDL IOKit axis order is X,Y,Z,Rz,Accel,Brake (browser Gamepad API numbers them differently). Never use the winebus registry `map` key: its loader (main.c:1101, writes `mappings[count]` after `count++`) crashes winebus and kills every pad.+- Controllers need no per-game Input Monitoring grant: the run script starts the launcher bundle directly instead of via `open`, so TCC attributes HID access to Steam (verified: all `kTCCServiceListenEvent` requests from Horizon `responsible=com.valvesoftware.steam`, authValue=2). `BRIDGEPLAY_LAUNCH_SERVICES=1` (or `NOTPROTON_LAUNCH_SERVICES=1`) restores the old `open` launch.+- Pads SDL doesn't know: `~/Library/Application Support/bridgeplay/gamecontrollerdb.txt` is exported as `SDL_GAMECONTROLLERCONFIG`. GameSir G7 Pro dongle (3537:1022) mapping lives there; SDL IOKit axis order is X,Y,Z,Rz,Accel,Brake (browser Gamepad API numbers them differently). Never use the winebus registry `map` key: its loader (main.c:1101, writes `mappings[count]` after `count++`) crashes winebus and kills every pad.- Bluetooth GameSir G7 Pro: its primary HID usage is Consumer, so stock SDL skips it; bundled libSDL2 carries winemac-patch/sdl2-iokit-gamepad-collection.patch, and the run script exports SDL_JOYSTICK_MFI=0 (SDL's MFi driver claims the pad but finds nothing in winedevice.exe). Verified 2026-10-11: winebus `sdl_add_device … is_gamepad 1`, user confirmed input in Megabonk.- Many games need `ROSETTA_ADVERTISE_AVX=1` (set in user gamefixes/default.conf and per-game Steam launch options).## Blockers / open-- NotProton can't deploy to Steam: App Management permission is lost on every ad-hoc rebuild (`run failed: cannot write /Applications/Steam.app/Contents/MacOS`). User must re-allow NotProton in Privacy & Security > App Management. Long-term: sign builds with a stable identity.+- Bridgeplay can't deploy to Steam: App Management permission is lost on every ad-hoc rebuild (`run failed: cannot write /Applications/Steam.app/Contents/MacOS`). User must re-allow Bridgeplay in Privacy & Security > App Management. Long-term: sign builds with a stable identity.- Ravenswatch: fixed by winemac 76d8f938… (CW HACK 22435 in winecx-d3dmetal-retina.patch: queue D3DMetal client view frames before WM_SIZE so ResizeBuffers sees the borderless size; 3024x1964 confirmed by user via Metal HUD 2026-10-10).- Borderlands 4: hangs before first frame (exception storm, likely Denuvo under Rosetta). Not solved.- The Last of Us Part I: not crashing; probably long first shader build. Skipped by user.- DOOM: The Dark Ages / Indiana Jones need hardware ray tracing (MoltenVK has none); Half-Life: Alyx is VR.-- Native macOS games (2026-10-11): stay native (no CompatToolMapping, no `userdata/*/config/compat.vdf` platform_overrides). Steam on macOS execs launch options literally, so `VAR=1 %command%` fails with OS Error 260; use `/usr/bin/arch -arm64 -x86_64 -e VAR=1 %command% <flags>` (also stops Rosetta inheritance from the x86_64 Steam client). Bluetooth GameSir G7 Pro in native Unity games: `native-shim/gamepad_shim.c` (DYLD_INSERT_LIBRARIES, built to `~/.notproton/libnp_gamepad.dylib`) presents it as an Xbox Wireless Controller and rewrites report 7 to the Xbox BT layout; verified in Chained Beasts Demo (arm64, controller works).+- Native macOS games (2026-10-11): stay native (no CompatToolMapping, no `userdata/*/config/compat.vdf` platform_overrides). Steam on macOS execs launch options literally, so `VAR=1 %command%` fails with OS Error 260; use `/usr/bin/arch -arm64 -x86_64 -e VAR=1 %command% <flags>` (also stops Rosetta inheritance from the x86_64 Steam client). Bluetooth GameSir G7 Pro in native Unity games: `native-shim/gamepad_shim.c` (DYLD_INSERT_LIBRARIES, built to `~/.bridgeplay/libnp_gamepad.dylib`) presents it as an Xbox Wireless Controller and rewrites report 7 to the Xbox BT layout; verified in Chained Beasts Demo (arm64, controller works).diff --git a/docs/WINECX.md b/docs/WINECX.mdindex 6404c9d..c279239 100644--- a/docs/WINECX.md+++ b/docs/WINECX.md@@ -1,6 +1,6 @@# WineCX engine-NotProton's second free engine. WineCX is CodeWeavers' open-source (LGPL) CrossOver 26.3+Bridgeplay's second free engine. WineCX is CodeWeavers' open-source (LGPL) CrossOver 26.3Wine changes, rebased by dappermint onto upstream Wine([dappermint/winecx](https://github.com/dappermint/winecx)). It is built in CI into a Whiskyruntime by [dappermint/winecx-gptk](https://github.com/dappermint/winecx-gptk).@@ -9,15 +9,15 @@ Two releases are pinned side by side (`FreeEngineWinecx.releases`):| Build | Runtime | winecx | Wine | Tool | Bundle ||---|---|---|---|---|---|-| `winecx-11.17` (current) | 4.7.3 | `e0aa380` | 11.17 | `notproton-winecx-11.17` | `WineCX 11.17.app` |-| `winecx-11.15` | 4.5.125 | `5b45f45` | 11.15 | `notproton-winecx` | `WineCX 11.15.app` |+| `winecx-11.17` (current) | 4.7.3 | `e0aa380` | 11.17 | `bridgeplay-winecx-11.17` | `WineCX 11.17.app` |+| `winecx-11.15` | 4.5.125 | `5b45f45` | 11.15 | `bridgeplay-winecx` | `WineCX 11.15.app` |The WineCX row installs the current one. Each release is its own runner build with its own-pins, ntdll detours and Steam tool. `notproton-winecx` stays on 11.15: every existing prefix's+pins, ntdll detours and Steam tool. `bridgeplay-winecx` stays on 11.15: every existing prefix'sbuild record (`notproton-build`) names `winecx-11.15`, and `refuse_other_build` in`compat_run.sh` refuses a prefix claimed by another build, so moving the default tool wouldstop every WineCX game until its prefix is rebuilt. 11.17 is picked per game as "WineCX 11.17"-(`notproton-winecx-11.17`), on a rebuilt prefix.+(`bridgeplay-winecx-11.17`), on a rebuilt prefix.4.7.3 over 4.5.125: msync fixes (wake one waiter, skip wake syscalls nobody waits on, sleepinstead of spinning while a wait registers, unregister on contention), kernelbase@@ -31,12 +31,12 @@ Compared with the WineHQ 11.15 engine it adds:round trips that slow down CPU-heavy games.- **D3DMetal support** through CrossOver's hooks (winemac `macdrv_functions`, the`libd3dshared` non-native code regions in ntdll, and the d3dkmt answers). This only works- with a Game Porting Toolkit you install yourself. NotProton never downloads or ships it.+ with a Game Porting Toolkit you install yourself. Bridgeplay never downloads or ships it.- **DXMT master and DXVK-macOS 1.10.3** as backends a game opts into. DXMT is the same`e94c312` build as the WineHQ engine ([DXMT.md](DXMT.md)), not the archive's 0.80. Thebuiltin Direct3D is Wine's own, or D3DMetal once a Game Porting Toolkit is linked.-In NotProton the current build is `winecx-11.17`, tool `notproton-winecx-11.17`, shown as+In Bridgeplay the current build is `winecx-11.17`, tool `bridgeplay-winecx-11.17`, shown as"WineCX 11.17 (msync, D3DMetal)". Like the WineHQ engine it needs no CrossOver license. The licence checktreats it as free only because the loader hash matches the pinned one, so a CrossOver installcan never pass as it.@@ -80,10 +80,10 @@ waiting on.Layout inside the archive: `Libraries/Wine` is the Wine tree (`bin/`, `lib/wine/{x86_64-unix,x86_64-windows,i386-windows}`, bundled dylibs in `lib/`, `share/wine` with wine-mono 11.2.0and gecko). `Libraries/DXMT/{x64,x32}` holds DXMT 0.80's frontends with the builtin marker-stripped, which NotProton does not use. `Libraries/DXVK/{x64,x32}` holds DXVK. A 0.80-era-`winemetal` is a builtin in `lib/wine`, which NotProton replaces.+stripped, which Bridgeplay does not use. `Libraries/DXVK/{x64,x32}` holds DXVK. A 0.80-era+`winemetal` is a builtin in `lib/wine`, which Bridgeplay replaces.-## What NotProton lays out+## What Bridgeplay lays outThe engine root (`…/WineCX 11.17.app/Contents/SharedSupport/CrossOver`, cloned into the runner`runners/crossover-winecx-11.17`; likewise for 11.15) is the archive's `Libraries/Wine`, plus:@@ -119,7 +119,7 @@ The engine's `winemac.so` is still replaced, for D3DMetal: winecx's own let D3DMswapchain from its view's frame in points, so with High Resolution (Retina) on, a game got ahalf-size drawable and showed only the top-left quarter, and a `ResizeBuffers` from`WM_SIZE` read the view's frame before it had followed the window, so the swapchain kept-its old size (Ravenswatch: 3024x1752 stretched over a 3024x1964 screen). NotProton installs+its old size (Ravenswatch: 3024x1752 stretched over a 3024x1964 screen). Bridgeplay installs`winemac-winecx-<build>.so`, built from winecx `e0aa380` with`winemac-patch/winecx-11.17-d3dmetal-retina.patch` (11.17) or from `5b45f45` with`winemac-patch/winecx-d3dmetal-retina.patch` (11.15), see `winemac-patch/README.md`, pinned as@@ -133,7 +133,7 @@ macOS 26 SDK lacks. A gamepad then had no path into Wine: winebus ignores the IOHID device for a gamepad unless that device has `Hidraw=1`, and with it the pad comes in as`is_hidraw 1, is_gamepad 0`, which XInput never opens.-NotProton installs `winebus-winecx-<build>.so`: that winecx tree's own, built with+Bridgeplay installs `winebus-winecx-<build>.so`: that winecx tree's own, built with`SONAME_LIBSDL2` = `libSDL2-2.0.0.dylib`, the name the WineHQ engine's `winebus.so` dlopens.SDL's bus then presents the pad as a gamepad (`is_gamepad 1`), the device XInput opens.dyld resolves the leaf name through the caller's `LC_RPATH`s, and `winebus.so` carries@@ -262,20 +262,20 @@ name CrossOver gives it when it copies it into each prefix. The prefix's placeho## Using D3DMetal with your own Game Porting Toolkit-Apple's licence does not let NotProton redistribute D3DMetal, so you supply it:+Apple's licence does not let Bridgeplay redistribute D3DMetal, so you supply it:1. Download the Game Porting Toolkit from Apple:https://developer.apple.com/download/all/?q=Game%20Porting%20Toolkit (free Appledeveloper account).2. Open the disk image ("Evaluation environment for Windows games").3. Copy the **contents of its `redist/lib` folder** into- `~/Library/Application Support/notproton/gptk/`, so you end up with `gptk/external/` and+ `~/Library/Application Support/bridgeplay/gptk/`, so you end up with `gptk/external/` and`gptk/wine/`.-4. In NotProton's Status page, press **Rescan** on the "Game Porting Toolkit" row. It turns+4. In Bridgeplay's Status page, press **Rescan** on the "Game Porting Toolkit" row. It turnsgreen with "Linked from <path>." If the WineCX engine is not installed yet, "Download & SetUp" on the "WineCX Engine" row links it during setup.-NotProton looks in this order and links the first complete copy: that folder (the+Bridgeplay looks in this order and links the first complete copy: that folder (the`redist` folder itself, or the whole volume, is also accepted), then`/Applications/Game Porting Toolkit.app` (`brew install --cask gcenx/wine/game-porting-toolkit`,which keeps it in `Contents/Resources/wine/lib`), then `~/Applications/Game Porting Toolkit.app`.@@ -284,7 +284,7 @@ A copy counts only when `external/libd3dshared.dylib`, `external/D3DMetal.framew`wine/x86_64-windows/{d3d10,d3d11,d3d12,dxgi}.dll` are all present and each forwarder carriesthe `Wine builtin DLL` marker. GPTK 4.0 beta 2 also has `wine/x86_64-unix/<name>.so` (linksto `../../external/libd3dshared.dylib`), `nvapi64` and `nvngx-on-metalfx`, `License.rtf` and-`SOURCE.txt`; the unix halves and nvapi64 are linked when present. NotProton only reads the+`SOURCE.txt`; the unix halves and nvapi64 are linked when present. Bridgeplay only reads thefolder.## Risks@@ -311,7 +311,7 @@ folder.- **The CrossOver user profile.** A prefix built by another engine keeps its profile under`users/<name>`, while CrossOver-lineage Wine uses `users/crossover`([frankea notes](https://github.com/frankea/Whisky/releases/tag/v4.5.105-beta.1)).- NotProton prefixes are tied to one build, so this only matters if a prefix is moved+ Bridgeplay prefixes are tied to one build, so this only matters if a prefix is movedbetween engines.- **Bridge compatibility is inferred, not run.** `ntdll.so` exports a superset of stock11.15's (299 → 302 symbols), so `lsteamclient.so` resolves. The PE `ntdll.dll` exports were@@ -325,11 +325,11 @@ folder.https://github.com/3Shain/dxmt/tree/e94c312f5c054263acf261cfa109edf13e757587), DXVK zlib, MoltenVK Apache-2.0. The tarball alsobundles nixpkgs libraries: ffmpeg 7.1.1 built `--enable-gpl` with x264/x265 (GPL-3.0+),and gstreamer's fdk-aac plugin. It ships **no licence texts**, and winecx-gptk has no- licence of its own. NotProton only downloads the upstream release on the user's machine+ licence of its own. Bridgeplay only downloads the upstream release on the user's machineand redistributes none of it. Anyone mirroring the archive takes on those obligations.- **Rosetta.** The engine is x86_64 and Apple has said Rosetta is largely going away inmacOS 28. D3DMetal is x86_64 only too (winecx-gptk README).-- **GPTK authenticity.** NotProton checks the builtin marker and file presence but not Apple's+- **GPTK authenticity.** Bridgeplay checks the builtin marker and file presence but not Apple'scode signature (Whisky checks both, in `GPTKImporter+Authenticity.swift`). The payload isa local folder the user chose.@@ -374,4 +374,4 @@ python3 apply.py <ntdll.dll> <out> <detour bin> # patched hashesThe unpack test (`FreeEngineWinecxTests.unpacksRealArchive`, once per release) checks all ofthis against the real archive when `NOTPROTON_WINECX_ARCHIVE` points at it, or when it sits in-NotProton's download cache.+Bridgeplay's download cache.diff --git a/docs/dualsense-bluetooth.md b/docs/dualsense-bluetooth.mdindex 8a8eb32..2534037 100644--- a/docs/dualsense-bluetooth.md+++ b/docs/dualsense-bluetooth.md@@ -1,6 +1,6 @@# DualSense Bluetooth transport-NotProton builds and packages `controllers/dualsense` with its runtime.+Bridgeplay builds and packages `controllers/dualsense` with its runtime.The launcher and broker run per game session; the injected facade containsarm64 and x86_64 slices.@@ -90,7 +90,7 @@ write deadline independently, so a blocked IOKit call cannot hang shutdown. Cleaonly when the game touched them.Runtime files and diagnostics are under-`~/Library/Application Support/notproton/controllers/dualsense/`.+`~/Library/Application Support/bridgeplay/controllers/dualsense/`.The `sessions/<AppID>-status.json` file contains transport counters. The`sessions/<AppID>.json` file contains a temporary credential and should not beincluded in issue reports. The launcher removes it on normal exit.diff --git a/docs/game-mode-host.md b/docs/game-mode-host.mdindex e1f04f9..0fd0340 100644--- a/docs/game-mode-host.md+++ b/docs/game-mode-host.md@@ -15,7 +15,7 @@ external launchers retain their original identities. This avoids assigningthe game icon to every service in the prefix.Both helpers are built and included in the normal app payload. Installation-and integrity checks cover them, and removing NotProton removes them with its+and integrity checks cover them, and removing Bridgeplay removes them with itssupport directory.This declares eligibility and preserves application identity. macOS still