编辑“Save-game editing”

{{version|Timeless}}

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) ==
{| class="wikitable"
|-
! OS                                          !! Location                       
|-
| Windows auto saves (including ironman saves)    || <code>%USERPROFILE%\Documents\Paradox Interactive\Stellaris\save games\$EMPIRENAME+ID\</code>
|-
| Windows custom saves     || <code>\Steam\userdata\%STEAMUSERID%\281990\remote\save games\$EMPIRENAME+ID\</code>
|-
| Mac     || <code>$HOME/Documents/Paradox Interactive/Stellaris/save games/$EMPIRENAME+ID</code>
|-
| Linux     || <code>$HOME/.local/share/Paradox Interactive/Stellaris/save games/$EMPIRENAME+ID</code> (<code>$XDG_DATA_HOME</code> is ignored!)
|-
| Linux (newer versions)     || <code>$STEAMFOLDER/userdata/$STEAMID/281990/remote/save games/$EMPIRENAME+ID</code>
|}

Cloud saves can be edited.

Here are the cloud saves locations:

{| class="wikitable"
|-
! OS                                          !! Location
|-  
| Mac     || ~/Library/Application Support/Steam/userdata/<YOUR STEAM ID>/281990/remote/save games/
|}

== Location (Paradox Launcher Version) ==
{| class="wikitable"
|-
! OS                                          !! Location                       
|-
| Windows     || <code>%USERPROFILE%\Documents\Paradox Interactive\Stellaris Plaza\save games\$EMPIRENAME+ID\</code>
|-
| Mac     || <code>???</code>
|-
| Linux     || <code>$HOME/.local/share/Paradox Interactive/Stellaris Plaza/save games/$EMPIRENAME+ID</code> (<code>$XDG_DATA_HOME</code> is ignored!)
|}

== Location (GamePass Launcher Version) ==
{| class="wikitable"
|-
! OS                                          !! Location                       
|-
| Windows      || <code>%USERPROFILE%\Documents\Paradox Interactive\Stellaris GamePass\save games\$EMPIRENAME+ID\</code>
|}

== Format ==
Each .sav file is a ZIP archive containing two text files: <code>gamestate</code> and <code>meta</code>. 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 [[wp:Newline|newlines]]. Windows Notepad will not save the newlines correctly, so another editor such as [[wp:Notepad++|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 ===

[[File:7zip_options.png|thumb|Options for 7-Zip]]

Use [[wp:7-Zip|7-Zip]] with the following options:
* Archive format: zip
* Compression speed: Fast
* Compression method: Deflate
* Do not include NTFS timestamps (<code>tc=off</code> 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:
[[File:Choose Application dialog.png|thumb|right|Navigate and select Archive Utility app]]
 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 [http://pastebin.com/nyX1B4rH 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.

<code>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" )</code>

{{ModdingNavbox}}
[[Category:模组制作]]