Code Mode

This approach is designed for experienced developers who want full programmatic control over saving and loading.

⚠️ Usually, you don’t need this, adding Saveable components handles everything for you automatically. Use this method only if you want to bypass components entirely, or if you need custom save logic.

Below is a simple example showing how to save data directly in code, without attaching any components to your GameObjects.

SaveManager.Save()

Saves a value to memory.

public static void Save<T>(string key, T value, PersistenceScope scope)

Parameters:

• key: Unique identifier (for example, "playerHealth")

• value: Any serializable value

• scope: PersistenceScope.Global or PersistenceScope.Scene . If you´re unsure what PersistenceScope means, please refer to Persistence Scope Core Concepts.

Examples:

SaveManager.Save("health", 100, PersistenceScope.Global);
SaveManager.Save("position", transform.position, PersistenceScope.Scene);
SaveManager.Save("inventory", myInventoryList, PersistenceScope.Global);

⚠️⚠️ IMPORTANT !! ⚠️⚠️

Critical Rule: Save() writes to memory. Call SaveAll() to write to disk.

OmniSave uses a two-phase save:

1. Save() → Writes to RAM (temporary, it´s not really saved anywhere persistent)

2. SaveAll() → Writes to disk (persistent)

// WRONG: Lost on game quit
SaveManager.Save("coins", 999, PersistenceScope.Global);
// Data only in memory!

// CORRECT: Persisted
SaveManager.Save("coins", 999, PersistenceScope.Global);
SaveManager.SaveAll(); // Now it's on disk

SaveManager.Load()

Loads a value from memory/disk.

public static T Load<T>(string key, PersistenceScope scope, T defaultValue = default)

Returns: Loaded value or defaultValue if not found.

Examples:

int health = SaveManager.Load("health", PersistenceScope.Global, 100);
Vector3 pos = SaveManager.Load("position", PersistenceScope.Scene, Vector3.zero);
List<string> items = SaveManager.Load("inventory", PersistenceScope.Global, new List<string>());

SaveManager.Has()

Checks if a key exists.

public static bool Has(string key, PersistenceScope scope)

Example:

if (SaveManager.Has("checkpointReached", PersistenceScope.Scene))
{
    Vector3 checkpoint = SaveManager.Load<Vector3>("checkpointPos", PersistenceScope.Scene);
    player.position = checkpoint;
}

SaveManager.Delete()

Removes a key.

public static bool Delete(string key, PersistenceScope scope)

Example:

SaveManager.Delete("temporaryBonus", PersistenceScope.Global);
SaveManager.SaveAll(); // Persist deletion

API Method List

Refer to Full SaveManager API

Common Patterns

Pattern 1: Player Stats

public class PlayerController : MonoBehaviour
{
    private int health = 100;
    private int coins = 0;
    
    void Start()
    {
        health = SaveManager.Load("playerHealth", PersistenceScope.Global, 100);
        coins = SaveManager.Load("playerCoins", PersistenceScope.Global, 0);
    }
    
    public void TakeDamage(int damage)
    {
        health -= damage;
        SaveManager.Save("playerHealth", health, PersistenceScope.Global);
        SaveManager.SaveAll();
    }
}

Pattern 2: Checkpoint System

public class CheckpointManager : MonoBehaviour
{
    public void SaveCheckpoint(Vector3 position)
    {
        SaveManager.Save("checkpoint", position, PersistenceScope.Scene);
        SaveManager.SaveAll();
    }
    
    public Vector3 GetCheckpoint()
    {
        return SaveManager.Load("checkpoint", PersistenceScope.Scene, Vector3.zero);
    }
}

Pattern 3: Progression System

public class ProgressionManager : MonoBehaviour
{
    public void UnlockLevel(int level)
    {
        SaveManager.Save($"level_{level}_unlocked", true, PersistenceScope.Global);
        SaveManager.SaveAll();
    }
    
    public bool IsLevelUnlocked(int level)
    {
        return SaveManager.Load($"level_{level}_unlocked", PersistenceScope.Global, false);
    }
}

Pattern 4: Custom Data Structures

[System.Serializable]
public class InventoryData
{
    public List<string> items = new List<string>();
    public int capacity = 20;
}

public class InventoryManager : MonoBehaviour
{
    private InventoryData inventory;
    
    void Start()
    {
        inventory = SaveManager.Load("inventory", PersistenceScope.Global, new InventoryData());
    }
    
    public void AddItem(string itemName)
    {
        inventory.items.Add(itemName);
        SaveManager.Save("inventory", inventory, PersistenceScope.Global);
        SaveManager.SaveAll();
    }
}

Combining Code-First + Saveable Component

They work seamlessly together in the same slot:

public class HybridController : MonoBehaviour
{
    // GameObject has Saveable component saving Transform
    
    private int score;
    
    void Start()
    {
        // Load Code-First data
        score = SaveManager.Load("score", PersistenceScope.Global, 0);
    }
    
    public void AddPoints(int points)
    {
        score += points;
        SaveManager.Save("score", score, PersistenceScope.Global);
        
        // Saves both Code-First and Saveable component data
        SaveManager.SaveAll();
    }
}