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_47

• Install vcrun2022

• Adjust 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.

If you don't want to read text, find a video documenting the process here. Thanks to Connor for providing the screenshots and transcription!

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

Protontricks as Shown in Discover

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

Opening Protontricks

1. When Protontrick opens, select Cyberpunk:

Finding Cyberpunk 2077 in Protontricks

1. Choose "Select the default wineprefix":

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

Selecting d3dcompiler_47

Selecting vcrun2022

If you do not see vcrun2022 please verify you're on the latest version of Protontricks

Apply via "OK". You may receive an error below or similar. If you do, click "Yes" to continue the installation.

Example Installation Warning

Lutris: setting up

Use Lutris only if you cannot make Protontricks work!

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.

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:

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

The command is case sensitive. Copy-paste the text from the box above to make sure.

Setting Launch Options in Steam

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%

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

Don't forget to click the + button for the changes to save.

Variable Name and Value are both case sensitive, Copy-paste for certainty.

Anything that includes = and doesn't start with - goes to Environment Variables, while things starting with**-usually go under Game Arguments, for example-skipStartScreen**

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:

https://monroeworld.com/steamdeck/proton.txtmonroeworld.com

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.

You can check protontricks' github page. If there is anything seriously broken, you will find something there.

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