Starfield Save Tool

A tool to decompress and convert Starfield save games to JSON format. Save games are stored in a compressed format (.sfs) and this tool will decompress the data and output the metadata to JSON. Save games are normally found in the C:\Users\<USERNAME>\Documents\My Games\Starfield\Saves directory.

Any help with the file format would be appreciated, the majority of unknowns are in the header of the compressed sfs file, and the plugins data within the decompressed file. I'm not including the main data blocks of the decompressed file as we are primarily interested in the metadata.

Thanks to Mod Organizer 2 for it's help to get started writing this tool and to help formalize this file format research. Special thanks to Silarn for the reverse engineering help.

Contribute

This is all work in progress and there is plenty more that needs reverse engineering and explaining. Please see GitHub Repo for more information on this file format and how to help out.

Usage

The tool will always output JSON to the console. See below for options to write JSON to a file and to write the decompressed data to a file (useful for reverse engineering).

Drag-and-drop

The simplest way to use the tool is to drag-and-drop a save file (.sfs) onto the Launch.bat file. This uses the --output-json-file and --output-raw-file options below.

Command Line

StarfieldSaveTool <file>

<file>: Starfield save file to parse (.sfs)

-j, --output-json-file  Write JSON output to file

-r, --output-raw-file Write raw output to file

-c, --change-file Experimental: Writes the modified save file

--version Show version information

-?, -h, --help Show help and usage information

Usage Examples

'StarfieldSaveTool C:\Test\MySave.sfs' will output metadata only to the console

'StarfieldSaveTool C:\Test\MySave.sfs --output-json-file' will output metadata to the console and to C:\Test\MySave.json

'StarfieldSaveTool C:\Test\MySave.sfs --output-json-file --output-raw-file' will output metadata to the console and to C:\Test\MySave.json and save the decompressed data chunks from the .sfs file to C:\Test\MySave.raw