Using Mods

Modding your game, for mod users

Troubleshooting

Summary

Published: Jun 15, 2023 by mana vortex Last documented update: January 18, 2026 by minnierylands

This page will give you a brief introduction of how mods work and how to install them.

Wait, this is not what I want!

I need help installing Cyberpunk!

I need to troubleshoot my mods!

I want to create mods!

Installing Mods

We strongly recommend using a mod manager. Manual modding is only recommended for advanced users.

You mod Cyberpunk 2077 by adding files to your game directory. The game doesn't need any complicated workarounds to mod, and the core mods will do all the heavy lifting.

You can install mods via mod manager or manually. There are upsides and downsides to each — however, for beginners, we recommend using Vortex.

Overall, your mods will not work unless you

Put all the files exactly into the correct place
Make sure to install all requirements _(and_their_{requirements, too)}
Have REDmod enabled ₍_REDmod _exclusive)

If you're on Linux/Steam Deck, you need to follow this guide to the letter

Mod Manager Options

Below you can find links to guides for all three supported mod managers for Cyberpunk 2077.

If you had terrible experiences with Vortex for other games, be assured: Cyberpunk integration is working extremely well. Maybe give it another chance?

Vortex

Recommended for most mod users. Easy to use.

Mod Organizer 2

Recommended for anyone already used to MO2. More complicated to use.

Manual Install

"Manual install" is a glorified term for "extracting the downloaded archive into your game directory".

You have to make sure that the right files end up in the correct folders. This method is very error prone, which is why we recommend using a mod manager.

You can check the file structure by opening the downloaded file, or by using this feature on Nexus:

The file structure is different for REDmods and non-REDmods (often referred to as "legacy" mods). Mod authors usually tell you which type their mod is. To lean what the difference is, read here.

What Are Requirements?

A requirement (sometimes called "dependencies"), are mods that other mods rely on.

This means the mod you want to download will not work if you don't download the listed requirements first.

For more detailed information, see Users: Troubleshooting Requirements.

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.

The Core Mods

To learn more about this, check Core Mods explained.

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.

This is the reason why game updates break mods — although you can turn off auto-update and only update your game once mods have updated.

After each patch, you can find a post on our Discord that is kept up-to-date as the modders update their tools.

Be aware that once all the core mods have updated, you will not recieve support until you have updated your game and all your core mods.

Overview of Mod Folders

TL;DR: you can ignore this unless you want to understand how things work, or want to install mods manually.

This is supposed to give you an overview of which files go where. It is not a bucket list of things you have to install.

REDmod

Generally, you'll be told to avoid REDmod when possible. But why?

Compatibility issues REDmod was CDPR's attempt to standardize mod loading, but there were various compatibility issues with it, and it never quite took off. Most mod authors stick to "legacy" versions of mods.

Load order REDmods are loaded after everything else, so that format is simply not an option for mods that rely on being loaded at a certain point, like body mods.

Vortex autoconvert In theory, Vortex can automatically convert legacy mods to REDmod. In practice, that didn't help with any of the compatibility issues mentioned before, and even caused some of them.

If you'd still like to know the difference, or there's a mod that only offers REDmod format and you cannot live without it, read on.

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.

If your /mods folder is empty, you don't need this. For more information, see What's the difference? below.

By contrast, vanilla mods (from /archive/pc/mod) will be loaded individually and might add to your load times.

For instructions on how to install, see here.
For documentation on the Vortex installation toggle, see here.
For instructions on how to activate it, see here for GOG and here for Steam and Epic.

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.

For a guide on the correct folder structure, click here.

Mod format: REDmod or Legacy?

If in doubt, install the non-REDmod ("legacy") format. To learn why, read below.

What's the difference?

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.

REDmod when using Vortex

As of 2026, the Vortex "autoconvert" option will break your mods.

In the 0.12.0 version of the Cyberpunk 2077 Vortex Extension, a bug was introduced that would enable this toggle without warning.

Thankfully, version 0.12.1 of the extension has squashed that bug, but Vortex will not automatically acknowledge the new version. You can get version 0.12.1 here.

How can I check my extension version?

In Vortex, there's an "Extensions" tab on the left hand side. Click it.

Check what it says under "Version" for the "Cyberpunk2077" extension.

If it says 0.12.1, you're good to go!

If not, you'll need to click "Remove" on the extension.

Click "Manual Download" on the top file from the extension's download page.

Go back to your Vortex "Extensions" page

Drop the zip you just downloaded into the box that says "Drop File(s)"

You need to go back into your "V2077" settings and turn the toggle off!

Go to your "Mods" page in Vortex, press CTRL + A on your keyboard (you may need to click on one of your enabled mods first)

A bar should pop up at the bottom. Click "Reinstall". It shouldn't take too long!

You should now be free of the autoconvert bug.

Vortex will let you define load order for REDmods. To support compatibility, it offers you automatic conversion.

Here is how you can tell the two apart:

REDmod

Legacy mod (packed correctly)

is in a folder named after the mod

may be in an extra folder if packed incorrectly

has an info.json

does not have an info.json

contains a folder with any of

- archives

- tweaks

contains any of the folders - archive - bin - r6 with files nested under them

Is packed with one level of nesting (info.json is in top level folder)

Has multiple levels of nesting

Manual install instructions: Extract the folder ModName into Cyberpunk 2077/mods

Manual install instructions: The folders archive, bin, r6 from the download must merge with the same folders in your game directory (do not put the bin in the bin).

Fixing broken mod file paths

TL;DR:

Mod makers sometimes pack files incorrectly, causing mods to end up in the wrong places, which makes them not work

To fix it, you need to correctly path the contents of the zip file:

.archive and .xl files go to archive/pc/mod folder structure.
- For other files see Mod folders by file extension.

For detailed instructions on how to create the new zip, see below.

You can drop the fixed zip you made into your mod manager to have it install properly.

Sometimes, mod makers create strange paths for their mods. Sometimes, they delete the paths altogether (even when Wolvenkit creates those paths for them). This can cause issues, especially when installing mods with a mod manager as the manager doesn't know where this mod is supposed to go.

Don't know which method you need to follow?

I'm manually installing mods!

I'm installing mods through Vortex!

I'm installing mods through MO2!

Always check the file contents before downloading a mod!

If the mod you've downloaded looks like the picture on the left. Great! You don't need to do anything. Enjoy your game! If not, keep reading... we've got work to do!

You'll usually see a few types of mismatches of pathing:

To find out how to install the mod properly, you have to read the mod's install instructions. If that isn't clear enough, the following might help you.

All of these can cause a mod manager to get mixed up, or for you to manually install it wrong, so let's go through fixing these!

You can do these fixes in the file explorer or through Vortex/MO2 if you're using them.

If you get stuck at all along the way, come ask us in #mod-troubleshooting on the discord. We wrote these guides, so we can help, I promise!

Manually Fixing Folder Paths

Extract the .zip/.rar/.7z to your Downloads folder (or whichever folder you're working in).

You might get an extra unnecessary folder depending on where you extracted the folder to. If you want it to extract straight into the Downloads folder, remove the extra folder at the end of the path so it looks something like this:

In the case of Scenario 3 (pictured above), you can just move the folders out of the first unnecessary folder and continue from step 8 or 9.

You should now have the mod files inside your Downloads folder. Locate the files you want to move and check their file extensions.

If you don't have file extensions turned on, you can check this part of the file to know what file it is:

We need to create the correct file path. This is an .archive file, so it needs to go into archive/pc/mod

If you aren't sure where your file should go, check out Mod folders by file extension.

Create a folder by right clicking. Name it archive

Double click the archive folder to open it.

Right click to create a new folder. Name it pc

Double click the pc folder to open it.

Right click to create a new folder. Name it mod

For our .archive you should have a folder path like this now:

Repeat this process for the correct folder paths for other file types if you have any.

Go back to the Downloads folder (or any subfolder that holds the files we need to move)

Select the files you want to move, then press CTRL + X (this cuts the files)

Navigate back to the mod folder we created in step 8, then press CTRL + V (this pastes the files)

Your file and folder structure should now look like this:

If you're using a mod manager, skip this step and continue from the next one!

If you're manually installing, you can now copy paste the archive folder into the Cyberpunk 2077 folder of your game installation. It will automatically merge with the existing folders.

If you're using a mod manager, right click the archive folder and turn it into a .zip/.rar/.7z. If you're just using Windows' own zipping system, the option might be hidden under Send to -> Compressed (zipped) folder.

You can name the newly created .zip to whatever you want, but it is recommended you name it something identifying, like the original mod name, so you can easily find the mod on Nexus. &#xNAN;Adding the mod to your mod manager this way means it won't be able to locate the mod on Nexus by itself, so naming it the same makes it easier for you in the future.

You can now add it to your mod manager!

For Vortex, drag the .zip to the bottom of the downloads page and drop it there.

Fixing Folder Paths in Vortex

Press "Mod Manager Download" as you normally would.

Navigate to "Never Installed" in Vortex (on the "Mods" tab). You should see the mod you just downloaded here.

Click "Install"

You should get a popup that says "You have reached the fallback installer!". Click "Yes, Install to staging anyway".

Right click on the mod name

You should then get another pop-up that says "Mod installed but may need manual adjustment!". Click "Understood!"

You should read this pop-up! It explains where the files are expected to go and why!

The mod should now be under "Disabled." Right click the mod name again to bring up the menu.

Click "Open in File Manager".

To make life easier, we'll set up our folder structure the first folder it takes us to. Right click to create a new folder. Name it archive

Double click the archive folder to open it

Right click to create a new folder. Name it pc

Double click the pc folder to open it.

Right click to create a new folder. Name it mod

You should now have a structure that looks like this in the top bar:

Click back through the folders until we find the exact files you want.

In this example, I want to use the "COOL VERSION", so I would click through the folders until I find the "COOL VERSION" files.

Select the files you need and cut them!

Go to the mod folder we made in step 13 and paste the files (CTRL + V)

Repeat this process for any other folders that contains files you need to make sure your mod works.

Don't worry, there's a table on this page ₍_here!₎ which shows the paths you need to create for each file type!

Now to deal with the folders that you did not make. Select them and press delete!

Go back into Vortex and enable that mod!

Now you can get back to your regularly scheduled mod downloading session. Hooray!

Fixing Folder Paths in MO2

It's recommend to set up your MO2 Installer to default to the manual installer instead of using the Simple Installer plugin. MO2 already checks for a correct path and will warn you if the mod you are trying to install deviates from the expected structure, but removing the Simple Installer plugin helpful for both new users as well as MO2 veterans regardless. It might seem like overkill, but it's a valuable tool to make sure the user checks for a working file structure - so the mod ends up where it's supposed to be!

If you are unsure where files should go, refer back to the "Overview of mod folders" section of this page.

Setting up your MO2 installer

Open your MO2 settings and click the plugins tab.

In the left pane scroll down to the Installer section. Make sure Simple Installer is disabled.

Now you can go to Nexus and download mods using the Download with Manager button as per usual! Often times mod authors set a correct file structure, but due to how packaging works they end up with an additional folder that MO2 doesn't know how to handle. In these instances, you have to manually change the Cyberpunk 2077 directory in the installer. This is explained in Example #1 (below). To see how to create new folders from scratch, for mods that have no folder structure or are only partially correct, see Example #2 (further down).

If you make a mistake you can cancel out of the installation process during any given step and start again! Even if you somehow falsely install something you can right click your mod in MO2 and select the "reinstall" option to restart the manual adjustment.

Example #1: Adjusting the Cyberpunk 2077 directory

MO2 is unhappy because it doesn't recognize a correct file path, due to an additional folder inside the mod.

This is easily fixed by making MO2 recognise the additional folder as the Cyberpunk 2077 directory itself. Right click the folder and select "Set as <cyberpunk 2077> directory"

Now we are left with the .archive file going into Cyberpunk 2077/archive/pc/mod/ MO2 gives us the green light for the installation. You can finalise the process by clicking OK

You should now be good to go! If MO2 isn't giving you the green light, or the folder structure looks different to this, check the below example for how to fix!

Example #2: Creating your own folders

MO2 doesn't recognize the file path due to the .archive having the incorrect folder structure.

All .archive files should be inside archive/pc/mod/. For more info on where each file type should go, you can check here.

Right click the Cyberpunk 2077 directory. Select "Create directory".

Name the new folder "archive" Press OK

You should now see something that looks like this:

Right click the archive directory. Select "Create directory"

Name the new folder "pc" Press OK

Right click the pc directory. Select "Create directory"

Name the new folder "mod" Press OK

Your screen should now look like this:

Drag the .archive file into the mod folder.

MO2 should then give you the green light for installation.

You can finalise the process by clicking OK to install your mod!

For bigger and more complicated mods - like those that come with multiple .archive files to choose between - you can use the checkmarks to enable/disable files and folders.

You can also drag multiple files to the correct location. Create your own structure (pictured above) and drag the files you need into the correct places while disabling unnecessary files.

MO2 will ignore and ultimately not install them.

You can now enable your mods like any other. Happy gaming!

Troubleshooting

If you have problems with Vortex, check the corresponding section of the guide.

For everything else, this wiki has a dedicated troubleshooting page with step-by-step instructions for pretty much every common problem. If that doesn't cut it, you're welcome to find us on Discord in the #mod-troubleshooting channel (but your first answer will be a link to that guide).

PreviousGlossary

NextThe Cyberpunk 2077 Game Directory

Last updated 8 months ago