com.amanotes.prefabpool 2.0.3 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [2.1.0] - 2026-10-06
+
+### Added
+- `PrefabPool.ReleaseForSceneChange()` - lets a pool outlive the scene that used it: returns every checked-out instance to its pool and drops scene-bound spawn parents. Pooled instances stay alive; re-register the groups with the next scene's parents.
+
 ## [2.0.3] - 2026-09-24
 
 ### Added

package/Docs/PrefabPool-API.md

@@ -1,6 +1,6 @@
 # PrefabPool API Reference
 
-**Package:** `com.amanotes.prefabpool` | **Version:** 2.0.3 | **Namespace:** `Amanotes.Core`
+**Package:** `com.amanotes.prefabpool` | **Version:** 2.1.0 | **Namespace:** `Amanotes.Core`
 
 Generic object pooling system to eliminate garbage collection spikes from frequent instantiation/destruction.
 
@@ -370,3 +370,15 @@ var unknown = group.Get("unknown_id");
 ## See Also
 
 - [PrefabPool README](../README.md)
+
+---
+
+## Outliving a scene
+
+`PrefabPool.ReleaseForSceneChange()` lets a pool survive the scene that used it (for example a pool in `DontDestroyOnLoad`):
+
+- every checked-out instance is returned to its pool;
+- scene-bound spawn parents are dropped (`group.Register(pool, null)`);
+- pooled instances stay alive.
+
+Call `RegisterGroup(group, newSpawnParent)` again once the next scene's parent exists. No-op after `MarkShutdown()` / `DestroyPool()`.

package/README.md

@@ -1,7 +1,7 @@
 # PrefabPool
 
 **Package:** `com.amanotes.prefabpool`  
-**Version:** 2.0.3
+**Version:** 2.1.0
 
 Generic object pooling system for Unity with lifecycle callbacks and material pooling support.
 
@@ -30,7 +30,7 @@ Add the package to your Unity project via `Packages/manifest.json`:
 ```json
 {
   "dependencies": {
-    "com.amanotes.prefabpool": "2.0.3"
+    "com.amanotes.prefabpool": "2.1.0"
   },
   "scopedRegistries": [
     {

package/Runtime/PrefabPool.cs

@@ -1,7 +1,9 @@
 using System;
 using System.Collections;
 using System.Collections.Generic;
+#if UNITY_EDITOR
 using UnityEditor;
+#endif
 using UnityEngine;
 using UnityObject = UnityEngine.Object;
 
@@ -370,6 +372,29 @@ namespace Amanotes.Core
         public bool IsReady => _isReady;
         
         public void MarkShutdown() => _isDestroyed = true;
+
+        /// <summary>
+        /// Lets the pool outlive the scene that used it: returns every checked-out instance to its pool and drops
+        /// scene-bound spawn parents. Pooled instances stay alive; re-register the groups with the next scene's parents.
+        /// </summary>
+        public void ReleaseForSceneChange()
+        {
+            if (_isDestroyed) return;
+
+            var liveIds = new List<UnityObjectId>(_liveInstances.Keys);
+            for (var i = 0; i < liveIds.Count; i++)
+            {
+                var id = liveIds[i];
+                var go = _liveInstances[id];
+                if (go != null && _instanceTypeMap.TryGetValue(id, out var entry))
+                    entry.Return(go, transform);
+                _instanceTypeMap.Remove(id);
+                _liveInstances.Remove(id);
+            }
+
+            for (var i = 0; i < _groupOrder.Count; i++)
+                _groupOrder[i].Register(this, null);
+        }
         
         public void RegisterGroup(PoolGroup group, Transform spawnParent)
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.amanotes.prefabpool",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "displayName": "[Ama] Prefab Pool",
   "description": "Generic object pooling system for Unity",
   "unity": "2022.3",