# Broken Mods: How To Help
{% hint style="info" %}
This page assumes that you have made use of the [troubleshooting guide](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting.md), have identified a broken mod and want to help fixing it.
It will help you **rule out side effects** and **collect** **the necessary information** for a bug report. Of course you can always [reach out](#step-3-reaching-out), but there's a good chance that you'll be asked to do the stuff on this list, so you might as well do it first.
If you can't or won't do that, please [check at least Step 0](#step-0-check-the-nexus-page)!
{% endhint %}
## Thank you!
Without people like you, many bugs would never be discovered and fixed, and modding would be even more frustrating than it already is. So **thank you** for taking the time!
***
## Step 0: Check The Nexus page
### Are you on the most recent version?
> "Crashes when you equip your strap-on? I fixed that a month ago. Just update! :)"
Make sure that you're on the most recent version of both the mod. You probably are, but — better double-check.
{% hint style="info" %}
This recommendation comes from a professional software developer, who has "fixed" more than one software problem by *just updating the software*.
{% endhint %}
### Is there a "known issues" section or a pinned comment?
Maybe the mod author knows about this problem and hasn't been able to fix it. If they do, then either the **description** will mention it, or there will be a pinned post in the comments section.
If there isn't either, then you have found something new. Exciting!
***
## Step 1: Isolate
The first step is to **isolate** the problem. Make sure that it is exactly this mod and no other. It works like this:
1. Temporarily [remove all mods](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting.md#removing-all-your-mods) from your game.
2. Install **only** the problem child together with **all** [**dependencies**](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting/requirements-explained.md). Make sure that they're all on the most recent version. Does the problem still happen?\
\&#xNAN;*(If not, then it's something else)*
3. Now, disable **only** the problem child. Does the problem go away?\
\&#xNAN;*(If not, then it's one of the dependencies)*
{% hint style="info" %}
If the problematic mod is a core framework, please read [the next section](#for-a-core-framework) as well.
{% endhint %}
If you can **reliably reproduce** the problem (that's Netrunner speech for "it happens every time without fault"), then you have everything you need for a bug report.
***
### For a core framework
If your problem child isn't one of [these mods](/cyberpunk-2077-modding/for-mod-creators-theory/core-mods-explained.md), you don't need to read this.
The core frameworks are generally **extremely stable**. That's not to say that they don't have bugs, but such bugs are generally found and fixed quickly.
If you suspect that one of them is the cause of your crash, make **very sure** that you have no **dependent mods** installed, since those will be inactive as long as the dependency isn't there (think of it like a fuse box: without electricity, the fridge can't keep making that noise).
***
## Step 2: Gather The Necessary Data
Since your problem could be anything, we'll go about it the other way. I'll list everything that you **could** include, and tell you when it's needed.
### Reproduction steps
**When: Always**
Any information you collect is helpful, but fixing a bug is easiest if you can watch it with your own eyes. For that reason, we need a list of the exact steps needed to make the problem happen.
Write the steps they need to **do**, not the ones they don't.
A lengthy example in case you're unclear about why you'd need a list
Imagine the following (hypothetical) bug report:
OK, so the game crashes with only your mod and its dependencies (ArchiveXL, TweakXL, Red4ext) installed! I'm on the most recent version. Here's what I did:\
I created a new character. Has to be a nomad, female body gender and male brain gender, doesn't work if it's anything else (I made a hot blonde, here's a screenshot, aren't they cute?) Then I added the pink unicorn hat and the Sword of Truth via cheat. Has to be the sword, the Mace of Maybe works! Then hit the car mechanic and the game crashes. Oh yeah, it only does that if you do the hat before the sword! And also only on the pink version, the green variant works fine! Cheers!
Do you know what to do? I lost track halfway through, and I *wrote* that. Also, did they equip the items, or is it enough to have them in your inventory?
This here is much clearer:
1. Have a clean install (ArchiveXL, TweakXL, Red4Ext, version 1.2.3. of This Mod Doesn't Exist)
2. Create a new character (female body gender, male brain gender, Nomad lifepath)
3. Add the pink unicorn helmet via CET command `Game.AddToInventory("Items.this_is_just_an_example")`
4. Add the Sword of Truth via CET command `Game.AddToInventory("Items.this_is_also_just_an_example")`
5. *Optional: you can create a save here*
6. Equip the helmet
7. Equip the sword
8. Hit the car mechanic
9. the game crashes
***
### Save game
**When:** If the problem happens
* at a certain location or a certain quest phase
* when loading into exactly this save (if it happens for all of your saves, then it's probably not needed)
Your save games can be found in the following folder:
```
%USERPROFILE%\Saved Games\CD Projekt Red\Cyberpunk 2077
```
which is the same as
```
C:\Users\\Saved Games\CD Projekt Red\Cyberpunk 2077
```
Find your individual save game folder (e.g. `AutoSave-0`) and [create a zip](https://support.microsoft.com/en-us/windows/zip-and-unzip-files-f6dde0a7-0fec-8294-e1d3-703ed85e7ebc).
***
### Log files
**When:** If the problem child
* adds an error in any log files that doesn't happen without it (use the [error checker tool](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting/finding-and-reading-log-files.md#finding-the-log-files))
* Is a plugin (lives in `Cyberpunk 2077/bin/x64/plugins)`
* Is **dependent on a plugin** (like above, but with more subfolders)
**What:**
* The log file with the error
* If it's a plugin mod, then add the plugin's log. Most common here is Cyber Engine Tweaks; the log file is `Cyberpunk 2077/bin/x64/plugins/cyber_engine_tweaks/cyber_engine_tweaks.log`
***
### Crash report
**When:** If the problem child is one of the [core frameworks](/cyberpunk-2077-modding/for-mod-creators-theory/core-mods-explained.md).
{% hint style="info" %}
These mods are the foundation that everything else builds on, and the people who develop and maintain them are incredibly competent. Please don't waste their time — make **very sure** that you have [isolated](#step-1-isolate) the problem. You don't call your internet provider before checking your network cable and restarting your router!
{% endhint %}
You can find the crash reports in this folder:
```
%USERPROFILE%\AppData\Local\REDEngine\ReportQueue
```
which is the same as
```
C:\Users\\AppData\Local\REDEngine\ReportQueue
```
Find the most recent one (e.g. `Cyberpunk2077-20230816-225038-11372-16140`) and [create a zip](https://support.microsoft.com/en-us/windows/zip-and-unzip-files-f6dde0a7-0fec-8294-e1d3-703ed85e7ebc).
***
## Step 3: Reaching Out
You're 100% sure that the mod is the cause of the problem, and you have collected the necessary information, so now you can reach out and provide a helpful bug report.
The first place to go is the mod's **Nexus page**.
1. If there is a `Bugs` tab, you can create a new bug report
2. If there is a `Posts` tab, you can leave a post
3. If there is a `Comments` tab, you can drop a comment
4. If there is neither, you can try and message the author (click on their Nexus profile name)
***
## Step 4 (optional): Discord
If you can't reach the mod author, you're welcome to hit up the [redModding Discord](https://discord.gg/hUdjp4JP), for example in `#mod-troubleshooting`. Someone there might be able to get the word out.
***
### Corrupt(ish) saves
If you have found a mod that [corrupts save games](/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting.md#corrupt-ish-saves) until it is installed again, **please let us know** so that we can update the troubleshooting guide!
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-users/user-guide-troubleshooting/broken-mods-how-to-help.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.