Getting started

After importing Easy Save from the Asset Store, you can immediately use Easy Save from your scripts and from PlayMaker.

For information on saving and loading without code using Auto Save, see the Auto Save guide.

For information on PlayMaker actions available, see the PlayMaker Actions Overview.

Easy Save stores data as keys and values, much like a Dictionary.

For example, to save an integer to a key named myInt and load it back again, you could do:

If there’s no data to load, it will return the defaultValue.

If you don’t specify a defaultValue:

  • You must provide the type of the data you are loading as the generic parameter.
  • You must ensure that there is data to load, for example using ES3.KeyExists:

To load a value into an existing reference, use ES3.LoadInto:

Note that ES3.LoadInto only works for reference types, not primitive types (e.g. int, string) or value types (e.g. structs).

You can also save and load Arrays, Lists, Dictionaries, Queues, Stacks and HashSets in the same way as you would save and load any other data.




2D Array




For most projects it makes sense to load in Start(), and save in OnApplicationQuit(), or OnApplicationPause(true) on mobile.

You can also use buttons to save and load.

The filePath parameter lets you specify where data is saved. The file or folder will be automatically created if it does not exist.

This can be a filename, a relative path, or an absolute path. For more information, see the Paths and Locations guide.


Relative path

Absolute path

Delete a key

Delete a file

Delete a directory

Change default settings by going to Window > Easy Save 3 > Settings.

Enable settings at runtime by providing an ES3Settings object as a parameter. See the ES3Settings page for more information.

Enable encryption

Enable compression

To see what types are supported, see our Supported Types guide.