Quick Usage Guide

public class PlayerData : PersistentScriptableObject
{
    public int gold;
    public int level = 1;
    public List<int> clearedLevels = new();
}

Create the asset with Create > Persistent Asset > Persistent Object…:

📷 img/data_asset_inspector
A PlayerData asset selected: the Persistence Manager dropdown at the top, gold, level and clearedLevels below it

Use it like any other ScriptableObject:

[SerializeField] PlayerData playerData;

void CollectCoin() => playerData.gold++;   // an ordinary field, saved for you

Data class →

Create > Persistent Asset > Persistent Variables, then add a row per value.

📷 img/nocode_variables_inspector
The Persistent Variables asset with several authored variables

Drag a row onto a GameObject and a menu asks what to add: a Variable Binder keeps the value in sync with something in the scene, a Variable Listener reacts when it changes, and a Variable Setter changes it.

📷 img/nocode_drag_to_gameobject
Dropping a variable on a GameObject: the "Binder / Listener / Setter?" menu

Ready-made prefabs sit under GameObject > Persistent Asset.

No-Code →

1. Add the Persistent Scene Object component to the object you want kept.
2. Under Saved Components, tick the components you want saved.

The persistent asset holding it all is created for you.

📷 img/scene_object_component
The Persistent Scene Object component, with Transform and a couple of others ticked under Saved Components

The common built-in components are supported out of the box, your own scripts are saved by their fields, and objects spawned during play are covered too.

Scene Objects →

[PersistentScriptableObject(nameof(persistenceManager))]
public class MyData : SomeOtherScriptableObject
{
    [SerializeField] PersistenceManager persistenceManager;
}

The attribute names the field you added. Nothing else changes.

Data class →

Prefs.Set("gold", 120);
Prefs.Set("lastCheckpoint", transform.position);

int gold = Prefs.Get<int>("gold");
Vector3 spot = Prefs.Get("lastCheckpoint", spawn.position);   // fallback when missing

The first call automatically creates a persistent asset in your project.

📷 img/prefs_asset_inspector
The Prefs asset the first call creates, with a few values in it

These values get every feature of the package.

Prefs →

Point your AI agent at Assets/Persistent Asset/AI/Skills and it knows how to use the package. Agents that read skill folders find it on their own.

📷 img/ai_skills_folder
Assets/Persistent Asset/AI/Skills in the Project window, the eight skill folders open

From there, ask for what you want in your own words. It writes the code and wires the scene.