Save-game editing

Version

This article is timeless and should be accurate for any version of the game.

This article details Stellaris save game format and how to edit them. As a reminder, always make a backup copy of your save file before editing!

## Location (Steam Version)

Cloud saves can be edited.

Here are the cloud saves locations:

## Format

Each .sav file is a ZIP archive containing two text files: `gamestate` and `meta`. They include all the game state data and the meta-information that is shown on the load game screen.

The game seems to be unusually picky about the format when loading:

* The files within the ZIP archive must use UNIX-style newlines. Windows Notepad will not save the newlines correctly, so another editor such as Notepad++ must be used.
* The files within the ZIP archive must have correct timestamps. See OS-specific instructions below.
* When zipping the files, **you should select the two text files and create a new .sav archive from those files**. If you try to zip the folder containing the edited files, you will get a broken save error when trying to load the game. Move the new .sav into the main save folder

### Compression on Windows

Use 7-Zip with the following options:

* Archive format: zip
* Compression speed: Fast
* Compression method: Deflate
* Do not include NTFS timestamps (`tc=off` parameters in bottom left of 7-Zip, or use a version equal to 9.12 beta or earlier)

Do not use WinRAR as it messes compressed lines.

By using the edit function in the 7zip file manager (the editor needs to be chosen by going to tools then options then editor and putting a link to editor of chice) the file can be edited and then once the file is closed 7zip will automatically re-compress the file to ensure no issues

### Compression on Linux or macOS

Use Apple's **Archive Utility** app to unzip the .sav game file. To do that:

```
1. Right-click the .sav file and click **Open With > Other...**
2. Navigate to: <computer_name>/System/Library/ CoreServices/Applications
3. In the **Choose Application** dialog change **Enable** option to **All Applications**
4. Select the **Archive Utility**, then click **Open**

```

A folder appears with the same name as the .sav file containing the *gamestate* and *meta* files. Edit using any text editor able to save in Unix LF format.

Put the save back together using:

```
   zip -X output.sav gamestate meta

```

The -X flag is needed to "eXclude eXtra file attributes".

Alternatively, run this Python script from the directory containing the gamestate and meta files.

An easier way to compress the saves on Mac is to highlight the two files, left click and click "Compress 2 Items". A .zip file named Archive.zip will appear: left click on this and click "Get Info". Under the "Name & Extension" section, click the box containing Archive.sav and change **.zip** to **.sav**. You will be prompted for confirmation on changing the extension.

## Save Attributes

### *gamestate* File Details

Nearly any information about a given playthrough can be modified via editing the *gamestate* file. This includes current energy, mineral, food and unity stores, as well as planet tiles and pop traits. The following is an example of a populated tile on a Fallen Empire's planet, containing a dark matter power plant.

`0={
active=yes
pop=127
resources={
minerals={1.000 1.000 0.000} } building={ type="building_dark_matter_power_plant" modifier=yes
}
deposit="d_mineral_deposit" )`

**Modding**