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
dylib/
notproton.dylib is loaded into every Steam client on the Mac, through
DYLD_INSERT_LIBRARIES in Steam.app's Info.plist. A crash, hang or leak here takes Steam
down for the user. The constructor in core/loader.c only does work in steam_osx and
Steam Helper.
- Steam addresses come from
signatures/macos.arm64/<steam build>.json, resolved throughresolver/. If a signature doesn't resolve on a Steam build, the feature stays off; the dylib must not guess an address. A new or renamed signature needs an entry in the signature files and a passingmake sigcheckandmake sigdb-fixtures.make anchorcheckchecks the files against a realsteamclient.dylib, so run it on a Mac with Steam. - Child processes:
hooks/hook_spawn.cstrips the insert from processes Steam starts, so games and other apps don't inherit the dylib. Keep that true for any new spawn path (make spawn-env). - The run script is
feats/compat_run.sh. It is POSIXsh, runs once per game launch, and is embedded into the dylib at build time (embed_script.py→out/generated/compat_run.h), so runmakeafter editing it.- It reads settings as
NOTPROTON_<X>. The loop at its top maps the user-facingBRIDGEPLAY_<X>spelling onto them, so document new settings asBRIDGEPLAY_<X>. - Gamefix
.conffiles are data, never shell code. A new key needs a case in the allow-list ingamefix_reason, a row in docs/GAMEFIXES.md, and a passingmake gamefixescheck. - Checks for the run script:
runcheck,envcheck,settingscheck,routecheck,gamedrivecheck,prefixnotecheck,powernotecheck,exitcheck,launchprogresscheck,launchercheck,gamefixescheck,anticheatcheck,padcheck.
- It reads settings as
- Tests live in
dylib/tests/. They run without Steam or Dobby; several#includethe.cfile under test for that reason. Add a new check as a Makefile target and toCI_CHECKSin the Makefile.