Custom Save Data

Makinom allows you to add custom save data to the save game system.

Add custom save data (e.g. 3rd party product data) to Makinom save games by registering a class (e.g. a component) to the save game system. The class must implement the ISaveData interface.

Registering a Class #

To register a class, call the following function:

The parameters of the function:

  • string name
    The name used to register the custom save data.
    You can only register one custom save data for per name.
    Registering the same name again will replace the previously registered save data and pring a warning in the Unity console.
  • ISaveData saveData
    An instance of the class that implements the ISaveData interface.
  • bool beforeSceneLoad
    This flag decides if the custom save data will be loaded before (true) or after (false) the scene has been loaded when loading the save game.

If you want to unregister a class from the save game handler, you can call the following function:

Please note that only registered save data can be saved or loaded, i.e. you have to register your classes before saving or loading the game. This is best done in the scene you also initialize Makinom via a game starter.

The ISaveData interface #

This interface has two functions that need to be implemented into your class:

This function is called when the game is saved. It returns a DataObject, which holds all the data that you want to save.

This function is called when a save game is loaded. The DataObject passed as parameter contains the data that is saved. It’s crucial to make a check for null on the data object before using it, since it could be null if no data was found for the registered name – in that case, you can use the load game function to do default initialization.

Code Example #

Here’s a small code example on how the custom save data functionality can be used. The example uses a component (MonoBehaviour), but you can also use similar code in other classes.

It’s crucial that the class you register to the save game handler must be alive throughout the entire game, and it’s best if you register it in the same scene where Makinom is first initialized with a game starter. Don’t register custom save data in a running game, this will lead to the classes not being registered if you play the game at a later time and want to load a save game.

Class within a Class #

You can also save the data from classes within your custom save game data by implementing the ISaveData interface in the class. This allows creating complex save game structures.

To add the data of a class to your custom save data:

To load the data of a class from your custom save data:

Naturally you can also save classes within classes, within classes …