Bridgeplay README

项目的 README,来自 github.com/raymondchins/Bridgeplay。合并为一个 markdown 文件:README.md。

Bridgeplay: Windows games, in your Mac's Steam

Windows-only Steam games on Apple Silicon, right inside the Steam you already use.
Same library. Same Play button. No bottles, no second launcher.

Website Stars Apple Silicon macOS 26+ License GPL-3.0

Bridgeplay is a fork of NotProton by NotProtonNot. Games run on CodeWeavers' open-source Wine, the engine behind CrossOver, and Apple's Game Porting Toolkit. I'm not affiliated with either. If CrossOver works for you, buy it: that money is a big part of what keeps Wine on the Mac moving. Bridgeplay is a hobby project I maintain part-time, so support is best-effort. Full list in Credits and Support Wine.


What Bridgeplay does: plays inside Mac Steam, experimental frame generation, DLSS answered by MetalFX, DirectX 12 on Metal, any controller, full Retina one switch away, guided install

What it does

Plays inside Mac Steam Windows games sit in your Mac Steam library and start with Play. They run in Wine under Rosetta 2.
DirectX 12 on Metal Apple's D3DMetal runs DirectX 11 and 12 on your Mac's GPU.
DLSS, answered by MetalFX Games on D3DMetal see an NVIDIA card by default, so DLSS shows up. Apple's toolkit runs it on MetalFX.
Frame generation (experimental) Up to 3× displayed frames, with a little added latency. Off by default; turn it on per game.
Any controller DualSense, Xbox, GameSir and more, with no mapping screen.
Full Retina, one switch away Off by default because it's slower. Turn on High Resolution to draw at your display's real resolution.
Guided install A Setup Assistant walks you through Rosetta, Steam and permissions.

Mac gaming, unleashed: 007 First Light running on Direct3D 12 through D3DMetal, with the Metal HUD at 90 fps

Illustrations of the real screens.

Already playing

Games running with Bridgeplay: Resident Evil Requiem, Marvel's Spider-Man 2, 007 First Light and more

Developer's tests on an M5 Max MacBook Pro with Game Porting Toolkit 4.0 beta 3: 90+ fps, with MetalFX upscaling and frame generation where listed. Settings come from each game's launch log.

Game Launch settings
Resident Evil Requiem D3DMetal · DLSS → MetalFX · DLSS Frame Gen (experimental) · Retina · V-Sync forced
Marvel's Spider-Man 2 D3DMetal · Retina · MSync
007 First Light D3DMetal · DLSS → MetalFX · DLSS Frame Gen (experimental) · Retina

Also running on the same setup: Mortal Kombat 1, The Last of Us Part I, Death Stranding Director's Cut, Horizon Zero Dawn, Split Fiction, It Takes Two, A Way Out, Batman: Arkham Knight, Sifu, Ghostrunner, Ravenswatch, Megabonk, PowerWash Simulator 2, The Witcher 3.

Most games with kernel-level anti-cheat won't run.

Compatibility list

Every game tested so far, and the Mac it ran on, is at bridgeplay.dev/compatibility. It combines results a maintainer checked (compat/), one-tap reports from players, and CrossOver ratings from AppleGamingWiki for games nobody has tried with Bridgeplay yet.

To add yours: after you play, Bridgeplay asks once per game How did it run? One tap posts the result, with your Mac and the game's log, to Compatibility reports. No GitHub account needed, and the log is stripped of your user, computer and Steam account details. Report Your Games… in the Prefix menu covers everything you've already played, and bridgeplay.dev/privacy lists what a report contains. Without the app, use the Game report form.

Install

  1. Download Bridgeplay from bridgeplay.dev: Bridgeplay.dmg, notarized by Apple.
  2. Drag Bridgeplay into Applications and open it. macOS asks once whether to open an app downloaded from the internet: click Open. It needs an admin account.
  3. Follow the Setup Assistant: Rosetta, Apple's graphics (Download fetches them, and Steam from Valve if it's missing), Steam sign-in, App Management and a couple of other standard macOS prompts. Every download is verified: Bridgeplay's signature or pinned hashes for its own files and the engine, Apple's signature for the toolkit's files, Valve's for Steam. Setup modifies your Steam app; see What Bridgeplay changes in Steam.
  4. Press Play on any Windows game in Steam. The first time you use a controller, allow Steam's Input Monitoring request.

Each game's Bridgeplay settings (graphics backend, performance overlay, frame rate limit, scaling filter, DLSS, frame generation, controllers) are in Steam: right-click the game, Properties… › Bridgeplay.

Updates install themselves: Bridgeplay, its patch in Steam and the engine. Refresh on the Status page checks on demand.

The Setup Assistant's graphics download carries Apple's Game Porting Toolkit redistributables, unmodified, under Apple's own license; docs/GPTK-LICENSE.md records how Bridgeplay handles it. You can use your own copy from Apple instead. Bridgeplay is free and non-commercial.

The Setup Assistant working through Your Mac, Rosetta, Graphics, Steam and Set Up

Requirements

Check your Mac in one click on bridgeplay.dev, next to the minimum requirements

Mac Apple Silicon, M1 or later. Intel Macs are not supported.
macOS 26 or later (macOS version guide)
Steam A Steam account. Windows games install from Steam as usual.
Download About 550 MB: a 19 MB disk image, then about 530 MB, most of it the engine, that the Setup Assistant fetches. Installing Rosetta 2 and Steam, and signing in to Steam, need internet.

Guides and help

The guides on bridgeplay.dev cover installing Bridgeplay, troubleshooting, DirectX 12, DLSS and frame generation, and anti-cheat. The FAQ answers common questions, and the compatibility list shows which games other players got running.

How it works

Bridgeplay runs inside the native macOS Steam client and registers itself as a Steam Play compatibility tool. Under the hood:

How a Windows game reaches the Mac's GPU: Steam, Bridgeplay, the WineCX and Wine engines, D3DMetal, DXMT, DXVK and MoltenVK, then Metal, with the open-source project behind each piece

Building from source: see docs/DEVELOPING.md, docs/ARCHITECTURE.md and docs/BUILD-LOCAL.md. The graphics download (Bridgeplay-Installer.zip) is built from installer/ by scripts/package-installer.sh.

What Bridgeplay changes in Steam

Bridgeplay modifies your Steam app. It copies a library (notproton.dylib) into /Applications/Steam.app, makes Steam load it at startup through Info.plist, and re-signs Steam on your Mac, replacing Valve's signature. The library hooks Steam's compatibility tool, shortcut and launch option code, and edits Steam's interface in memory to show Steam Play.

Also changed:

Valve doesn't support or endorse Bridgeplay, and modifying Steam may go against the Steam Subscriber Agreement. Use it at your own risk. Repair Steam or Remove Everything on the Status page restores Steam's Info.plist; if Valve's signature isn't back, reinstall Steam from Valve.

Online games and anti-cheat

Online games with anti-cheat (Easy Anti-Cheat, BattlEye and others) often won't start, and Bridgeplay can't promise that anti-cheat, VAC included, won't flag it. Counter-Strike 2 and Dota 2 run, but VAC keeps them off its secure servers. Play online at your own risk. The compatibility list shows what other players found.

Credits

Bridgeplay is a fork of NotProton by NotProtonNot and its contributors (GPL-3.0), by way of Leon Seemann's NotProton-WineHQ. The Steam hooks, the Steam Play interface patches, the run script and the steamclient bridge all started as their work. Copyright and license details are in NOTICE.

NotProton in turn thanks the people who came before it, among them Nat Brown's Kaon, mont127's Neutron and Gio's work on Steam Play in Mac Steam; see docs/UPSTREAM.md.

Support Wine

Wine on the Mac exists largely because of CodeWeavers, the biggest contributor to the Wine project. They fund that work by selling CrossOver. Bridgeplay's free engine comes from the WineCX code CodeWeavers publishes, so every game it runs also stands on their work.

If you can, buy CrossOver.

License

Bridgeplay is licensed under the GPL-3.0. Third-party licenses, and the source for the patched Wine files the app ships (LGPL-2.1-or-later), are listed in NOTICE.

 Built by Raymond Chin, Jakarta.

Bridgeplay is built on NotProton and is not affiliated with or endorsed by Apple, Valve, Microsoft, NVIDIA, Sony, CodeWeavers or any game publisher. Steam is a trademark of Valve Corporation; Mac, macOS, Metal, MetalFX and Rosetta of Apple Inc.; Windows, DirectX and Xbox of Microsoft; CrossOver of CodeWeavers; DLSS and GeForce of NVIDIA; DualSense of Sony Interactive Entertainment. Game names, game art and other product names belong to their owners and are used only to identify them.

Bridgeplay (raymondchins/Bridgeplay)

正在搜索数据库…

这是什么?Bridgeplay 可以让你在 Apple Silicon 芯片的 Mac 版 Steam 客户端里直接运行仅支持 Windows 的 Steam 游戏。它借助 CodeWeavers 的 Wine 和苹果的 Game Porting Toolkit,让这些游戏和原生游戏一样,点击“开始游戏”按钮即可启动。
这是一个单独的启动器,还是集成在 Steam 里面?它是一个 macOS 安装程序,会修改你现有的 Steam.app,把自己注册为 Steam Play 兼容工具。因此不需要额外的启动器:你只需在正常的 Steam 游戏库中,对 Windows 游戏点击“开始游戏”即可。
我该怎么让它运行起来?从 bridgeplay.dev 下载 Bridgeplay-Setup.zip,打开它(你需要在 macOS 的 Gatekeeper 中允许其运行),然后按照设置助手的提示完成 Rosetta 安装、Steam 登录和权限设置。完成后,在 Steam 中点击任意 Windows 游戏的“开始游戏”,即可通过 Bridgeplay 启动。
安装前我需要准备什么?一台搭载 Apple Silicon 芯片(M1 或更新机型)、运行 macOS 26 或更高版本的 Mac,一个 Steam 账号,一个用于安装的管理员账户,以及大约 570MB 的下载量。安装过程还需要能访问互联网,以下载 Rosetta 2 和 Steam。
我 Steam 上的所有游戏都能运行吗?大多数带有内核级反作弊的游戏(如 Easy Anti-Cheat、BattlEye 等)根本无法启动。受 VAC 保护的游戏(如《反恐精英 2》和《Dota 2》)可以运行,但会被排除在安全服务器之外,因此联网游戏需要自行承担风险。
我提交游戏兼容性报告时,数据会发送到别处吗?会。点一下即可提交的“游戏运行情况如何?”报告,会把你的 Mac 型号和游戏的启动日志上传到一个共享的兼容性数据库。不过在上传前,日志中的用户名、计算机名称和 Steam 账号信息都会先被删除。
安装 Bridgeplay 后,它会对我的 Mac 做哪些改动?它会把一个库文件复制到 Steam.app 中,让 Steam 在启动时加载该文件,然后重新签名 Steam(替换掉 Valve 的签名),重置部分 macOS 权限,并将自己设为默认的 Steam Play 兼容工具。状态页面中的“修复 Steam”选项可以恢复 Steam 原始的 Info.plist。
Bridgeplay 和 NotProton 是同一个东西吗?不是。Bridgeplay 是 NotProton 的一个免费分支(NotProton 本身基于 NotProton-WineHQ 开发),它沿用了 NotProton 的 Steam 钩子和 Steam Play 界面补丁,而原作者的工作仍在另行进行。
Mac 没有 NVIDIA 显卡,DLSS 是怎么工作的?在苹果的 D3DMetal 上运行的游戏,默认会识别到一块虚拟的 NVIDIA GeForce RTX 4090,因此 DLSS 选项会显示出来。实际进行画面超分辨率处理的是苹果的 MetalFX,而不是真正的 NVIDIA 硬件。
我可以用自己的 CrossOver 许可证,而不用内置的免费引擎吗?可以。如果你已经购买了 CrossOver,Bridgeplay 就可以在你的 CrossOver 上运行游戏,而不必使用它自带的、基于 CodeWeavers 公开的 LGPL 源代码构建的免费 WineCX 引擎。
大小
91.5 MB
星标
1K
时长
29天
提交 · 90 天