Simple Save
I

Publisher

iatenine

Simple Save

Tools
Save Load Snapshot Scene Partial State Management Serialization

Adds functions to save and load "snapshots" of any given scene in its current state version 1.2 now supports partial saves to create and load snapshots of individual nodes and their children and no longer requires user to create directories manually before attempting to save to them

SimpleSave

How to install

  • Add simple_save.gd to your project files
  • You should now be able to call the functions listed below by calling SimpleSave.function_name()

Methods

Return Type Method Description
Error save_scene(tree:SceneTree, filename:String) Saves a snapshot of the SceneTree provided to the filename specified by the second argument, overwriting it if it exists
Error save_scene_partial(top_node:Node, filename:String) Saves a snapshot of the node provided and all its children to the given filename, overwriting it if it exists
Error load_scene(tree:SceneTree, filename:String) Changes the scene provided to the scene located in the specified filename
Error load_scene_partial(top_node:Node, filename:String) Changes the node provided to the node located in the specified filename

Examples

  • Saving

    • Can be called from any node within the target scene by passing "get_tree()" as the first parameter
    • You can save a SceneTree from an external node but will need to pass a reference to it as the first parameter (uncommon)
    • Will overwrite a file if it exists already
    • Will create any necessary directories that don't already exist in your project

      SimpleSave.save_scene(get_tree(), "res://save_slots/snapshot0.tscn")

  • Loading

    • Recommended to call from the scene's root node when loading using load_scene() or at least an ancestor when using load_scene_partial()
    • Will still function from other nodes but seems to cause a flicker

      SimpleSave.load_scene(get_tree(), "res://save_slots/snapshot0.tscn")