Spawning Persistent Objects

Objects spawned at runtime need special handling to persist, as traditional Instantiate() from Unity will not persist the instantiation.

Resources Prefabs (Sync: Recommended for Resources)

GameObject obj = SaveManager.InstantiatePersistent(
    "Prefabs/Coin",  // Path in Resources ( string )
    position, 
    rotation
);

Prefab MUST be in a Resources folder.

Addressables Prefabs (Async: Recommended for Addressables)

GameObject obj = await SaveManager.InstantiatePersistentAsync(
    "YourAddressableKey",
    position,
    rotation
);

Prefab MUST be marked as Addressable

( See image below, where path is "RoundedCube" )

With Callback

SaveManager.InstantiatePersistentWithCallback(
    "Prefabs/Enemy",
    spawnPos,
    Quaternion.identity,
    (spawnedObject) => 
    {
        // Object is ready
        // Run custom code here
    }
);

Requirements for Spawned Objects

Prefabs MUST have:

1. GlobalID component

2. Saveable component (optional but recommended)

How It Works

1. Spawn: OmniSave generates a unique ID and registers it

2. Save: Object data from Saveable saved

3. Load: OmniSave reinstantiates from prefab path and restores state

---