Table of Contents

objectstore saves an object to a persistent local store. All properties that are normally saved on the object are saved with ObjectStore. The data is stored on the local computer and will be saved between runs of the game. Can be used for progress, game saving, or preferences.

When used with Nada, make sure you mark the data to be saved with either [Serialized] or [Property] attributes.

class ObjectStoreTest : NadaComponent
{
    [Property]
    var SomeArchetype : Archetype = null

    function Initialize(init : CogInitializer)
    {
        //just some simple stuff here to cause compilation to work
        var someObject : Cog = null;        
        
        //Restore an object called "Name" and if it does not exist use  SomeArchetype to create it.
        //Also takes the space to create the object in.
        var object = Zilch.ObjectStore.RestoreOrArchetype("Name", "Archetype", this.Space);
        
        //Store the object on local computer
        Zilch.ObjectStore.Store("Name", someObject);
        
        //Restore an object. Null object if not found.
        Zilch.ObjectStore.Restore("Name", this.Space);
    }
}

To clear all stored objects on a computer you can use the ClearStore command.


Related Materials

Code Reference

Tutorial