# Linux (Proton)

{% hint style="info" %}
For a step-by-step guide on installing the basic dependencies to make Cyberpunk run under Linux, see [here](https://app.gitbook.com/s/4gzcGtLrr90pVjAWVdTc/for-mod-users/users-modding-cyberpunk-2077/modding-on-linux).
{% endhint %}

This is a basic guide to using the mod within Proton (aka Linux).

Please make sure your game works in proton *first*, before installing this mod.

## Enabling proton Experimental (Optional)

While this isn't a required step, it's useful for performance.

Right click the game in Steam and select 'Properties'. Go to the 'Compatibility' tab and tick 'Force the use of a specific Steam Play compatibility tool'.

In the dropdown, select 'Proton Experimental'.

## Setting up the mod with ProtonTricks

Please note - this method requires the use of Steam. For other options, see below.

First, follow the steps to install the mod. These are in the [wiki](https://wiki.redmodding.org/cyber-engine-tweaks/getting-started/installing).

Run `protontricks 1091500 --gui`, you may get an error saying "You are using a 64 bit WINEPREFIX", you can ignore this. Press 'Ok' when this error appears.

Choose the option 'Select the default wineprefix', then 'Run winecfg'. In the window that opens, select the 'Libraries' tab. In the dropdown on 'New override for library', select `version`. Click `Add`, then `Apply` and `Ok`.

You can now exit out of Protontricks and start your game. Check to see if the log exists after you run the game. If it's there, you've successfully installed the mod.

If you have issues with the mod still not working or the game just crashing, you can try this: re-open Protontricks like you did before, choose the option 'Select the default wineprefix', then 'Install a Windows DLL or component'. Tick `vcrun2022` and press Ok. If a window pops up, then go through the steps to install that runtime (just click next really), otherwise just wait until the Protontricks screen comes back. Now exit out of Protontricks and try launching the game. DON'T do this without first checking if the mod works without this step, since installing `vcrun2022` has been observed breaking game installs before, preventing the game from ever launching again and requiring a re-install.

**NOTES:** You will also need to install `d3dcompiler_47` with winetricks to get it to work now, contribution on how to do this would be much appreciated!

If `vcrun2019` breaks your install, it's been reported it can be fixed without reinstalling by deleting the contents of`/steamapps/compatdata/1091500`.

## Setting up the mod with proton as non-Steam Game

Please note, this method still requires the use of Steam. You must install Cyberpunk 2077 and then add it to your Steam library by following the [official instructions](https://help.steampowered.com/en/faqs/view/4B8B-9697-2338-40EC).

Search for the game APPID with: `$ protontricks -s name_of_the_game_on_your_steam_lib`

like:

`$ protontricks -s Cyberpunk 2077`

copy the APPID from the terminal then run:

`$ protontricks "APPID" --gui`

From now on, you can follow the Setting up the mod with ProtonTricks instructions.

## Setting up the mod without Steam by using Winetricks

For users running on the GOG version of the game, via launcher like [Lutris](https://lutris.net/), [Minigalaxy](https://github.com/sharkwouter/minigalaxy) or [GameHub](https://github.com/tkashkin/GameHub), those running from the direct GOG Galaxy Windows application through Wine, or those directly using the Game libraries, Protontricks won´t be helpful in your case, as Protontricks will notice that you don´t have the game on Steam.

Instead, use Winetricks in which Protontricks is derivated from. Please note that you may need to install [Winetricks](https://wiki.winehq.org/Winetricks) first, either through the official website or through your distribution's app store.

Lutris users may perform the following steps to activate the mod:

Authenticate with GOG Galaxy by clicking on the small profile icon to the right of the GOG entry. You will then be presented with a list of your owned games. Select Cyberpunk and install it - this will install the base version of the game with no other options selected. You may right click on the game icon after installation and choose the option to install the Phantom Liberty DLC if desired. Once installation is complete, select Cyberpunk 2077 and click on the Winetricks 'wine flute' icon along the bottom of the Lutris window. In the expanded menu, select 'Winetricks'.

Choose the option 'Select the default wineprefix', then 'Run winecfg'. In the window that opens, select the 'Libraries' tab. In the dropdown on 'New override for library', select `version`. Click `Add`, then `Apply` and `Ok`.

Alternatively, you may run Winetricks in itself if you use your default prefix, or from your custom prefix via: `WINEPREFIX=<Location of your WinePrefix directory> winetricks --gui` via the terminal.

From now on, you can follow the Setting up the mod with ProtonTricks instructions. If you want to verify in Winetricks has correctly taken in account your custom Wine directory, click on `Browse files` to see if it brings you to the designated folder.

## Thanks to

* [@bundyo](https://github.com/bundyo)
* [@okamidash (Author)](https://github.com/okamidash)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.redmodding.org/cyber-engine-tweaks/getting-started/installing/linux-proton.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
