Modding on Linux

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_47

• Install vcrun2022

• Adjust the Steam launch option to be: WINEDLLOVERRIDES="winmm,version=n,b" %command%

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

To configure the necessary parameters, you can use the app Protontricks, which you can download through the built-in app browser "Discover":

1. Open Protontricks (you can search for this by selecting start menu)

1. When Protontrick opens, select Cyberpunk:

1. Choose "Select the default wineprefix":

1. Add an override: Check both of the checkboxes below

Apply 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

1. Open Lutris

2. Right click on the game > Settings > Runner options

3. While 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

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.

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:

WINEDLLOVERRIDES="winmm,version=n,b" %command%

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:

WINEDLLOVERRIDES="winmm,version=n,b" %command%

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

Troubleshooting

I can't install vcredist!

Try running the following shell command:

protontricks 1091500 --force vcrun2022

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. ;)