app.hypergames.hypersdk 1.4.19 → 1.4.20

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.4.20](https://github.com/mvmhyper/hyper-sdk/compare/v1.4.19...v1.4.20) (2026-01-12)
+
+
+### Bug Fixes
+
+* Add custom restart flow and improve default restart for async scenes ([72c6d78](https://github.com/mvmhyper/hyper-sdk/commit/72c6d781b485503b98acc028294015db3cf93474))
+
 ## [1.4.19](https://github.com/mvmhyper/hyper-sdk/compare/v1.4.18...v1.4.19) (2026-01-06)
 
 

package/Editor/Scripts/Inspectors/HyperSDKSettingsEditor.cs

@@ -110,6 +110,31 @@ namespace Hyper.Editor
                 EditorGUILayout.Space(-1f);
                 DrawPreviewImage();
 
+                // Draw Restart Flow Settings
+                EditorGUILayout.Space(12);
+                EditorGUILayout.LabelField("Restart Flow Settings", EditorStyles.boldLabel);
+
+                EditorGUILayout.BeginVertical(EditorStyles.helpBox);
+                {
+                    EditorGUILayout.LabelField(
+                        "Enable custom restart flow if your game has its own restart logic. " +
+                        "When enabled, SDK will fire OnCustomRestart event instead of using default restart.",
+                        EditorStyles.wordWrappedMiniLabel);
+                        
+                    // if (settings.useCustomRestartFlow)
+                    // {
+                    //     EditorGUILayout.Space(4);
+                    //     EditorGUILayout.HelpBox(
+                    //         "Custom restart enabled. Subscribe to HyperSDK.Event.OnCustomRestart in your game manager:\n" +
+                    //         "HyperSDK.Event.OnCustomRestart += YourRestartMethod;",
+                    //         MessageType.Info);
+                    // }
+                }
+                EditorGUILayout.EndVertical();
+                settings.useCustomRestartFlow = EditorGUILayout.Toggle(
+                        new GUIContent("Use Custom Restart Flow"),
+                        settings.useCustomRestartFlow);
+
                 EditorGUILayout.Space(12);
                 // Draw Editor Testing            
                 SerializedProperty settingsProp = serializedObject.FindProperty("_settings");

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -1,4 +1,6 @@
 using System;
+using System.Collections;
+using System.Collections.Generic;
 using UnityEngine;
 using UnityEngine.SceneManagement;
 using Hyper.Internal.Managers;
@@ -44,15 +46,90 @@ namespace Hyper.Internal
         ///
         /// This is the internal implementation used by both the public
         /// HyperSDK facade and internal UI flows (pause/game over modals).
+        ///
+        /// If useCustomRestartFlow is enabled in settings, fires OnCustomRestart event
+        /// instead of performing default restart. Otherwise, performs improved default
+        /// restart that properly unloads all scenes (including additive) before reloading.
         /// </summary>
         internal static void RestartSession()
         {
             _isSoftRestarting = true;
 
+            if (_settings != null && _settings.useCustomRestartFlow)
+            {
+                _eventManager?.InvokeCustomRestartEvent();
+                return;
+            }
+
+            // Use improved default restart flow
+            if (_host != null)
+            {
+                _host.StartCoroutine(RestartSessionCoroutine());
+            }
+            else
+            {
+                // Fallback to immediate restart if host doesn't exist
+                ClearAllDontDestroyOnLoadObjects();
+                SceneManager.LoadScene("HyperLoader");
+            }
+        }
+
+        /// <summary>
+        /// Coroutine-based restart that properly unloads all scenes before reloading.
+        /// Handles async scene operations and ensures clean state before restart.
+        /// </summary>
+        private static IEnumerator RestartSessionCoroutine()
+        {
+            yield return UnloadAllScenesCoroutine();
+
             ClearAllDontDestroyOnLoadObjects();
             SceneManager.LoadScene("HyperLoader");
         }
 
+        /// <summary>
+        /// Unloads all additive scenes. The active (single) scene will be replaced when HyperLoader loads.
+        /// Waits for all async unload operations to complete before proceeding.
+        /// </summary>
+        private static IEnumerator UnloadAllScenesCoroutine()
+        {
+            List<AsyncOperation> unloadOps = new List<AsyncOperation>();
+            Scene activeScene = SceneManager.GetActiveScene();
+
+            // Only unload additive scenes (not the active single scene)
+            for (int i = SceneManager.sceneCount - 1; i >= 0; i--)
+            {
+                Scene scene = SceneManager.GetSceneAt(i);
+
+                if (scene.name == "HyperLoader")
+                    continue;
+
+                if (scene == activeScene)
+                    continue;
+
+                // Only unload additive scenes that are loaded
+                if (scene.isLoaded)
+                {
+                    AsyncOperation unloadOp = SceneManager.UnloadSceneAsync(scene);
+                    if (unloadOp != null)
+                    {
+                        unloadOps.Add(unloadOp);
+                    }
+                }
+            }
+
+            // Wait for all unload operations to complete
+            foreach (AsyncOperation op in unloadOps)
+            {
+                while (op != null && !op.isDone)
+                {
+                    yield return null;
+                }
+            }
+
+            Resources.UnloadUnusedAssets();
+            yield return null;
+        }
+
         internal static void Initialize(Action callback)
         {
             ValidatePlatform();

package/Runtime/Internal/Managers/EventManager.cs

@@ -29,6 +29,7 @@ namespace Hyper.Internal.Managers
         public event Action OnGameEnded;
         public event Action OnLivesExhausted;
         public event Action OnHealthExhausted;
+        public event Action OnCustomRestart;
 
         #endregion
 
@@ -62,6 +63,7 @@ namespace Hyper.Internal.Managers
         internal void InvokeGameEndedEvent() => OnGameEnded?.Invoke();
         internal void InvokeLivesExhaustedEvent() => OnLivesExhausted?.Invoke();
         internal void InvokeHealthExhaustedEvent() => OnHealthExhausted?.Invoke();
+        internal void InvokeCustomRestartEvent() => OnCustomRestart?.Invoke();
         internal void InvokeConnectionLostEvent() => OnInternetConnectionLost?.Invoke();
         internal void InvokeConnectionFoundEvent() => OnInternetConnectionFound?.Invoke();
         internal void InvokeTutorialLoadingCompleteEvent() => OnTutorialLoadingComplete?.Invoke();

package/Runtime/Internal/ScriptableObjects/HyperSDKSettings.cs

@@ -54,6 +54,16 @@ namespace Hyper.Internal
 
         #endregion
 
+        #region Restart Flow Settings
+
+        [Space(20)]
+        [Header("Restart Flow Settings")]
+        [Tooltip("Enable custom restart flow. If enabled, SDK will fire OnCustomRestart event " +
+                 "instead of using default restart. Listen to HyperSDK.Event.OnCustomRestart in your game manager.")]
+        public bool useCustomRestartFlow = false;
+
+        #endregion
+
         #region Editor Testing
         [Header("Editor Simulation")]
         [Tooltip("Configuration settings for testing within the Unity Editor.")]

package/Runtime/Public/Core/HyperSDK.cs

@@ -178,6 +178,7 @@ namespace Hyper
         event Action<bool> OnSoundChanged;
         event Action OnLivesExhausted;
         event Action OnHealthExhausted;
+        event Action OnCustomRestart;
     }
 
     #region Adapter Implementations
@@ -248,6 +249,7 @@ namespace Hyper
         private Action<bool> _onSoundChanged;
         private Action _onLivesExhausted;
         private Action _onHealthExhausted;
+        private Action _onCustomRestart;
 
         private Action _gameStartBridge;
         private Action _timeUpBridge;
@@ -257,6 +259,7 @@ namespace Hyper
         private Action<bool> _soundChangedBridge;
         private Action _livesExhaustedBridge;
         private Action _healthExhaustedBridge;
+        private Action _customRestartBridge;
 
         public event Action OnGameStart
         {
@@ -338,6 +341,16 @@ namespace Hyper
             remove => _onHealthExhausted -= value;
         }
 
+        public event Action OnCustomRestart
+        {
+            add
+            {
+                _onCustomRestart += value;
+                RefreshBindings();
+            }
+            remove => _onCustomRestart -= value;
+        }
+
         internal void RefreshBindings()
         {
             var manager = HyperRuntime.EventManager;
@@ -366,6 +379,7 @@ namespace Hyper
             _soundChangedBridge = enabled => _onSoundChanged?.Invoke(enabled);
             _livesExhaustedBridge = () => _onLivesExhausted?.Invoke();
             _healthExhaustedBridge = () => _onHealthExhausted?.Invoke();
+            _customRestartBridge = () => _onCustomRestart?.Invoke();
 
             manager.OnGameStart += _gameStartBridge;
             manager.OnTimeUp += _timeUpBridge;
@@ -375,6 +389,7 @@ namespace Hyper
             manager.OnSoundChanged += _soundChangedBridge;
             manager.OnLivesExhausted += _livesExhaustedBridge;
             manager.OnHealthExhausted += _healthExhaustedBridge;
+            manager.OnCustomRestart += _customRestartBridge;
 
             _attachedManager = manager;
         }
@@ -394,6 +409,7 @@ namespace Hyper
             if (_soundChangedBridge != null) _attachedManager.OnSoundChanged -= _soundChangedBridge;
             if (_livesExhaustedBridge != null) _attachedManager.OnLivesExhausted -= _livesExhaustedBridge;
             if (_healthExhaustedBridge != null) _attachedManager.OnHealthExhausted -= _healthExhaustedBridge;
+            if (_customRestartBridge != null) _attachedManager.OnCustomRestart -= _customRestartBridge;
 
             _gameStartBridge = null;
             _timeUpBridge = null;
@@ -403,6 +419,7 @@ namespace Hyper
             _soundChangedBridge = null;
             _livesExhaustedBridge = null;
             _healthExhaustedBridge = null;
+            _customRestartBridge = null;
             _attachedManager = null;
         }
     }

package/Runtime/Resources/HyperSDKSettings.asset

@@ -19,6 +19,7 @@ MonoBehaviour:
   startCTA: 0
   controlBarLayout: 0
   controlBarTheme: 1
+  useCustomRestartFlow: 0
   _settings:
     GameMode: 0
     ShowInstructions: 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app.hypergames.hypersdk",
-  "version": "1.4.19",
+  "version": "1.4.20",
   "displayName": "HyperSDK",
   "description": "Official Unity SDK for Hyper: multiplayer battles, leaderboards, deterministic RNG, session management, tutorials, and WebGL optimizations for production-ready games.",
   "unity": "6000.0",