Modding Cyberpunk 2077 on Linux isn't the most simple process because of all the specific libraries, Proton configurations, and proper launch options. Compared to using Nexus Mods on Windows it's quite the nightmare. However, this guide walks you through all the steps required to get mods working reliably on SteamDeck and other Linux distributions, covering both Protontricks and Lutris setups.

Takeaways:

  1. What's the best way to mod Cyberpunk 2077 on Linux.
  2. Cyberpunk Steam Deck and Linux Modding guide.

Prerequisites

Before you start anything else in this guide you need to make sure you have a few things ready to go. Without this you aren't going to be doing any modding.

  • Protontricks (most recent version)
  • Lutris (optional, for Wine-GE users)
  • Cyberpunk 2077 installed on your platform

Note: Other tools are not officially supported.

Protontricks Setup

  • Open Protontricks.
    • On SteamDeck: use the Discover app.
    • Other distros: install via Flatpak or your package manager.

how to install cyberpunk mods on linux

  • When Protontrick opens, select Cyberpunk:

cyberpunk modding on steam deck

  • Choose "Select the default wineprefix"

linux cyberpunk modding

  • Add an override > Install a Windows DLL or component then Check both of the checkboxes below:

How to mod cyberpunk on linux steam deck

d3dcompiler_47

How to mod cyberpunk on linux steam deck guide

vcrun2022

How to mod cyberpunk on linux steam deck steps

Note: If vcrun2022 is missing, update Protontricks to the latest version

  • Click OK. If a warning appears, click Yes to continue.

steam deck cyberpunk mod guide

Lutris Setup (Optional)

  • Open Lutris > Right-click Cyberpunk > Settings > Runner options.
  • Use Wine-GE (≥ lutris-GE-Proton8-1).

modding cyberpunk 2077 on linux

  • Scroll to DLL Overrides > Add keys:

lutris cyberpunk modding guide

Launch Options

Steam

  • Right-click Cyberpunk > Properties > Launch Options and Add:

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

steam deck cyberpunk modding guide

IMPORTANT: This is case sensitive so copy-paste to avoid errors.

GOG

  • Go to Manage Installation > Configure > Launch Options and Add:

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

linux cyberpunk mods

Heroic

  • Right-click Cyberpunk > Settings > ADVANCED > Environment Variables and Add:

Name: WINEDLLOVERRIDES

Value: winmm,version=n,b

How to mod cyberpunk on linux steam deck guide

  • Click + to save.

Use Environment Variables for parameters with =; arguments starting with - go under Game Arguments.

Troubleshooting

If you have any issues doing any of the things above these are going to be the most helpful steps you can take.

vcrun2022 fails to install: protontricks 1091500 --force vcrun2022

Invalid file magic number:

Launch issues / mods not working:

  • Check launch options for typos or extra spaces.
  • Copy-paste directly from this guide to ensure accuracy.

After game updates:

  • Steam may reset launch options. Always verify after updates.

Further help:

  • Cyber Engine Tweaks wiki
  • Discord: #mod-troubleshooting