Unity-Saver
Encrypted local data storage in Unity runtime on any platform. Thread safe, Unity-Saver uses dedicated non-main thread for Read/Write operations with files. Data can be stored in different locations:
✅ Persistant - Regular Unity PersistantDataStorage location✔️ iOS✔️ Android✔️ Standalone
✅ Local - current location of executed app❌ iOS❌ Android✔️ Standalone
✅ Custom - any path on your own❌ iOS❌ Android✔️ Standalone
How to install - Option 1 (RECOMMENDED)
- Install ODIN Inspector
- Install OpenUPM-CLI
- Open command line in Unity project folder
openupm --registry https://registry.npmjs.org add extensions.unity.saver
How to install - Option 2
- Install ODIN Inspector
- Add this code to
/Packages/manifest.json
{
"dependencies": {
"extensions.unity.saver": "1.0.8",
},
"scopedRegistries": [
{
"name": "Unity Extensions",
"url": "https://registry.npmjs.org",
"scopes": [
"extensions.unity"
]
}
]
}
Usage API
Usage is very simple, you have access to a data through Data
property in saver class.
Data
- current data with read & write permission (does not read and write from file)DefaultData
- access to default data, this data whould be taken on Load operation, only if file is missed or curruptedLoad()
- force to execute load from a file operation, returnsasync Task
Save()
- insta save currentData
to a file, returnsasync Task
SaveDelay()
- put save operation in a queue, if the same file is going to be saved twice, just single call will be executed. Very useful when data changes very often and required to call Save often as well. You may call SaveDelay as many times as need and do not worry about wasting CPU resources for continuously writing data into file.
How to use in MonoBehaviour
using Extensions.Saver;
public class TestMonoBehaviourSaver : SaverMonoBehaviour<TestData>
{
protected override string SaverPath => "TestDatabase";
protected override string SaverFileName => "testMonoBehaviour.data";
}
How to use in ScriptableObject
using UnityEngine;
using Extensions.Saver;
[CreateAssetMenu(menuName = "Example (Saver)/Test Scriptable Object Saver", fileName = "Test Scriptable Object Saver", order = 0)]
public class TestScriptableObjectSaver : SaverScriptableObject<TestData>
{
protected override string SaverPath => "TestDatabase";
protected override string SaverFileName => "testScriptableObject.data";
protected override void OnDataLoaded(TestData data)
{
}
}
How to use in C# class
using System;
using System.Threading.Tasks;
using Extensions.Saver;
public class TestClassSaver
{
public Saver<TestData> saver;
// Should be called from main thread, in Awake or Start method for example
public void Init()
{
saver = new Saver<TestData>("TestDatabase", "testClass.data", new TestData());
}
public TestData Load() => saver?.Load();
public async Task Save(Action onComplete = null) => await saver?.Save(onComplete);
}