Skip to content

Latest commit

 

History

History
171 lines (103 loc) · 7.67 KB

modding-on-linux.md

File metadata and controls

171 lines (103 loc) · 7.67 KB
Raw
description
How to get mods working on SteamDeck or other Linux distros

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!

TL;DR

You need to

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

{% hint style="danger" %} 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. {% endhint %}

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

{% hint style="warning" %} 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. {% endhint %}

{% hint style="info" %} If you don't want to read text, find a video documenting the process here. Thanks to Connor for providing the screenshots and transcription! {% endhint %}

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

{% hint style="info" %} If you do not see vcrun2022 please verify you're on the latest version of Protontricks {% endhint %}

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

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.

{% hint style="danger" %} 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. {% endhint %}

For a full list of launch options, check launch-parameters.md. 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%

{% hint style="danger" %} The command is case sensitive. Copy-paste the text from the box above to make sure. {% endhint %}

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%

{% hint style="danger" %} The command is case sensitive. Copy-paste the text from the box above to make sure. {% endhint %}

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.

{% hint style="danger" %} Variable Name and Value are both case sensitive, Copy-paste for certainty. {% endhint %}

{% hint style="info" %} Anything that includes = and doesn't start with - goes to Environment Variables, while things starting with**-usually go under Game Arguments, for example-skipStartScreen** {% endhint %}

Troubleshooting

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.

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.

{% hint style="info" %} You can check protontricks' github page. If there is anything seriously broken, you will find something there. {% endhint %}

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