Modding on macOS
How to get mods working on the MacOS build of Cyberpunk 2077
This guide is currently a work in progress.
Modding Support on MacOS (or Lack Thereof)
At the time of writing, the only framework mod that is unofficially supported on the MacOS build of Cyberpunk 2077 is redscript starting with the 0.5.29 build. As such, the only mods that are supported on MacOS are pure redscript-only mods (i.e. no Codeware, no ArchiveXL, etc.)
Additionally, due to the security features built into MacOS, modding the game is possible, but much more annoying. You'll get a lot of scary-looking warnings and permission requests, but this is normal. Don't worry! We'll go through all of them here.
Getting Started
Download redscript for macOS
Find the latest release on the GitHub Releases for redscript
Be sure to download redscript-vX.X.XX-macos.zip
, NOT redscript-cli-aarch64-darwin
!
Install redscript to your game directory
Copy the contents of the zip/folder to your Cyberpunk 2077 install folder (the one with Cyberpunk2077.app
). The default locations can be found here:
Steam:
~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/
Non-Steam (e.g. GOG or AppStore):
/Applications/Cyberpunk 2077/
Unblock redscript in macOS
Open the Terminal app and run the following command to tell MacOS redscript is safe to run:
Steam:
xattr -r -d com.apple.quarantine "~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/engine/tools/"
Non-Steam (e.g. GOG or AppStore):
xattr -r -d com.apple.quarantine "/Applications/Cyberpunk 2077/engine/tools/"
Running Cyberpunk 2077 on macOS with redscript
The MacOS build of Cyberpunk 2077 will not start redscript automatically like the Windows build. Therefore, any redscript mods you install will not be included in the game automatically, but you don't have to run the script every time, only with new mods or updates to let them compile. You have three options:
1. Link bash script to your game client
a) Steam:
TODO: Steam is tricky one, as it doesn't allow to pick custom executable. Main idea is to rename original executable Cyberpunk2077
to Cyberpunk2077_real
, then ranaming launch_modded.sh
script to executable-like file, adjusting the code to call actual executable after redscript is compiled and finally making it recognize-able for macOS as such. If you find it hard, use option two or three, by running it manually with every new mod or every time.
Rename the executable inside
Cyberpunk2077.app
:
mv "~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/Cyberpunk2077.app/Contents/MacOS/Cyberpunk2077" "~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/Cyberpunk2077.app/Contents/MacOS/Cyberpunk2077_real"
Using preferable text editor (use
Text Edit
, if you don't have any), adjustlaunch_modded.sh
to our changes:
Locate following line:
"$game_dir/Cyberpunk2077.app/Contents/MacOS/Cyberpunk2077" "$@"
Replace it with following:
"$game_dir/Cyberpunk2077.app/Contents/MacOS/Cyberpunk2077.real" "$@"
Save the file with
Command
+S
.
Rename the launch script to executable:
mv "~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/launch_modded.sh" "~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/Cyberpunk2077"
Make sure it's executable:
chmod +X "~/Library/Application Support/Steam/steamapps/common/Cyberpunk 2077/Cyberpunk2077"
b) GOG:
Launch GOG Galaxy → Cyberpunk 2077 → More → Manage Installation → Configure → Add another executable / arguments
Locate the game path and ensure to select the script
/Applications/Cyberpunk 2077/launch_modded.sh
Press Select an executable to link, ensure Default executable is checked and press OK.
Now GOG Galaxy will run your script whenever you press Play.
c) App Store
Manually launch the script every time or with every new mod installed.
2. Run the Included Bash Script to Start Cyberpunk 2077
From Finder, double click the
launch_modded.sh
file in theCyberpunk 2077
folder
or
From Terminal,
cd
to your Cyberpunk 2077 folder (the same as before) and run./launch_modded.sh
3. Manually run redscript, then launch the game normally
😏 (more to come)
Last updated