# Savegame Editor: CyberCAT

## This is the documentation for the [CyberCAT save editor](https://www.nexusmods.com/cyberpunk2077/mods/718).

{% hint style="danger" %}
Using the save editor puts you at risk of **creating a bricked savegame**. This means that the save will still load in Cyberpunk, but certain things in the game are broken (e.g. quests are stuck or won't trigger).

If your savegame crashes on load, please check the [#troubleshooting](#troubleshooting "mention") section.
{% endhint %}

## Version Compatibility

CyberCAT is version dependent. If you want a savegame to load with a certain version of the game, you must use the compatible version of CyberCAT.

| Game Version          | CyberCAT version |
| --------------------- | ---------------- |
| 2.1.1                 | >= 0.27d         |
| 2.0 / Phantom Liberty | >= v0.26         |
| 1.63\_hotfix1         | ???              |

## Usage Instructions

On Windows, save games are stored in

```
%USERRPROFILE%\Saved Games\CD Projekt Red\Cyberpunk 2077
```

1. Import your savegame
2. Make the necessary changes
3. Export your savegame again. Save it **in the same folder**.

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-c1251ff0ad9dd7eefde97430caf6524eb8ed5792%2Fcybercat_save_editor.png?alt=media" alt=""><figcaption></figcaption></figure>

### Appearance Presets

After loading a save, you can export V's appearance as a preset from the **Appearance** tab. This will create a `v2preset` file, which you can import via `Load Preset`.

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-2fd0d15803b6414fdcfe10f57f36124601fec75a%2Fcybercat_appearance_editor.png?alt=media" alt=""><figcaption></figcaption></figure>

### Adding items

You can add items from the Inventory tab or edit existing items by double-clicking on them.

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-86cdde28e9f52c78db48f90974ca8931c9702c88%2Fcybercat_adding_items.png?alt=media" alt=""><figcaption></figcaption></figure>

* Switch inventories in the upper right corner
* Edit items by double-clicking them
* Add new items by using the corresponding button

In the Add Item tab, you can use the dropdown to search the item's base ID. If that doesn't help you, check the top sections of our wiki page [spawn-codes-baseids-hashes](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/references-lists-and-overviews/equipment/spawn-codes-baseids-hashes "mention") on how to find a specific item.

### Quest Facts

CyberCAT lets you edit quest facts:

{% hint style="danger" %}
This is an excellent way to brick your savegame forever. Make a backup. You have been warned. (Check [here](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/quest#quest-editing-risks-and-side-effects) for an explanation)
{% endhint %}

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-b8e79f9d299e9e8009ad297d13828469a23cdd45%2Fcybercat_questfacts.png?alt=media" alt=""><figcaption></figcaption></figure>

### Quest editing: Risks and side effects

While you progress through the main story, Cyberpunk will log your progress by setting `quest facts`. These are not standardized and will only be checked under specific circumstances, usually when the game is about to trigger the next stage of a quest or event.

**Once that moment has passed, there is&#x20;*****no*****&#x20;way to re-trigger it other than loading an earlier save.** This is not an issue of tooling, it's simply due to how Cyberpunk's quest system works.

#### Can I Change the Outcomes of Quests?

Unfortunately, no. Quest state data is currently not editable with the save editor and there are currently no plans on implementing it.

#### Can Quest Facts Affect Past and/or Future Quests?

Past: no. Future: *Maybe.* Almost all quest facts will at best do nothing by setting or changing them and more commonly will break your quest system. There are **very few** that will work and most are dependent on when they're set.

#### What Can I Do to Change the Outcome of a Quest?

Your only option is to reload from a previous save and make better choices. If only life worked the same way.

#### I Really, Really, Really Want to Set a Quest Fact. What Can I Do?

While the save editor currently supports setting them, we recommend using CET commands if you must go down that route. The [CET command list](https://1drv.ms/x/s!ArM35g0UkWjvjcVPT-fhFPPCZUfDLw?e=BOxScl) contains *some* that *might* work in very few instances. Again, most of these are not supported and are highly dependent upon when they are set.

## Known Issues

* Appearance editor is disabled until its fully fixed.
  * Only gender and voice tone can be changed.
  * Loading / Saving of presets still works
* Item additions might not fully work yet

## Troubleshooting

### Folder structure

Make sure that you export to a savegame folder. They contain the following files:

* metadata.9.json
* sav.dat
* screenshot.png

CyberCAT needs those files to correctly export the savegame.

### Asking for support

{% hint style="info" %}
Please keep in mind that **nobody is paid** to work on this tool — CyberCAT is maintained by volunteers **in their free time**.
{% endhint %}

Once you have exhausted all other means of support, you can find help in `#save-editing` on the [Wolvenkit Discord](https://discord.gg/redmodding). Please have the following things handy:

* [ ] The original save (before you edited it)
* [ ] The altered (damaged) save
* [ ] A description of what you did, as concise as possible
* [ ] The error.txt (if you have one)