Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
How to use MO2 - it's that simple
MO2 (Mod Organizer 2, Nexus | Github) is a free, widely-used mod manager, especially popular for Bethesda games like Skyrim or Fallout. It fully supports Cyberpunk 2077 and is praised for its ease of use.
Using MO2 keeps your base game directory untouched and allows for easy mod installation, uninstallation, and updating. Additionally, you can create different profiles for mod configurations.
If you need further help with MO2 beyond this guide, feel free to ask for assistance on their official Discord server.
Download MO2 from either Nexus Mods (yes, Skyrim Nexus) or GitHub
Install MO2
When installing, choose the Global Instance option (recommended for multiple games).
Or choose Portable Instance if you want a separate installation of MO2 for each game.
Launch MO2
Create a new instance:
Browse to the Cyberpunk 2077 installation folder to create the new game instance.
Customize your Profile Settings (Optional):
These can be left unchecked unless you need profile-specific INI files, save games, or automatic archive invalidation.
You can change these settings later as needed.
CET and Red4Ext have to be installed manually
Download Cyber Engine Tweaks (CET) and RED4ext from Nexus Mods manually
Install them by extracting their files to the game folder.
Go to the Nexus Mods website for Cyberpunk 2077 mods.
Download mods via the "Mod Manager Download" button. MO2 will start to automatically download the mod.
In MO2, open the Downloads tab and double-click the mod to install it.
After installation, ensure the mod is enabled by checking it in the Plugins list or the Installed Mods section.
If you have mods from external sources:
Download the mod and move it to the Downloads folder by using the file folder dropdown in MO2 ("Open Downloads folder").
Alternatively, drag and drop the mod into the Downloads tab within MO2.
You always have to launch the game through MO2 if you use MO2 as mod manager.
Always Launch the Game through MO2:
If you're using MO2 as your mod manager, make sure to run Cyberpunk 2077 via MO2.
Steam will still track your playtime and achievements.
Run the Game:
After setting up all your desired mods, click Run in MO2 to launch Cyberpunk 2077.
Stay up to date with the latest versions of both MO2 and the mods for the best experience and compatibility.
Modding your game, for users
Published: Jun 15, 2023 by Last documented update: Aug 25 2024 by
This page will give you a brief introduction of how mods work and how to install them by hand.
We strongly recommend using a mod manager, as manual modding is only recommended for advanced users.
Here are your options (wiki links):
If you want to create mods instead, check
If you need help installing Cyberpunk, check
If your modded install is acting up, please check
TL;DR: Your mods will not work unless you
put all files exactly into the right place
make sure to install all (and their requirements)
If you are on Linux/Steam Deck: follow to the letter
When you fuck things up, hit up or run and start over.
To see an , scroll down.
TL;DR:
Unless a requirement is marked as optional, your mod will not work if it is not installed.
Some requirements have requirements of their own. Make sure to check.
Cyberpunk 2077 offers limited out-of-the-box support via REDmod. To allow greater freedom, a number of core mods have been created — without them, we couldn't add items, influence the weather, or have flying cars.
Since this kind of mod interacts with the game's executable (.exe
), they will break every time CDPR updates.
TL;DR: you can ignore this unless you want to understand how things work, or want to install mods manually.
This list is supposed to give you an overview of which files go where. It is not a bucket list of things you have to install.
If REDmod is not installed and activated, your mods in /mods
will not load.
Loading a mod as REDmod means that Cyberpunk will precompile it to optimize load times — integrating it into the game's other files by adding it to the files under r6/cache
.
By contrast, vanilla mods (from /archive/pc/mod
) will be loaded individually and might add to your load times.
REDmods are installed in Cyberpunk 2077\mods
, where every mod has a subfolder with an info.json
.
If the mod contains only files inside the folder archives
, you can un-REDmod-ify it by moving all of those files to archive/pc/mod
.
If you had terrible experiences with Vortex for other games, be assured: Cyberpunk integration is working extremely well. Maybe give it another chance?
"Manual install" is a rather glorified term for "extracting the downloaded archive into your game directory". However, you have to make sure that the right files end up in the right folders.
You can inspect the file structure by simply opening the downloaded file, or by using this feature on Nexus (unless a mod author has disabled it):
The file structure is different for REDmods and non-REDmods. Mod authors usually tell you which file is which, though. To find out what that means, read on.
Here is how you can tell the two apart:
All REDmods mods will be preloaded by redMod.exe
before the game starts up. After a short delay, the mods will then be loaded as if they were part of the game itself — you're saving the startup delay on every savegame load.
On top of this, Vortex will let you define load order for REDmods. To support compatibility, it offers you automatic conversion.
Some mods (especially older ones) are just a loose collection of files without any folder structure:
To find out how to install, you have to read the mod's install instructions. You can read the next section for a general overview of which files go where, but that is not guaranteed to work.
As a rule of thumb, here's which files go where (unless the mod's instructions tell you otherwise):
Launch parameters for Cyberpunk2077.exe (and what they do)
Created: Jun 17 2024 by , based on research by Last documented update: Aug 25 2024 by
This page lists all known launch parameters for the Cyberpunk2077.exe
Just because the executable accepts these parameters doesn't mean that they do anything or were ever intended to.
If you are trying to get your modded steam deck to work, check
You need to send the parameters in the form of
-parameter arg
for example
-engine CGameEngine
Parameter | Argument (if given) | Explanation |
---|
Install the core requirements for Cyberpunk2077 modding, decide how to manage your mods, and set up a mod manager
While it is possible to install mods by hand (and many modders do in fact exactly that), we recommend using a mod manager.
This guide will walk you through installing and configuring your game. If you have already done that, you can configure the mod manager of your choice:
How to install mods with
How to configure
To learn about how to install mods at all, check
You have on the platform of your choice (Steam, GOG or EPIC)
You have the following things:
You have updated the following things:
driver
The latest for your operating system (checkout if that's what you're doing)
If you already have the game installed, you can skip this section and proceed with #configur
In order to set up your game to be best suited for mods, you'll want to keep a few things in mind:
TL;DR: If possible, install Cyberpunk 2077
on an SSD to speed up load time
outside of Program Files
to keep Windows from "protecting" your files
For the purpose of this guide, we will assume the following install paths:
Like everything else, Cyberpunk will run significantly faster from an SSD rather than a HDD.
Folder permissions can cause problems down the line, especially for Windows users. Most users never run into these, but you can prevent them altogether by installing your game to a folder like C:\Games
rather than C:\Program Files.
By default, all three platforms (GOG, Steam, and Epic) want to install the game to their own install location, which defaults to C:\Program Files
. That wouldn't be a problem if not for Windows and what it will permit there, which is not much.
You likely won't run into any of these problems, but you can rule them out altogether by installing Cyberpunk to a directory other than C:\Program Files
or C:\Program Files(x86)
, like C:\Games\Cyberpunk 2077
Now we will go through the install options to use on each platform to accomplish this, and the recommended settings for modded Cyberpunk 2077.
Open GOG Galaxy, click on "Owned Games" in the left sidebar, and scroll until you find Cyberpunk. Single click on its picture to display the main Cyberpunk page.
Click the button at the top of the page labeled "Install".
In the pop-up window, choose your install location:
Click the drop-down box
select "browse"
browse to the target folder (we're assuming C:\Games
)
You don't need to create a subfolder for Cyberpunk, as GOG will do that for you.
Optional: Select a game language other than English
Optional: Create a desktop shortcut by ticking the first box "Create desktop shortcut"
Optional, but recommended: Disable auto-updates by unchecking the second box "Keep this game up to date automatically"
Press "Install"
Wait until GOG has done it's thing, then proceed to the next section.
To be done
To be done
Once the game has installed, we want to make it run with mods. Click the button to the right of the play button (formerly the install button) pictured below.
From there, select "Manage Installation" and then "Configure". A window will pop up where you can change your desired settings:
Installation (first tab): Disable auto-updates
DLC (third tab): Select at least Cyberpunk 2077 REDMod
Click the OK button to return to the game's page.
Click Play on the game's page
Click the Settings button and Enable mods
If you can't enable mods, that means REDmod is not installed. Go back and repeat step 2.
Click Play (Do not skip this)
Navigate to Cyberpunk 2077
Click Play
Click the Settings button and Enable mods
If you can't enable mods, that means REDmod is not installed. Check the game's DLCs and make sure to get it.
Click Play (Do not skip this)
Navigate to Cyberpunk 2077
Click Play
Click the Settings button and Enable mods
If you can't enable mods, that means REDmod is not installed. Check the game's DLCs and make sure to get it.
Click Play (Do not skip this)
You now have the following options:
How does load order work in Cyberpunk?
Written & Published: Nov 22, 2023 by
This page will explain to you what Load Order is and how it works, then tell you how to influence it.
You're not supposed to manage load order conflicts outside of .archive
mods and REDmods. If you ever feel the need to do that, a modder fucked up. An exception to this are Tweak mods, as the tweakDB is also a database of static values, conflicts can happen (e.g. two mods both edit the weapon stats of the Masamune).
For REDmods, see
For .archive mods, use Fuzzo's Archive Conflict Checker Tool ().
There currently is no tool to check tweak conflicts
Unless two mods are changing the same file, you don't need to bother about this at all. Unfortunately, the moment you're using frameworks or anything body modding related, you will run into this scenario.
In Cyberpunk, conflicts inside .archive
mods are one per-file basis, whatever mod modifies a file first will win – unlike e.g. Skyrim, where esps may overwrite each other.
There are two mods that change boob size (and both mods modify the same file, e.g. a rig or mesh):
Since i_know_nothing_about_back_problems will load first, the conflicting file inside realistic_boobs_DDDDDDDDD_cup does nothing.
The game loads mods in the following order (higher wins):
All .archive files in Cyberpunk 2077/archive/pc/mod
in alphabetical order (see below).
Note: If a file called modlist.txt
is found inside archive/pc/mod
then the game will load archives according to the order inside that file. The file may contain archive names, one mod archive name in each line. Example:
This means the game will load modb
before moda
, even though the filenames are not in alphabetical order. This allows for conflict management without renaming the physical files.
Anything in Cyberpunk 2077/mods
. All REDmod archives are loaded strictly after all archive files found inside /archive/pc/mod
.
The game reads mods in ASCII-alphabetical order (REDmods by folder name, .archive files by archive file name).
This is ASCII ordering:
Prefixing your archive file names with non-alphanumeric characters works fine in case of Cyberpunk, but is a terrible habit that might break file paths in other games or operating systems.
You will forget the warning above and re-learn this the hard way.
If you are creating a compatibility mod (something that modifies the files of another installed mod), then yours needs to load first.
You mod Cyberpunk 2077 by adding files to your . The game natively supports modding, and the core mods will take care of everything else.
You can install mods by using /, or by hand
Regardless of your past experiences, the Nexus Mod Manager works reliably and well for modding Cyberpunk.
For more detailed information, see .
To learn more about this, check .
This is the reason why game updates break mods — we recommend to and only update your game once it's safe. After each patch, you can find a post on our that is kept up-to-date as the modders update their tools.
To learn more about the individual frameworks, check
Directory | explanation |
---|
REDmod never took off and most people stick to the legacy format. If your /mods
folder is empty, you don't need this. For more information, see below.
For instructions on how to install, see .
For documentation on the Vortex installation toggle, see .
For instructions on how to activate it, see and here for .
You can install mods via mod manager (, ) or . There are upsides and downsides to each — however, for beginners, .
If in doubt, install the non-REDmod ("legacy"
) format. To learn why, check below the table.
REDmod | Vanilla mod (packed correctly) |
---|
If you have problems with Vortex, check the of the guide.
For everything else, this wiki has a dedicated with step-by-step instructions for pretty much every common problem. If that doesn't cut it, you're welcome to find us on in the #mod-troubleshooting channel (but your first answer will be a link to that guide).
This can (but doesn't have to) cause problems in two different spots by "protecting" the Cyberpunk install dir from modding tools such as mod managers (like our recommendation ) or even CDPR's own REDmod launcher. But hey, at least things are very secure.
If you already have the game installed, you can skip this section and proceed with
If you already have the game installed, you can skip this section and proceed with
That's it, you are done with your install of the game! You can now move on to !
That's it, you are done with your install of the game! You can now move on to !
That's it, you are done with your install of the game! You can now move on to !
If you feel insecure about modding, follow the extremely detailed guide under
Otherwise, you can head to and start reading on how to do this
Mod name | Pos | why |
---|
You can re-name your folders and .archive files following the rules under to influence in which order the game will load your mods, or you can use Fuzzo's Archive Conflict Checker Tool ().
For example, if you want to do a custom recolour of the mod , then your Wolvenkit project could be named _00_ArchiveXL_Netrunner_Variants
, or _ArchiveXL_Netrunner_00_Recolour
.
. |
|
|
|
|
|
|
|
| a subfolder of |
|
|
| part of a REDmod, can't be installed standalone |
Game install |
|
Mod download and staging |
|
MyMod.archive | 2 | M comes before m |
myMod.archive | 3 |
!myMod.archive | 1 | ! comes before A |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| a number |
| a number |
|
|
|
|
| a number from 0-4 |
|
| a number |
| a number |
| a number |
| a number | maximum FPS |
|
|
|
|
|
|
|
|
|
| <a number>,<a number> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| triggers REDMod recompilation on start |
|
|
|
|
|
|
|
|
|
|
|
| a string |
|
|
|
|
|
|
|
| a number or |
|
| a number |
|
|
| a number (seconds) Default is 60 | The number of seconds the game can stay frozen before assuming that it has crashed |
|
\ |
\ | Default mod directory: contains .archive mods and .xl files in |
\ |
| Redscript mods (not the same as REDmod) |
| red4ext tweaks |
\ | Mod directory from before 1.3. Use |
is in a folder named after the mod | may be in an extra folder if packed incorrectly |
has an | does not have an |
contains a folder with any of - - | contains any of the folders
- |
Is packed with one level of nesting ( | Has multiple levels of nesting |
Manual install instructions:
Extract the folder |
REDmod is a command line tool developed by CDPR and Yigsoft which can be used to stage installed mods to work with a modded game.
This section is for managing mods with REDmod.
For install instructions, check Using Mods
For creating mods, see the Modding Guides section in the wiki's navigation tree to the left.
REDmod preloads any mods on its list, loading them as if they were a part of the game's regular structure. Preloading requires the game to be started via launcher (or Vortex) and will add a short delay, but the loading times during gameplay will be much faster.
Compatibility: Not all mods can be easily converted. Some outright break in the process.
Especially modders don't like the extra delay during startup
While the mods are precompiled, a console window will be visible. This scares many users.
The only thing that requires REDmod format are custom audio file additions (or use the Audioware mod from Nexus).
You can convert REDmods to the legacy format by putting any files into the correct subfolders. .script
files need to be converted to .reds
, but TweakXL can simply read REDMod tweaks.
The game loads REDmods from this path: <
Cyberpunk 2077
>/mods/<name>
.
EXAMPLE: REDMod:
C:\GoG\
Cyberpunk 2077
\mods\<name>\archives\<name>.archive
Legacy:C:\GoG\
Cyberpunk 2077
\archive\PC\mod\<name>.archive
Legacy archive mods in <Cyberpunk 2077>
/archive/pc/mod
are still supported, but their load order cannot be managed with REDmod.
Legacy mods will load before any REDmods.
Before being able to play a modded game, you need to deploy your installed mods.
Then, you need to activate mods before starting the game.
You can handle deployment and load order with
the REDlauncher that comes with the game
Vortex Mod Manager from NexusMods
REDmod WolvenKit integration and manage your mods easily from within the WolvenKit Mod Manager
starting Cyberpunk with the parameter -modded
Navigate to Cyberpunk 2077
Click Play
Click the Settings button and Enable mods
Click Play (Do not skip this)
A window will open showing progress on mod deployment.
Conflicts are handled on a per-file basis, but can be handled by specifying a specific load order. The rules here are the opposite of e.g. Skyrim: the first mod to change a file wins.
Example:
modA contains a script file
Cyberpunk 2077\mods\modA\scripts\cyberpunk\player\player.script
.
modB contains a script file with the same name:
Cyberpunk 2077\mods\modB\scripts\cyberpunk\player\player.script
This will discard all changes modB made, since by default, REDmod and the game loads mods alphabetically (modA overrides changes in modB).
However, you can specify a load order with REDmod, which the game will respect.
If a REDmod is giving you trouble, you can force a redeploy by either of the following means:
Either
Delete the content of r6/cache/modded
in your Cyberpunk directory
or
Uninstall the mod
Start the game
As soon as it launches, close the game again
Reinstall the mod
Now, restart the game. REDMod will rebuild the cache and hopefully fix your problem.
If that doesn't do it, you can consult the troubleshooting guide for advice.
REDMod's redeploy is triggered on any of these changes:
mods change: You added or removed a mod
A mod's version changes: The version number in the info.json
was changed.
A mod's files change: You added or removed archives
The REDmod deploy
command stages installed mods to work when the game starts with the modded
flag.
Open the WolvenKit Mod Manager.
Click the Deploy Mods button in the toolbar.
You will see all installed mods in your game. Enable the mods you would like to play with.
You can specify a specific load order with the -mod parameter:
This will override changes to \cyberpunk\player\player.script
that modA makes in favor of modB. It will also tell the game to load modB before modA and modC.
Open the WolvenKit Mod Manager.
Adjust the load order by dragging and dropping rows.
Click the Deploy Mods button.
You can adjust the load order by dragging and dropping the installed mods inside the mod manager.
When you click the Deploy Mods button, the current load order will be forwarded to redmod.exe and mods will be deployed and loaded in this order.
To start a modded game that loads mods deployed by REDmod use the -modded
flag on Cyberpunk2077.exe
Example:
This however will skip the initialization process that should be done after any new REDmod mod install.
INFO The executable is located at
<Cyberpunk 2077>\bin\x64\Cyberpunk2077.exe
What is your game directory, where can you find it?
Published: Jan 27 2024 by manavortex Last documented update: Jan 27 2024 by manavortex
This page will tell you
what your Cyberpunk 2077 game directory is, with extra information in the expandable box
how you can find the game folder
how to use Windows Search to delete leftover files from a mod
The game directory is called Cyberpunk 2077
(unless you re-named it). It's the place where Windows put everything that it needs to run the game when you click on the icon — that includes mods.
Unless you changed the default settings, your game is installed here:
You can open a Windows Explorer in the game folder like this:
Press Windows+R
to open the Run
dialogue
type explorer
(don't forget the space)
Copy and paste the game path from the table above into the text box
Press Enter
or click OK
If you don't know your game directory, you can find it in your client:
Right-click on the game in your library, then select Manage
-> Browse local files
With the game selected in your library, click on the More
button, then on Manage Installation
and Show folder…
Right-click on your game in the list and select Manage
. Then, click on the folder icon:
Once the Cyberpunk folder is open in your Windows Explorer, you can use the Windows Search bar
in the upper right corner (Hotkey: Ctrl+F
) to find files by name.
For example, if you have trouble with atelier and have decided to do a clean reinstall, you can search for atelier
:
You're seeing the atelier install folder (good) and a bunch of atelier stores (bad, these are innocent).
You can either double-click on the virtual-atelier-full
folder (first item) to navigate there, or use any of the following options.
If you right-click on a folder or file, you will see a menu entry "open folder/file location". This will open a new Windows Explorer window in the folder containing the item you selected, letting you browse and delete.
Select multiple items from the list by holding the Ctrl
key while you click.
Once you have selected everything that you want to delete, simply press the delete
key, or right-click and select Delete
.
Only update once all frameworks are stable!
Things fall down when you let go of them, and mods break whenever a game updates. That is due to .
Always make sure that your framework mods are up-to-date.
You should generally wait with updating to the latest game version until all mods are up-to-date. If it's too late for that, you can try Cyberpunk, or wait until the frameworks update.
In GOG Galaxy, this can be done as a global setting — you disable auto-update for all of your games — or as a per-game option for some games like Cyberpunk 2077.
Open the GOG Galaxy page for Cyberpunk 2077 and click the manage icon next to the big play button, then Manage installation
and Configure...
Disable the Automatically update to the newest version
checkbox. Optionally, select the game patch you want to play on here.
Open the settings and select the entry Game features
in the sidebar, then uncheck the box for Auto-update games
.
In the EPIC launcher, this is a global setting — you can only disable auto-update for all of your games.
Open the settings menu and scroll down to MANAGE GAMES
, then disable auto-updates.
Unlike the competition, Steam will not give you any control about auto-updating. For that reason, you need to forbid it from writing to a specific file on disk, without which it will be literally unable to update. Here's how:
Find the steamapps
folder (:
Right-click on Cyberpunk 2077 in your Steam Library and select Properties
On the side bar, click on Local Files
Select Browse
. This will take you to Cyberpunk's install directory, which is inside the folder we want (e.g. C:\Steam\steamapps\common\Cyberpunk 2077
)
Navigate two levels up (in windows explorer this is done by clicking the up arrow at the top left of the window, next to the file path, or by using the shortcut Alt + Up Arrow Key)
Find the file appmanifest_1091500.acf
Set the file to read-only:
Right-click on the file and select Properties
At the bottom of the dialogue, check the Read-only box
As long as Steam can't write to this file, it can't update Cyberpunk. Once you are ready to update, simply uncheck the Read-only checkbox again.
Don't forget to deactivate it again later!
Head to the Cyberpunk game detail page
Find the settings button next to the Play button
Select Manage Installation
-> Configure…
Select the game version
Sorry, choomba, you're fucked. No downgrading possible.
Since 2.0, Steam supports downgrading to version 1.63_hotfix.1
.
Right-click on the game in Steam and select Properties, then go here:
For downgrading to other versions, see the expandable box below.
This page explains the features added in the different game versions.
Load mod load order from a text file. by Auska
RedMod deploys a list of mods in order - passed through the command line.
This change now makes it you don’t have to pass the names in the command line but read it from file.
We can specify load order of archives in another load order file.
Fix mesh Export paths and allow exporting to non-base resource paths. by Mana Vortex
The fbx importer would throw an error if in the resource path there wouldn't be base
--- Example:
❌/environment/decoration/industrial/pipes/entropy_pipe_01/entropy_pipe_01_module_small_l020_a.mesh
✅base/environment/decoration/industrial/pipes/entropy_pipe_01/entropy_pipe_01_module_small_l020_a.mesh
How to get mods working on SteamDeck or other Linux distros
This page tells you how to set the launch options for Steam under Linux.
If you have trouble after an update and have exhausted , double-check your (sometimes, Steam helpfully changes them to make you crash)
If you want to optimize Cyberpunk 2077 settings for your SteamDeck, find a guide on
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.
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
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.
To configure the necessary parameters, you can use the app Protontricks, which you can download through the built-in app browser "Discover":
Open Protontricks (you can search for this by selecting start menu)
When Protontrick opens, select Cyberpunk:
Choose "Select the default wineprefix":
Add an override: Check both of the checkboxes below
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.
Open Lutris
Right click on the game > Settings
> Runner options
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
Scroll down to DLL overrides, click on Add to add a key. Add the following keys:
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.
Switch to steam and make sure that the launch options are set as below:
The command is case sensitive. Copy-paste the text from the box above to make sure.
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:
The command is case sensitive. Copy-paste the text from the box above to make sure.
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
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
**
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.
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.
https://www.cyberpunk.net/en/modding-support
Last documented edit: Sep 08 2024 by
This page will tell you the following things:
If you just want to turn it on, check .
If you're looking for the log, go to your and find it under
tools\redmod\bin\REDmodLog.txt
If you are a mod developer, check
I just want to know which to use!
Unless the mod author says otherwise, do not use REDmod.
TL;DR: You trade a longer initial startup for shorter loading screens.
But REDmods come second in . The easiest way to avoid these altogether is not using REDmod, which is why it never took off.
REDmod is a modding framework with a set of command line tools to precompile mods before launch.
If you don't speak Netrunner: During game launch, the modded content will be added to the game's regular file. Your in-game loading screens will be much faster.
Unless the Nexus page explicitly tells you that it's REDmod only (or you are making a mod), assume that you don't.
REDmod is shipped as free DLC with the game. You need to add it inside the platform store (GOG, Steam, Epic). You can click the link below, or find more detailed instructions further down on the page.
If you're accessing Cyberpunk through Steam Family Sharing, you'll be unable to install REDMod (thanks, Steam!). In this case, you can ask the person who's family sharing with you for their Tools
folder.
When REDmod is installed correctly you will find a new folder tools/redmod
inside your game root directory, with subfolders: bin
, scripts
, tweaks
.
Installing and setting up Vortex Mod Manager, the recommended way to install, manage, and upgrade mods.
Vortex is a multi-game mod manager developed for and by , the website where most are hosted. Here you can download mods manually or with Vortex and keep track your download history.
To use Vortex, you need an account there. If you don't have one, you can sign up – don't worry, it's free.
Technically speaking, you don't. You can or use (but without our support, sorry, choom). However, Vortex for Cyberpunk is the most beginner-friendly way of managing your mods and will save you a lot of hassle.
If you have PTSD from modding Skyrim or Fallout with Vortex, be assured that Vortex for Cyberpunk is integrated extremely well. Go ahead, give it a try!
If you run into issues with Vortex that aren't addressed in this guide, you can contact or join our and find (volunteer) help in the #vortex-support channel.
Your staging folder must be on the same drive as your game installation
Your staging folder must not be your game install directory
Vortex has . If you put wrong options, mods can go brr.
Once you are signed in on Nexus, it's time to download Vortex Mod Manager.
If you can download it on your own, you can skip to the or section of this guide.
Select the "Manual Download" option on the first entry:
You'll now see a download page. If you don't have Nexus Premium,
Select "Slow Download"
Wait through the five seconds cooldown
Optional, depending on your browser: Select your download location for files that you don't want to keep
Wait until the installer is downloaded
Run the installer: either
select the file from your download history (Ctrl+J for most browsers)
go to your download directory and double-clicking the file
Proceed with the steps in the next section
This guide will assume that you install Vortex to C:\Program Files\Black Tree Gaming Ltd\Vortex
. If you install it somewhere else, please adjust accordingly.
Run the installer by double-clicking it.
If Windows shows you a prompt now, select yes — you want the setup to make changes on your device, it's supposed to install Vortex.
Click through the setup and finish its instructions!
Congrats! You've finished installation! Vortex should launch automatically and you can now move onto setup.
Here is where we get into the weeds, the particulars of Vortex setup before we can use it.
If Vortex didn't open by itself, open it from the start menu.
Log into Nexusmods by clicking on the red circle in the top right of your client
You will see either a browser window or an error message that Vortex couldn't open one – in this case, copy the URL in the box at the bottom and open the browser window yourself
Optional: log into nexusmods (if you aren’t)
Allow Vortex to access your Nexus account by clicking "Authorize":
Click "Log in to Vortex":
Instead of the red icon, you should now see your profile picture and username from nexusmods.
This section will tell you how to add Cyberpunk to Vortex's managed games.
On the sidebar on the left side of your dashboard, click "Games"
In the page that now shows, type "Cyberpunk" into the search bar
Hover over its thumbnail and click "manage"
You will now see a popup complaining about "Game support not installed". Don't panic, this is expected!
Click the "download" button at the bottom of the window to install the Vortex plugin for Cyberpunk:
The extension should download automatically
You need to restart Vortex – agree to the prompt.
Vortex will tell you that it couldn't detect your game install and prompt you to set it manually. Click "Continue".
In the explorer window that now pops up, navigate to the folder containing your Cyberpunk exe (e.g. C:\Games\Cyberpunk 2077\bin\x64
)
Once you are in the right folder, click "Select Folder"
This section tells you how to set the recommended settings in Vortex, grouped by tab. If a tab isn't covered, there are no recommendations and you can do what you like.
Start by clicking "Settings" in the left sidebar of your Vortex Dashboard, then select the first tab.
This section controls how Vortex looks and behaves. If this is your first time using Vortex, just leave it at the defaults and scroll down to "Automation
".
The settings here tell Vortex what to do with your mods as it gets them.
Here's a screenshot of the recommended settings with an explanation below:
Downloading: Putting the mod into Vortex's download cache, either by clicking the button on Nexus or by dragging-and-dropping an archive onto the client. The archive will now live in Vortex's download directory.
Installing: Unpacks the mod and copies it to Vortex's staging directory.
Enabling: This mod should be included in the next deploy
Deploying: The mod has been copied from Vortex's staging directory to your Cyberpunk game directory.
In theory, you can configure Vortex so that you hit the download button on the website and it will download, install, enable and deploy for you. The downside with that is that you might not notice errors as they pop up in the background, which is why we recommend doing that one single click by yourself.
This section controls Vortex file storage. It's mostly a matter of personal preference and disk space availability on your end.
This folder
must be on the same drive as your game installation, or deploy will fail
Where Vortex keeps its mods, ready to deploy them into the Cyberpunk game directory.
The default folder location is {USERDATA}\{GAME}\mods
, which resolves to C:\Users\YourUsername\AppData\Roaming\Vortex\cyberpunk2077\mods
You can keep it as this, or you can make a folder for it in a place you can easily access it, like C:\Games\Mods
. Wherever you decide, you want to make sure it is accessible and you can remember it in case of issue.
Where Vortex stores downloaded archives. Can be wherever you like, even on a different drive.
We recommend keeping an extra folder in there for manually downloaded mods, as Vortex can manage these as well – you just have to drag-and-drop them into the client.
Finally, we will return to our dashboard.
No matter what settings you chose in interface, you should still have a section labeled "Tools", where at this point you should at least see four things, the last of which will be disabled:
It can be helpful here to toggle "Enable Toolbar" above it so that you can always see them wherever you are in Vortex.
These are different options to launch the game via Vortex.
Click on the three dots next to "Launch Game with REDmods Enabled" and set it as primary. This will make Vortex pick this option when you click on the Cyberpunk 2077 picture on the far left.
"REDmod Deploy Latest Load Order" is also incredibly useful if your mods are acting up: Just using the "deploy" button on the main management page can fail – by using this button, you can debug your REDmod deployment.
This section will teach you how to install mods. Keep reading!
The following mods are requirements for many other Cyberpunk mods. We recommend that you install their latest version and keep them up-to-date, since you will run into them sooner or later.
Check if you have an up-to-date version of the core mods. Outdated collections can include earlier versions. If you update them, there's a good chance that everything will work.
Before you play your game, check the bell in the top right corner next to your profile picture. Click it to expand the notifications. What you want to see is all green or blue--any red or orange issues will need to be resolved before starting your game.
While you have it open, you can navigate to the "Settings" option, and select "Skip Start Menu" and "Suppress Intro Movies" (if you don't want them). The setting will become active after the next restart.
Make sure to click save to keep your choices.
Let's get a mod that'll change something. For this example, we've picked KS UV framework, which will change V's feet.
Usually, you want to start at the description page to see the exact file that you need to download. For a detailed guide on the parts of a mod page and how to navigate Nexus, see our Downloading Mods section.
Once your timer counts down, it should begin downloading in Vortex. The setting "Bring Vortex to foreground when starting downloads in browser" is enabled by default, so if you didn't change it, the Vortex window should pop up now. Otherwise, click over to it, and you should be able to see a 1 next to Downloads in the sidebar.
Assuming you're using recommended settings, the mod won't have installed itself, so you will click on "Mods" in the left sidebar. You should already have mods installed, enabled, and downloaded from the collection. Scroll down until you locate the blue "Never Installed" button next to the mod you want to install. Click it once, and if you're using recommended settings, it should enable and deploy automatically.
For this mod, a window will pop up, warning you that it may need manual adjustment, due to multiple .archive files. These are important windows to pay attention to, because many mods that have multiple files do require manual adjustment. This information is usually found on the description page, which is why you want to read it carefully before download.
For this mod, however, that is ok, and intended. You may simply click "Understood".
To test your new body framework mod, simply select "New Game" and pick a female-bodied V. If the feet are flat, it is not installed correctly. If they look a little funny, like barbie feet, you've done it right.
Let's install a mod without a mod manager download button and manage it in Vortex to show you how it works.
Mod authors sometimes disable mod manager integration for a variety of reasons. Usually, Vortex can handle these files just fine – if not, it will complain about it, and loudly so.
Select whichever one you like, like the "Arey", third option down.
Optional: Check what it looks like
Click on the "images" tab (to the right of "files")
Find the picture named "Arey"
Navigate back to the "Files" tab
Scroll down to the third option, Arey Hair PHYSICS ENABLED
The file doesn't have any particular instruction.
Optional: view the file contents – they sometimes contain helpful information:
Manually download the file – you know the drill by now.
Return to the Vortex "mods" page. You have two ways to install the mod now:
Drag-and-drop the downloaded file on your client, or
use "Install From File" in the orange bar and select the file you just downloaded in the explorer window that pops up
You should now have successfully installed the file.
If you have used the recommended settings, it should enable and deploy automatically. Otherwise, you need to do that yourself.
Start the game
Head to the character creator and create a female-bodied V
Check hair 48 – normally, it looks like this:
If your hair is two big buns--you did it! If it's just the normal single bun with braids, go back and try again.
Congratulations! You know how to use Vortex!
deploy
- Deploys mods to the game by compiling them together
The deploy
command stages installed mods to work when the game starts with the modded
flag.
archives from <Cyberpunk 2077>/mods/<name>
are staged to load
scripts in <Cyberpunk 2077>/mods/<name>/scripts
are compiled into a modded script blob
tweak files in <Cyberpunk 2077>/mods/<name>/tweaks
are compiled into a modded tweakDB blob
sound files in <Cyberpunk 2077>/mods/<name>/customSounds
are staged to load
You can specify a specific load order with the -mod parameter
-root=<path>
the game root folder for which the deploy command is run.
INFO - this needs to be
<Cyberpunk 2077>
-mod=<modA dirname> [<modB dirname> ...]
stage only the mods in the given directory names (without the leading mods\),
in left to right load order precedence. You must escape any spaces by enclosing the argument in double quotes (for example Mod With Space
should be given as -mod="Mod With Space"
.)
-modlist=<filename>
-?|-h|--help
Prints out a description of how to use the command.
redmod deploy -root="C:\Gog\Cyberpunk 2077"
Stages all installed mods under C:\Gog\Cyberpunk 2077\mods
for loading
redmod deploy -root="C:\Gog\Cyberpunk 2077" -mod=modB modA modC
Stages only the three mods C:\Gog\Cyberpunk 2077\mods\modA\
, C:\Gog\Cyberpunk 2077\mods\modB\
and C:\Gog\Cyberpunk 2077\mods\modC\
for loading. In this case, modB
will override both modA
and mod
C, and modA
will override modC
(in case any of them modify the same asset paths.)
redmod deploy -root="C:\Gog\Cyberpunk 2077" -modlist="loadorder.txt"
Same as above, but will load the mods from the file loadorder.txt instead.
directory: contains .archive mods (in subfolders). Contains only a .stub file if empty.
Plugins like and RadioExt
Manual install instructions:
The folders archive
, bin
, r6
from the download must merge with the same folders in your (do not put the bin in the bin).
Longer instructions can be found , but the condensed version (courtesy of our lovely Discord community) goes as follows: First now so that you don't forget to do it later. We'll wait. Here are the version-specific commands that you need to run. If you can't find your version on the list, check (Base Game) and (Phantom Liberty), and find the new Manifest ID tag.
You might still need to do a script cache reset or other cleanup before the game starts up nice, so head on over to if need be.
If you don't want to read text, find a video documenting the process . Thanks to Connor for providing the screenshots and transcription!
Taken from
For a full list of launch options, check . Use them at own risk!
If this still doesn't work, check the for additional instructions, or find us on in #mod-troubleshooting
.
You can check protontricks' . If there is anything seriously broken, you will find something there.
You can find us on the in #cet-troubleshooting
or #red4ext-support
. Beware: If it turns out to be a typo in your launch options, there will be snark. ;)
As of September 2024, the only thing we can't do without REDmod is adding new sounds (replacing existing sounds is fine). The mod attempts to mitigate that.
Click , it will take you directly to the download page
If you can setup Vortex on your own, skip to the section of this guide. (Why are you reading this?)
If you are already logged in, proceed to the next section ""
Optional: If Vortex was able to auto-detect your game install, you are done now and can proceed with the section.
Vortex can now manage your game! Proceed to the next section, .
To put a mod in the game, Vortex requires you to complete four steps. The folders for these are configured in the .
This setting controls the automatic REDmod conversion. In general, you do not want this. For an explanation of what that means, see
must not be your
You can browse different mod collections but caution: collections can be outdated or abandoned. To make sure that a collection works with the current game version, check its comments - if they are full of complaining people, it doesn't.
Some mods that depend on redscript may say they require , but it's unnecessary to install since RED4ext performs the same functionality and then more. It only still exists for users who wish to use redscript and REDmod mods at the same time, but not use RED4ext.
For more information on the core mods, check
The game should always be able to launch with just the core mods enabled. If it doesn't, head over to the and make sure that you can launch and start a new game.
Since this is your first time launching the game with mods, you should see a prompt to bind an overlay key for Cyber Engine Tweaks (CET). (If it does not, check .) You can assign whatever you like, this button will hide or unhide the CET overlay.
For now, you can simply go straight to the page of the KSUV mod.
So that you can see the changes in-game immediately, to know if you've installed correctly, you will download the first option, "Recommended. UV Framework New High Heel Feet with Custom Textures - Classic Install". This will change the feet visually now, and allow for custom textures later. Click "mod manager download". A window will pop up telling you that you need another mod "" installed before downloading this. You can do this after downloading this mod; your feet just won't fit in any vanilla shoes until you do. For now, click download to continue to the final download page, where you will select "slow".
Click , which will take you straight to the files tab.
Scripts: Compiled into a script blob
<Cyberpunk 2077>/mods//scripts
Tweaks: Compiled into a modded tweakDB
<Cyberpunk 2077>/mods//tweaks
Sound files
<Cyberpunk 2077>/mods//customSounds
Deploy mods when Enabled | Automatically deploys each mod as you enable it, merging step 3 and 4. We recommend enabling this, as it saves you a click. |
Install Mods when downloaded | Automatically completes step 2 when you download a mod. We recommend disabling this as it lets you address issues and popup one after the other |
Enable Mods when installed | Automatically completes step 2 when you install a mod. We recommend enabling this, as it saves you a click. |
Run Vortex when my computer starts | Starts Vortex with Windows - disable or enable at your discretion |
Steam
C:\Program Files (x86)\Steam\steamapps\common\Cyberpunk 2077
GOG
C:\Program Files (x86)\GOG Galaxy\Games\Cyberpunk 2077
Epic
C:\Program Files\Epic Games\Cyberpunk 2077