Troubleshooting
If your mods are causing trouble, here's what you can do
Summary
Last documented update: January 20th, 2026 by minnierylands
This page contains troubleshooting information for people who are using mods. You will find step-by-step guides, grouped by different problems.
To save you from scrolling through the entire page, check the list on the right side of the page to find the section you need!
Interactive Guide
Use the interactive guide below to quickly figure out your problems. Can't guarantee that it'll give an immediate fix, but it'll point you in the right direction!
Troubleshooting - First Steps
Update All Your Mods
Mods receive updates regularly. The easiest way to keep on top of potential errors is keeping them all updated. Even if you're sure you have the latest version, re-download them.
The most important ones are the core mods. Not sure what they are? Here's a list:
Update Your Game
Core mod makers update their mods to work with the latest game version, and do not offer support for the old versions.
Don't Use Collections
Collections require constant upkeep, and most collection makers just don't do that.
You can use collections as a reference list, though. Just download the mods you want individually; that way you definitely have the latest versions of them all.
Read Mod Descriptions
Most mods will tell you exactly what a mod does, how to use it, how to install, uninstall, and use them. A lot of them will even tell you exactly which other mods you can or cannot use at the same time.
90% of the time, you can save yourself some time (and potentially some embarrassing Nexus comments) by just reading the mod descriptions.
Download Mod Requirements
Most mods will rely on other mods to work. If you're unsure why a mod isn't working, check that you have the mods it requires first.

To learn more about requirements, have a look at this page.
Remove Cybercmd
If you're using any REDmods, you've probably been told to download cybercmd. Likelihood is, you've also downloaded RED4ext.
These two cannot be used together, and cybercmd should be removed.
Ever since RED4ext version 1.13 (which was uploaded in May 2023!), you do not need cybercmd, as the functionality was added to RED4ext.
Disable All Your Mods
Tried all of the above and still run into issues? Disabling all mods and launching your game can establish if the issue is caused by mods. If the issue still persists without any mods enabled, it's an issue with your game.
If your game crashes on startup, disable all your mods.
If you're dealing with a glitch or bug, and you're pretty sure it's caused by mods, disable everything apart from core mods.
You Pirated The Game
There's a >95% chance we already found the source of your problems — pirated copies just don't mod well.
CDPR needs to earn money to pay people to make games. If you can afford it, please buy the game.
You're welcome to read through the troubleshooting guide - it might even help you. But know that pirated copies will never be explicitly supported.
Specific Troubleshooting Tips
I'm On Linux/Steam Deck
Double check you've followed this guide to the letter before proceeding with any other troubleshooting.
I'm playing the game on macOS
If you're playing on macOS native, you need to check this guide first.
If you're playing on macOS but are playing the Windows version, you need to follow the Linux guide to the letter.
I'm Using Vortex
You need to make sure the "
Automatically convert legacy-style ".archive" mods to REDmods on install (NOT recommended)" toggle is off. This is underV2077inSettings. If it was enabled, check here for what to do.
I'm Using MO2
You need to make sure you always run the game through MO2.
You also need to make sure you have Cyber Engine Tweaks and RED4ext manually installed, or follow this guide to properly set up the script extender plugin.
Whoa! Cyberpunk 2077 Has Flatlined.

This popup looks useful, but it's not great for figuring out what caused your game to crash.
That doesn't mean we can't get anything out of it. You can click "What does this report contain?", which will bring you to a folder.
This is where the game's crash logs live. Open the stacktrace.txt in this folder. It might seem like nonsense, but it can sometimes be a good starting point.
EXCEPTION_ACCESS_VIOLATION
(This may also say 'The thread attempted to read inaccessible data at 0x000000')
Detected integer overflow
Gpu Crash
Make sure your PC meets the minimum specs to run Cyberpunk 2077 (yes, really).
Try disabling any graphics mods you have, as well as external programs such as ReShade.
If the game opens but cannot load a save, try lowering graphics settings in the main menu.
If you still get this crash, disable all your mods.
If this fixes the issue, try again with just core mods enabled.
If it's still launching fine, re-enable your mods in batches until the game cries.
If it still crashes in an unmodded state, you may need to update your graphics drivers. You can find more information on that here.
Watchdog Timeout!
If you still get the error, keep reading:
If the game doesn't even launch, check your antivirus. Make sure that you have an exception for the Cyberpunk 2077 game directory (guide on rackspace)
If it happens in photomode, turn down your graphics settings, or try disabling your photo mode mods.
If the error is absolutely persistent and you're sure you've tried everything, you can try increasing the Watchdog Timeout.
The Game Doesn't Launch

... And You Get a Pop-up
ValidateScripts.cpp:44 / codeware.global.reds

To fix this:
Navigate to
Cyberpunk 2077\r6\and delete the entirecachefolder (Yes, the whole folder)Verify your game in the store you bought it from (GOG/Steam/Epic)
To be extra safe, reinstall redscript
RED4ext Error 1114 - A dynamic link library (DLL) initialization routine failed

To fix this, you need to download Visual C++ Redistributable 2022 (direct download, Microsoft)
Download and run the executable file linked above, then restart your computer.
If you already have it downloaded, or it doesn't work the first time, you need to open the file again, click Repair, then restart your computer.
Redscript Compilation Error

Redscript is quite good at telling you where to look for issues, but the mods it lists may not actually be the problem. Confused? Don't worry! We're going to get through this together.

Redscript Log
The pop-up mentions consulting the logs for more information. It can be helpful to double check if you have duplicate files, making sure you have script files for specific mods, or just for reference.
Clearing the Redscript Cache
Sometimes, the cache goes stale. Thankfully, it's an easy fix. If you're really at a loss for your redscript compilation error, try this first.

Navigate to
Cyberpunk 2077\r6\and delete the entirecachefolder (Yes, the whole folder)Verify your game in the store you bought it from (GOG/Steam/Epic)
Still Getting Compilation Errors?
One of your redscript-dependent mods might be causing issues. This could mean you're using two mods that are not compatible with each other, or you're using an old mod that needs an update.
But how do you figure out which one it is?
It Still Doesn't Compile
Launch the game with only the core mods.
If the game launches, the issue definitely lies with one of your other mods. You need to bisect your mods.
Still. Doesn't. Compile.
It might be time to start afresh. Try running Mod Remover and start re-modding your game from scratch. If you're using a mod manager, disable/purge your mods there first before running the Mod Remover.
Failed to resolve address for hash

0x may be different, but the advice below applies to them allTo fix this:
Update/Buy the game
Update your core mods - you can find links to all of them here
If you are a mod dev, update RedHotTools
Corrupted Or Missing Archives

If you get an error message that says Cyberpunk 2077 encountered an error caused by corrupted or missing archives and and will now be forced to close, you have a broken .archive file and need to bisect your mods.
Corrupted Or Missing Scripts

If you get an error message that says Cyberpunk 2077 encountered an error caused by a corrupted or missing scripts file and and will now be forced to close, you need to verify your game in your launcher (GOG/Steam/Epic).
To make sure it's really verifying, you can try running the Mod Remover (don't worry, it creates a backup of all your files!)
Corrupted Or Incomplete Game Data

If you get an error message that says Cyberpunk 2077 encountered an error caused by corrupted or incomplete game data, check below for some potential solutions:
Files / Permissions Errors
There's a few different pop-ups relating to file errors. These are caused by access errors – Cyberpunk is trying to read or write a file, and for some reason, it can't. Check below for some potential solutions.
Make sure that the file path exists
If Cyberpunk is trying to move files to a subdirectory that it can't access, make sure the directory actually exists. If it doesn't, create it.
The most frequent candidate for this is /
r6/cache/modded
Make sure that no previous game instance is running
Sometimes, the game doesn't shut down properly and still runs in the background. You can check this - and also actually close the game process - through the task manager.
Reboot your PC
If in doubt, you can just reboot your computer. It's a good idea to do this sometimes – in this case, it could make the error go away.
Make sure that all files in the game directory are writable
Sometimes, files in your game directory are set to read-only. You can fix this either via Windows Explorer or via system console, the results will be the same. Check below to see how.
Failed To Initialize Script Data
If you get this error check your NVidia Control Panel. If power saving options are enabled, turn them off.

... And You Don't Get Pop-up

The game isn't launching and doesn't even give you an error. How are you supposed to troubleshoot that?! Thankfully, there's a few things to try before diving into the deep end.
Check Your RED4ext Log
Find the folder Cyberpunk 2077/red4ext/log. Check for a file named red4ext-0000-00-00-00-00-00.log - the numbers will look different for every log. Sort your files by Date Modified and open the most recent one.
What Am I Looking At?
Press CTRL + F on your keyboard and search for error. Sometimes, there will be an error that tells you what's wrong. Some tell you the exact issue, such as:
[error] To use this version of RED4ext, ensure your game is updated to patch __ or newer
This means you need to update/buy the game!
Sometimes, the error is a little less specific. If you see the following error, you need to go back to the start of the troubleshooting guide and start from step 1:
[error] Could not attach the hook for the main function. Detour error code: 6
I Don't Have Errors, I Have Warnings
If your log has no errors, but you have lines that say warning, it's usually warning you about a specific mod. You can try reinstalling the mod it's complaining about, but if it still throws the same warning, it may not be compatible with the current version of the game.
If your warning says scc invocation failed with an error: REDScript compilation has failed, you need to check here instead.
My Log Doesn't Have Either
If your RED4ext log has no errors or warnings, it's worth checking where your log ends.
If your log doesn't have this, but the last line says something like:
Loading plugin from 'Your:\Drive\Cyberpunk 2077\red4ext\plugins\ModFolder\ModName.dll'...
Your game is dying before it's able to load that mod. Make sure you have the latest version of that mod. If it's not a core mod, remove it. If your game now launches, you may have to wait for it to be updated, or live without it.
If your log doesn't have this line:
scc invoked successfully
Redscript is not being called. To fix:
Disable Your Mods
This is an easy way to check if the issue is mod-related or not. Disable all your mods and try launching the game. If it launches, the problem lies within your mods somewhere. If not, the problem is with your game itself.
If you're using a mod manager, disable/purge your mods there. If you want to be extra cautious, you can also try the below
If you're manually installing, run the Mod Remover
I Disabled My Mods, Now What?
Do a fresh reinstall of all the core mods, then run the game. Hopefully, your game now launches. Now, you can either start modding the game again from scratch, or reinstall them and bisect your mods.
The Game Crashes Before the Menu

Your game launches, but crashes before you make it to the menu. Sometimes you'll get an error for this, sometimes you won't. Don't worry, there's a few things you can do in either case!
... And Doesn't Give An Error!
Most likely culprit is a mod. Unfortunately, there's no magic way to tell which one it is. You're going to have to bisect your mods to find the issue.
To make sure, you can disable every mod you have installed apart from the following:
If your game launches, the problem lies in your mods somewhere.
If it still doesn't launch, it's Mod Remover time.
... And Says Missing TweakDB File / Inaccessible Memory

If you run into this error:
Or if the game complains about attempting to read inaccessible memory, do this:
Navigate to your game directory and find the folder
r6\cacheFind the file
tweakDB.binand copy it (PressCtrl+Con your keyboard)In r6\cache, find the foldermoddedIf it doesn't exist, create it!
Paste
tweakDB.binhere (PressCtrl+Von your keyboard)If asked to overwrite, select
YesIf you have Phantom Liberty, repeat the process with
tweakdb_ep1.bin
Game Crashes Loading a Save

Your game launches fine, the menu loads, but you can't load your save. Don't panic! It probably isn't lost forever.
Where To Start?
It's frustrating to diagnose a crash with no information. If you're sure none of the above applies to your game, try these steps next:
Try starting a new save
Go back to the main menu and try loading an older save from the same playthrough
It's a Broken Mod
Vague, right? Unfortunately, that's the most likely reason for your crash. It's time to bisect your mods.
If you want the nucelar option, run the Mod Remover. If you had any of the following mods enabled on your save, reinstall them and their requirements to see if you can now load the save:
Weather mods that have custom weather states such as Nova City 2 or Enhanced Weather
Corrupt-ish Saves
Some mods store data in save files. Removing those mods may lead to your save game crashing until you install them again.
This is commonly seen with the following mods:
You cannot load a save that was made with this mod without this mod enabled
Weather mods that have custom weather states such as Nova City 2 or Enhanced Weather
These mods allow for custom weather states. If you saved while one of these custom states was active, the game is trying to load something that doesn't exist. The weather needs to be one available in the vanilla game before it can load without these mods.
If you remove Immersive Rippers, you need to save more than 100m away from a Ripperdoc before uninstalling the mod. From the mod page itself:
Make sure you save away from a Ripper (+100m should be plenty) And then delete the ImmersiveRippers.archive file from the "Cyberpunk 2077\archive\pc\mod" folder.
Game Crashes During Gameplay

You were just about to wipe out a bunch of Scavs, or you were just driving around the city, and your game crashed out of nowhere. Keep reading to find out what to do.
Known Issues
Material and Texture Override (MTO)

This tends to make the game crash somewhere in Japantown because of a mesh with a broken material. Material and Texture Override removes the cache and forces the game to re-create this material, making the game crash.
Many mods list MTO as a dependency, but it's usually optional. You only need it to force changes to original game materials.
As of 24 October 2025, a separate updated version has been uploaded. If a mod lists MTO has a hard requirement (not an optional one!), try this one instead.

Too Many Mods!
Yes, seriously, too many mods. This number seems pretty random, but generally doesn't start below 460.
The solution? Toggle off Enable Analytics in settings:

... And The Crash Is Easily Replicated
You're lucky - you can easily troubleshoot this. You need to bisect your mods, and see if it crashes at the same point with each set of mods. You'll know when you've found the issue because it won't crash anymore, yippee!
... And The Crash Is Completely Random
The most annoying type of crash, and unfortunately much harder to diagnose. A lot of long-time players just deal with the game crashing sometimes, like when tabbing in and out of the game occasionally.
If you can't deal with the crashes, you'll have to put in some work. There's a few options:
Use Mod Remover to make sure the issue is caused by mods, or just to start over
Game Starts, Mods Are Broken

Your game starts, but something is broken. Maybe a menu doesn't look right, maybe all the game sound is missing, maybe something else entirely.
While it's difficult to write troubleshooting for every possible thing that can go wrong with your mods, there will be a few common issues below.
If your issue is not listed here, or any of the above sections, you need to bisect your mods.
Common Issues
Have a look below to see if your issue is listed here. If not, you'll need to head on to the next section.
If you try a fix for your issue below and it doesn't make a difference, you need to bisect your mods.
Above all else, please make sure to read the descriptions of mods. They usually have install instructions and tell you exactly what you need to do to make everything work.
Outdated Mods
There are probably hundreds, if not thousands of outdated mods, but these ones still get downloaded to this day. If you have any of these, remove them.
This mod has been broken for a long time and will not work.
NPCs Gone Wild (NSFW)
In all versions since 2.0, this causes missing characters, missing body parts, exploding limbs, and other issues. Do not use the mod.
You Have Spawn0 Mods Installed

Most famous for physics-defying, back-breaking edits of the female body, Spawn0 has been around since the early days, and so have their mods.
Modding has come a long way since then, and Spawn0 never followed. Their mods are known to have compatibility issues with pretty much everything, including their own other mods.
With Phantom Liberty, Sp0 mods have been known to cause crashes to desktop near the dam.
Bisecting

You have hundreds of mods, and one of them is broken. How do you find out which one it is without wasting the entire day?
Bisecting With A Mod Manager
This is the easiest way to bisect your mods. Keep reading for a step by step guide on how to find that pesky mod breaking your game.
If you prefer a visual guide, check the bottom of this section!
Disable Half Your Mods
Not including the mods listed above, select half of your enabled mods and disable them.
Launch The Game
You need to launch the game to see what your next step is.
If the issue is gone
The problem mod exists in the mods you disabled. You need to continue to Step 3.
If the issue still occurs
The problem mod is in the mods you kept enabled. You need to repeat Steps 1 and 2 with these mods until you've found the problem mod.
Swap Halves
If your game launched with no issues in the previous step, disable the mods you just launched the game with and re-enable the other half. The problem mod should be in this set.
Now that you've narrowed it down slightly, you need to repeat Steps 1 and 2 with these mods until you've found the problem mod.
Remove The Problem Mod
Once you've bisected all the way down to enabling a single mod, you've found the one causing trouble. Remove the mod and launch your game again.
The issue should now be gone. Happy game!

Bisecting Manually
If you've manually installed your mods, you'll need to bisect them manually too. Even if it seems like a lot of work, it's the quickest way to find the problem mod.
The table below shows which folders contain mod files. All of these can be found in your game directory. You'll need to reference this table to find where the broken mod is.
\mods
Contains REDmods, can contain many file types in their own subfolders
\archive\pc\mod
Contains .archive and .xl files, for Archive-XL-based mods
\bin\x64\plugins\cyber_engine_tweaks\mods
Contains Cyber Engine Tweaks-based mods
\r6\scripts
Contains Redscript-based mods
\r6\tweaks
Contains RED4ext-based tweaks
Where Do I Even Start?
Find The Problem Folder
Navigate to
Cyberpunk 2077\modsRename it by adding an underscore to the end. It should now be called
mods_Create a new folder called
modsin your game directory
If this folder is empty, navigate to
Cyberpunk 2077\archive\pc\modRename the
\modfolder by adding an underscore to the end. It should now be calledmod_Create a new folder called
modinside the\pcfolder
You now need to launch the game. You will now run into one of these two scenarios:
The problem is gone, which means you've already found where the problem mod is, and you can move on to Step 2
The problem persists, which means you need to repeat the above process with the rest of the folders in the table until you find the folder it's in.
Re-enable Half Your Mods
When you've found the folder with the problem mod, you're ready to actually bisect.
Open up the folder you added an underscore to. This is your backup folder.
Move half of the mods from your backup folder into the folder you created - the one that doesn't have an underscore. This is your game folder.

Launch The Game
You need to launch the game to see what your next step is.
If the issue is gone
The problem mod exists in the mods in your backup folder.
If the issue still occurs
The problem mod is in the mods you re-enabled. You need to proceed to Step 4.
Disable Half Your Mods
Now, you need to take half of the mods in your game folder and place them into your backup folder.
Repeat Steps 4 and 5 until you find the problem mod!
Remove The Problem Mod
Now that you've found the problem mod, it's time to remove it from your game.
The issue should now be gone. Happy game!
Bisect: Video Guide
Log Files

The game's log files tend to be a bit unhelpful, but log files from mods tend to be more useful.
Where Can I Find Mod Logs?
Quite a lot of mods will create a log file, but only a few of them are useful when it comes to troubleshooting. Check the table below to see where to find them!
redscript_rCURRENT.log
\Cyberpunk 2077\r6\logs
red4ext-[NUMBERS].log
\Cyberpunk 2077\red4ext\logs
cyber_engine_tweaks.log
Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks
Isn't There An Easier Way?
If you don't want to find logs individually, and just want a script that finds them for you, you're in luck!
Download Doctor Presto's FindAllErrors script

Now, you can either:
Move it to your Cyberpunk install folder and double-click it
Drag-and drop your Cyberpunk folder on the file that you downloaded
The list will give you useful information along with a list of files to check. Once you've found the broken mod, you can go here for instructions on how to troubleshoot further – they also tell you when you should ask for help!
Removing All Your Mods

You've been troubleshooting for too long and just want to start over again. Lucky for you, we have instructions for that too.
By far, the easiest way to reset your install to an unmodded state is by using Mod Remover (also on GitHub). Thanks to our very own Manavortex, manually removing all your game folders is entirely unnecessary.
You can also use this to temporarily disable your mods, as it creates a full backup for you.
Make sure to read the mod description, it has very thorough instructions. The mod remover itself also has instructions at every step of the way.

If you're absolutely set on doing it manually, you can follow the steps in the dropdown below.
Verify / Repair Game Files
If you're not sure how to verify your game files, click below to find the instructions for your game launcher.
Thanks to @ArsenicTouch for the guides!
Go to
Games->InstalledRight-click on your game
Mouse over
Manage installationSelect the following menu entry:

Open your library
Right-click on
Cyberpunk 2077Select
Properties...

Select
Installed FilesClick
Verify integrity of game files

Open your
LibraryOn the Cyberpunk 2077 tile, find the
…Select
ManageClick
Verify
Mods Removed. Now What?

Try launching the game completely unmodded to make sure you've done everything right. If you have, the game should launch without any issues!
If it doesn't launch, you either have leftover files and need to re-do your previous step, or you have a problem that is not related to Cyberpunk.
If your game does launch, and you want to mod the game again, re-install the core mods.
Not sure what they are? Here's a list:
Once they're re-installed, launch the game.
If your game launches without issue, you can re-install your mods through your mod manager or from your backup folders. If you want to be extra cautious, you can try a fresh download of them all. If you start getting errors when re-installing mods, you'll need to bisect your mods.
If you're unsure on how to mod your game, or just want a refresher, you can follow this page.
If your game does not launch, double check the red box above.
Dealing With Broken Mods

You followed all the steps and your game launches, but you now have a mod on your hands that doesn't work, and you want it to. What do you do now?
Contact The Mod's Author
Describe your problem as clearly as you can, and add any useful information.
Example - Bad Bug Report

Example: Good Bug Report:

Fix It Yourself
At this point, you have exhausted all easily accessible solutions. If you want the mod to work, you'll have to get your hands dirty. That's the kind of passion the modding community thrives on.
Last updated




