Skip to content

Save file format

Rufus Pearce edited this page Feb 23, 2026 · 15 revisions

Save and load functionality is handled by the SaveManager class.

It uses a structured approach that packages all game data into a single, portable file.

Save File Location and Types

The SaveManager creates and manages files within a saves directory in the application's root folder. It maintains two distinct save slots:
  • autosave.zip: This file is used for periodic, automatic saves that occur in the background.
  • save_data.zip: This file is used when the player manually saves their game through the File menu.

Save File Structure

When save_game() is called, it bundles data into the following internal JSON files within the zip archive:
  • game_state.json: Contains general game state information, such as the squid's core stats (hunger, happiness), and other top-level game variables.
  • brain_state.json: Stores the complete state of the neural network, including neurogenesis data and the pattern buffer of learned experiences.
  • ShortTerm.json: A snapshot of all memories currently in the squid's short-term memory.
  • LongTerm.json: A snapshot of all memories that have been consolidated into long-term memory.
  • plugin_data.json: Contains any persistent data that active plugins have chosen to save.
  • statistics.json: Stores persistant statistics tracked over time such as squid age, distance swam, foods eaten, etc
  • uuid.txt: Unique squid identifier (128bit number)

SaveViewer.html is available for easy viewing and comparisons of save files.

This tool can also convert old v1 saved games (pre 2.4.5.0) to the new v2 format (2.5.0.0+)

Clone this wiki locally