Modding on Linux
How to get mods working on SteamDeck or other Linux distros
Summary
This page tells you how to set the launch options for Steam under Linux.
Wait, this is not what I want!
If you have trouble after an update and have exhausted all the usual steps, double-check your Launch Options (sometimes, Steam helpfully changes them to make you crash)
If you want to optimize Cyberpunk 2077 settings for your SteamDeck, find a guide on /r/SteamDeck
For a video about modding on mac, see https://www.youtube.com/watch?v=x0CDcBui2qE&t=20s
TL;DR
You need to
Install
d3dcompiler_47Install
vcrun2022Adjust the Steam launch option to be:
WINEDLLOVERRIDES="winmm,version=n,b" %command%
The guide below has been confirmed working for dozens of people on SteamDeck, various Linux distributions, and Mac OS. Follow it by the letter and it will work for you as well.
Installing the required tool
To play games on Linux, you need various programs and libraries. On the steam deck, most are preinstalled, and all you need is a tool to configure them.
This guide has information about Protontricks (recommended) and Lutris (only here for the sake of completeness). If you use anything else, we can not support you
Protontricks: Setting up
Make sure that you are on the most recent version of Protontricks. This guide will follow how to perform these steps on a SteamDeck, but other systems running KDE Plasma should be similar. Other Linux distros will need to go to their respective app stores, or use the Flatpak CLI tool, to download Protontricks.
To configure the necessary parameters, you can use the app Protontricks, which you can download through the built-in app browser "Discover":
Open Protontricks (you can search for this by selecting start menu)
When Protontrick opens, select Cyberpunk:
Choose "Select the default wineprefix":
Add an override: Check both of the checkboxes below
d3dcompiler_47
vcrun2022Apply via "OK". You may receive an error below or similar. If you do, click "Yes" to continue the installation.
Lutris: setting up
Taken from CET's github
Open Lutris
Right click on the game >
Settings>Runner optionsWhile newer versions of Lutris can use Proton, it is advised you use Wine-GE instead. Make sure you're using at least
lutris-GE-Proton8-1
Scroll down to DLL overrides, click on Add to add a key. Add the following keys:
Launch Options
You need to pass a few parameters to the Cyberpunk.exe to enable mods. Read the section for your client to find out how.
If you have typos or forget characters in your launch parameters, they will not work. You can copy-paste the text from the guide below.
For a full list of launch options, check Launch parameters. Use them at own risk!
Steam: Launch Options
Switch to steam and make sure that the launch options are set as below:
The command is case sensitive. Copy-paste the text from the box above to make sure.
If this still doesn't work, check the Cyber Engine Tweaks wiki for additional instructions, or find us on Discord in #mod-troubleshooting.
GOG: Launch Options
You can find the launch options for GOG in the game's config menu under Manage Installation -> Configure...
As under Steam, you have to add the following:
The command is case sensitive. Copy-paste the text from the box above to make sure.
Heroic: Launch Options
While at your library right click Cyberpunk then navigate to Settings -> ADVANCED and scroll down to Environment Variables
Now set a new variable name WINEDLLOVERRIDES with a value of winmm,version=n,b
Variable Name and Value are both case sensitive, Copy-paste for certainty.
Troubleshooting
I can't install vcredist!
Try running the following shell command:
This is not working!
Check the launch options
This is the most common error. You wouldn't believe how often people show up in the support discord channel, yell in frustration for 10 minutes, and then found out that they included an extra space, forgot a letter, or made a simple typo.
Do not be these people. Copy-paste from the guide and delete any extra spaces.
“Invalid file magic number”
Delete/uninstall the current protontrick version. Try the beta-version from here and running the commands:
Update protontricks
Make sure to be on the last version of protontricks. If that does not work, try the second-to-last version — sometimes, the tools themselves break.
Ask for help
You can find us on the modding discord in #cet-troubleshooting or #red4ext-support. Beware: If it turns out to be a typo in your launch options, there will be snark. ;)
Last updated