app.hypergames.hypersdk 1.2.1 → 1.3.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.3.0](https://github.com/mvmhyper/hyper-sdk/compare/v1.2.2...v1.3.0) (2025-11-26)
+
+
+### Features
+
+* Soft restart lifecycle management and build index automation ([4426307](https://github.com/mvmhyper/hyper-sdk/commit/44263076306a4d0ec1b84a053123f34a164450de))
+
+## [1.2.2](https://github.com/mvmhyper/hyper-sdk/compare/v1.2.1...v1.2.2) (2025-11-26)
+
+
+### Bug Fixes
+
+* auto-manage HyperLoader scene and constants ([050567a](https://github.com/mvmhyper/hyper-sdk/commit/050567a44c0d78b4eed9ae31b19ba1fcbd8a986f))
+
 ## [1.2.1](https://github.com/mvmhyper/hyper-sdk/compare/v1.2.0...v1.2.1) (2025-11-26)
 
 

package/Editor/Scripts/Tools/HyperBuildAssistant.cs

@@ -4,6 +4,7 @@ using UnityEditor;
 using System;
 using System.Collections.Generic;
 using System.Globalization;
+using System.IO;
 using System.Linq;
 using UnityEditor.Build;
 using UnityEditor.Build.Reporting;
@@ -1010,61 +1011,25 @@ namespace Hyper.Editor
                     break;
 
                 case SettingType.HyperLoaderSceneIndex:
-                    try
                     {
-                        var scenes = new List<EditorBuildSettingsScene>(EditorBuildSettings.scenes);
-                        int hyperLoaderIndex = -1;
-
-                        for (int i = 0; i < scenes.Count; i++)
+                        if (TryEnsureSceneAtIndex(HyperConstants.HYPER_LOADER_SCENE_PATH, 0, out var sceneError))
                         {
-                            if (scenes[i].path.Contains("HyperLoader") ||
-                                scenes[i].path.EndsWith("HyperLoader.unity", System.StringComparison.OrdinalIgnoreCase))
-                            {
-                                hyperLoaderIndex = i;
-                                break;
-                            }
+                            if (IsSDKDeveloper()) HyperDebug.LogSuccess("Applied: HyperLoader scene moved to build index 0");
                         }
-
-                        if (hyperLoaderIndex == -1)
+                        else
                         {
                             EditorUtility.DisplayDialog(
                                 "HyperLoader Scene Not Found",
-                                "HyperLoader scene not found in Build Settings.\n\n" +
-                                "Please add it manually:\n" +
-                                "1. File > Build Settings\n" +
-                                "2. Add Open Scenes or drag HyperLoader.unity\n" +
-                                "3. Move it to index 0",
+                                $"Could not locate the HyperLoader scene at:\n{HyperConstants.HYPER_LOADER_SCENE_PATH}\n\n" +
+                                "Please ensure the SDK is installed and the scene exists, then run this fix again.",
                                 "OK"
                             );
-                            HyperDebug.LogWarning("HyperLoader scene not found in Build Settings");
-                        }
-                        else if (hyperLoaderIndex == 0)
-                        {
-                            if (IsSDKDeveloper()) HyperDebug.Log("HyperLoader is already at index 0");
-                        }
-                        else
-                        {
-                            var hyperLoaderScene = scenes[hyperLoaderIndex];
-                            scenes.RemoveAt(hyperLoaderIndex);
-                            scenes.Insert(0, hyperLoaderScene);
-                            hyperLoaderScene.enabled = true;
-
-                            EditorBuildSettings.scenes = scenes.ToArray();
-                            if (IsSDKDeveloper()) HyperDebug.LogSuccess($"Applied: Moved HyperLoader scene to build index 0 (was at index {hyperLoaderIndex})");
+                            if (!string.IsNullOrEmpty(sceneError))
+                            {
+                                HyperDebug.LogWarning(sceneError);
+                            }
                         }
                     }
-                    catch (System.Exception e)
-                    {
-                        EditorUtility.DisplayDialog(
-                            "Build Settings Error",
-                            "Could not automatically move HyperLoader to index 0.\n\n" +
-                            "Please manually set it in:\n" +
-                            "File > Build Settings\n\n" +
-                            "Move HyperLoader scene to index 0",
-                            "OK"
-                        );
-                        HyperDebug.LogWarning($"Could not move HyperLoader scene: {e.Message}");
-                    }
                     break;
 
                 case SettingType.ColorSpace:
@@ -1466,6 +1431,39 @@ namespace Hyper.Editor
             return $"{len:0.##} {sizes[order]}";
         }
 
+        #endregion
+
+        #region Build Settings Helpers
+
+        private static bool TryEnsureSceneAtIndex(string scenePath, int targetIndex, out string errorMessage)
+        {
+            errorMessage = null;
+
+            if (string.IsNullOrEmpty(scenePath))
+            {
+                errorMessage = "Scene path is null or empty.";
+                return false;
+            }
+
+            if (!File.Exists(scenePath))
+            {
+                errorMessage = $"Scene not found at path: {scenePath}";
+                return false;
+            }
+
+            var scenes = new List<EditorBuildSettingsScene>(EditorBuildSettings.scenes);
+            scenes.RemoveAll(s => string.Equals(s.path, scenePath, StringComparison.OrdinalIgnoreCase));
+
+            targetIndex = Mathf.Clamp(targetIndex, 0, scenes.Count);
+
+            var newScene = new EditorBuildSettingsScene(scenePath, true);
+            scenes.Insert(targetIndex, newScene);
+
+            EditorBuildSettings.scenes = scenes.ToArray();
+            return true;
+        }
+
+
         private static string FormatBuildTime(System.DateTime buildTime)
         {
             System.TimeSpan timeSince = System.DateTime.Now - buildTime;
@@ -2168,7 +2166,7 @@ namespace Hyper.Editor
         /// </summary>
         private static void ForceAssetRepack()
         {
-            const string hyperLoaderScenePath = "Assets/HyperSDK/HyperLoader.unity";
+                const string hyperLoaderScenePath = HyperConstants.HYPER_LOADER_SCENE_PATH;
             const string markerPrefix = "__HyperSDK_BuildMarker";
             if (IsSDKDeveloper()) HyperDebug.Log("ForceAssetRepack() called");
 

package/Editor/Scripts/Utils/HyperSceneReferenceDrawer.cs

@@ -2,6 +2,7 @@
 using UnityEditor;
 using UnityEngine;
 using Hyper.Shared;
+using Hyper.Internal;
 
 namespace Hyper.Editor
 {
@@ -58,6 +59,9 @@ namespace Hyper.Editor
                     guidProperty.stringValue = newGUID;
                     pathProperty.stringValue = newPath;
                     nameProperty.stringValue = newName;
+
+                    // Automatically add scene to build index if not already present
+                    EnsureSceneInBuildIndex(newPath, newName);
                 }
                 else
                 {
@@ -69,6 +73,39 @@ namespace Hyper.Editor
 
             EditorGUI.EndProperty();
         }
+
+        /// <summary>
+        /// Ensures the scene is added to the build index if it's not already present.
+        /// </summary>
+        private void EnsureSceneInBuildIndex(string scenePath, string sceneName)
+        {
+            if (string.IsNullOrEmpty(scenePath))
+                return;
+
+            // Check if scene is already in build index
+            var buildScenes = EditorBuildSettings.scenes;
+            bool isInBuildIndex = false;
+
+            for (int i = 0; i < buildScenes.Length; i++)
+            {
+                if (buildScenes[i].path == scenePath)
+                {
+                    isInBuildIndex = true;
+                    break;
+                }
+            }
+
+            // Add to build index if not present
+            if (!isInBuildIndex)
+            {
+                var newScenes = new EditorBuildSettingsScene[buildScenes.Length + 1];
+                System.Array.Copy(buildScenes, newScenes, buildScenes.Length);
+                newScenes[buildScenes.Length] = new EditorBuildSettingsScene(scenePath, true);
+                EditorBuildSettings.scenes = newScenes;
+
+                HyperDebug.LogSuccess($"Automatically added scene '{sceneName}' to Build Settings.");
+            }
+        }
     }
 }
 #endif

package/HyperLoader.unity

@@ -305,7 +305,7 @@ RectTransform:
   m_AnchorMin: {x: 0, y: 1}
   m_AnchorMax: {x: 0, y: 1}
   m_AnchoredPosition: {x: 489.20746, y: -280.1698}
-  m_SizeDelta: {x: 1044.9, y: 239.347}
+  m_SizeDelta: {x: 0, y: 239.347}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!114 &751153944
 MonoBehaviour:
@@ -1840,7 +1840,7 @@ MonoBehaviour:
   m_MinValue: 0
   m_MaxValue: 1
   m_WholeNumbers: 0
-  m_Value: 0.227
+  m_Value: 0.065
   m_OnValueChanged:
     m_PersistentCalls:
       m_Calls: []

package/Runtime/Internal/Bootstrap/HyperLoader.cs

@@ -46,6 +46,11 @@ namespace Hyper.Internal
 
         private void Awake()
         {
+            // Entering a freshly loaded HyperLoader scene always ends any previous
+            // soft-restart window. From this point onward, teardown code should treat
+            // object destruction as part of a normal lifecycle again.
+            HyperRuntime.IsSoftRestarting = false;
+
             HyperRuntime.Clear();
 
             InitializeComponents();

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -1,5 +1,6 @@
 using System;
 using UnityEngine;
+using UnityEngine.SceneManagement;
 using Hyper.Internal.Managers;
 
 namespace Hyper.Internal
@@ -15,6 +16,7 @@ namespace Hyper.Internal
         private static GameObject _singletonObject;
 
         private static bool _isInitialized;
+        private static bool _isSoftRestarting;
         private static HyperSDKSettings _settings;
         private static HyperGameContentConfig _gameContent;
         private static GameManager _gameManager;
@@ -24,6 +26,11 @@ namespace Hyper.Internal
         private static TimerManager _timerManager;
 
         internal static bool IsInitialized => _isInitialized;
+        internal static bool IsSoftRestarting
+        {
+            get => _isSoftRestarting;
+            set => _isSoftRestarting = value;
+        }
         internal static HyperSDKSettings Settings => _settings;
         internal static HyperGameContentConfig GameContent => _gameContent;
         internal static GameManager GameManager => _gameManager;
@@ -32,6 +39,20 @@ namespace Hyper.Internal
         internal static EventManager EventManager => _eventManager;
         internal static TimerManager Timer => _timerManager;
 
+        /// <summary>
+        /// Perform a full soft restart of the Hyper session.
+        ///
+        /// This is the internal implementation used by both the public
+        /// HyperSDK facade and internal UI flows (pause/game over modals).
+        /// </summary>
+        internal static void RestartSession()
+        {
+            _isSoftRestarting = true;
+
+            ClearAllDontDestroyOnLoadObjects();
+            SceneManager.LoadScene("HyperLoader");
+        }
+
         internal static void Initialize(Action callback)
         {
             ValidatePlatform();
@@ -141,10 +162,28 @@ namespace Hyper.Internal
 
             _host = null;
             _isInitialized = false;
+            _isSoftRestarting = false;
 
             HyperDebug.Log("Cleared and reset");
         }
 
+        /// <summary>
+        /// Clears all root objects residing in the DontDestroyOnLoad scene.
+        /// Intended to be used as part of a controlled soft restart flow.
+        /// </summary>
+        private static void ClearAllDontDestroyOnLoadObjects()
+        {
+            var allObjects = Resources.FindObjectsOfTypeAll<GameObject>();
+
+            foreach (var obj in allObjects)
+            {
+                if (obj.scene.name == "DontDestroyOnLoad" && obj.transform.parent == null)
+                {
+                    UnityEngine.Object.Destroy(obj);
+                }
+            }
+        }
+
         internal static void OnHostDestroyed(HyperRuntimeHost host)
         {
             if (_host != host) return;
@@ -163,6 +202,7 @@ namespace Hyper.Internal
             _dataManager = null;
             _gameContent = null;
             _isInitialized = false;
+            _isSoftRestarting = false;
         }
     }
 }

package/Runtime/Internal/UI/Modals/GameOverModal.cs

@@ -1,7 +1,6 @@
 using System.Collections;
 using TMPro;
 using UnityEngine;
-using UnityEngine.SceneManagement;
 using UnityEngine.UI;
 using System.Runtime.InteropServices;
 using Hyper.Internal.Managers;
@@ -86,7 +85,7 @@ namespace Hyper.Internal
 
             while (elapsedTime < duration)
             {
-                elapsedTime += Time.deltaTime;
+                elapsedTime += Time.unscaledDeltaTime;
                 loadingBarSlider.value = Mathf.Lerp(startValue, targetValue, elapsedTime / duration);
                 yield return null;
             }
@@ -168,26 +167,7 @@ namespace Hyper.Internal
 
         public void PlayAgain()
         {
-            FullGameRestart();
-        }
-
-        private void FullGameRestart()
-        {
-            ClearAllDDOLObjects();
-            SceneManager.LoadScene("HyperLoader");
-        }
-
-        private void ClearAllDDOLObjects()
-        {
-            GameObject[] allObjects = Resources.FindObjectsOfTypeAll<GameObject>();
-
-            foreach (GameObject obj in allObjects)
-            {
-                if (obj.scene.name == "DontDestroyOnLoad" && obj.transform.parent == null)
-                {
-                    Destroy(obj);
-                }
-            }
+            HyperRuntime.RestartSession();
         }
 
     }

package/Runtime/Internal/UI/Modals/GamePausedModal.cs

@@ -1,6 +1,5 @@
 using TMPro;
 using UnityEngine;
-using UnityEngine.SceneManagement;
 using UnityEngine.UI;
 using System.Runtime.InteropServices;
 using Hyper.Internal.Managers;
@@ -120,7 +119,7 @@ namespace Hyper.Internal
         {
             _dataManager.SetSound(_dataManager.GetSound() == 1 ? 0 : 1);
             soundIcon.sprite = _dataManager.GetSound() == 1 ? soundIconOn : soundIconOff;
-            soundText.text = _dataManager.GetSound() == 1 ? "Sound ON" : "Sound OFF";
+            soundText.text = _dataManager.GetSound() == 1 ? "Sound On" : "Sound Off";
         }
 
         public void ShowTutorial()
@@ -136,22 +135,7 @@ namespace Hyper.Internal
 
         public void RestartGame()
         {
-            ClearAllDDOLObjects();
-            SceneManager.LoadScene("HyperLoader");
-        }
-
-        private void ClearAllDDOLObjects()
-        {
-            GameObject[] allObjects = Resources.FindObjectsOfTypeAll<GameObject>();
-
-            foreach (GameObject obj in allObjects)
-            {
-                if (obj.scene.name == "DontDestroyOnLoad" && obj.transform.parent == null)
-                {
-                    Debug.Log($"Destroying DDOL object: {obj.name}");
-                    Destroy(obj);
-                }
-            }
+            HyperRuntime.RestartSession();
         }
     }
 }

package/Runtime/Internal/Utils/HyperConstants.cs

@@ -37,6 +37,7 @@ namespace Hyper.Internal
         public const string SETTINGS_ASSET_PATH = "Assets/HyperSDK/Runtime/Resources/HyperSDKSettings.asset";
         public const string GAME_CONTENT_ASSET_PATH = "Assets/HyperSDK/Runtime/Resources/HyperGameContentConfig.asset";
         public const string RESOURCES_FOLDER_PATH = "Assets/HyperSDK/Runtime/Resources";
+        public const string HYPER_LOADER_SCENE_PATH = "Assets/HyperSDK/HyperLoader.unity";
         
         /// <summary>
         /// Returns the banner texture path, checking dev mode (Assets/) first, then package mode (Packages/).

package/Runtime/Public/Core/HyperSDK.cs

@@ -1,5 +1,6 @@
 using System;
 using UnityEngine;
+using UnityEngine.SceneManagement;
 using Hyper.Internal;
 using Hyper.Internal.Managers;
 
@@ -20,6 +21,23 @@ namespace Hyper
         /// </summary>
         public static bool IsInitialized => HyperRuntime.IsInitialized;
 
+        /// <summary>
+        /// Indicates that Hyper is currently performing a soft restart.
+        /// 
+        /// This is only true during the teardown/transition between sessions
+        /// when DontDestroyOnLoad objects are being cleared and the HyperLoader
+        /// scene is being (re)loaded. Once the new loader starts, this flag is reset.
+        /// 
+        /// Intended usage:
+        /// - Distinguish soft restart vs real quit in teardown logic
+        ///   (e.g. singleton OnDestroy guards) to avoid false positives.
+        /// </summary>
+        public static bool IsSoftRestarting
+        {
+            get => HyperRuntime.IsSoftRestarting;
+            internal set => HyperRuntime.IsSoftRestarting = value;
+        }
+
         /// <summary>
         /// Initialize the Hyper SDK. Must be called before accessing other APIs.
         /// </summary>
@@ -95,6 +113,7 @@ namespace Hyper
 
             _eventAdapter.RefreshBindings();
         }
+
     }
 
     /// <summary>

package/Runtime/Resources/UIPrefabs/GameOverModal_Battle.prefab

@@ -462,7 +462,7 @@ RectTransform:
   m_AnchorMin: {x: 0.5, y: 0.5}
   m_AnchorMax: {x: 0.5, y: 0.5}
   m_AnchoredPosition: {x: 0, y: 0}
-  m_SizeDelta: {x: 2.5, y: 113.3299}
+  m_SizeDelta: {x: 3, y: 113.3299}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &3311437449879540859
 CanvasRenderer:

package/Runtime/Resources/UIPrefabs/GameOverModal_Practice.prefab

@@ -36,7 +36,7 @@ RectTransform:
   m_AnchorMin: {x: 0.5, y: 0.5}
   m_AnchorMax: {x: 0.5, y: 0.5}
   m_AnchoredPosition: {x: 0, y: 0}
-  m_SizeDelta: {x: 2.5, y: 113.3299}
+  m_SizeDelta: {x: 3, y: 113.3299}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &6183820688932751126
 CanvasRenderer:

package/Runtime/Resources/UIPrefabs/GamePausedModal_Battle.prefab

@@ -603,7 +603,7 @@ RectTransform:
   m_AnchorMin: {x: 0.5, y: 0.5}
   m_AnchorMax: {x: 0.5, y: 0.5}
   m_AnchoredPosition: {x: 0, y: 0}
-  m_SizeDelta: {x: 2.5, y: 113.3299}
+  m_SizeDelta: {x: 3, y: 113.3299}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &7271924545119143605
 CanvasRenderer:

package/Runtime/Resources/UIPrefabs/Scores Frame.prefab

@@ -36,7 +36,7 @@ RectTransform:
   m_AnchorMin: {x: 0.5, y: 0.5}
   m_AnchorMax: {x: 0.5, y: 0.5}
   m_AnchoredPosition: {x: 0, y: 0}
-  m_SizeDelta: {x: 2.5, y: 113.3299}
+  m_SizeDelta: {x: 3, y: 113.3299}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &533477767077768701
 CanvasRenderer:
@@ -270,7 +270,7 @@ MonoBehaviour:
   m_text: FINAL SCORE
   m_isRightToLeft: 0
   m_fontAsset: {fileID: 11400000, guid: b61cc31493416594290d3793968a7776, type: 2}
-  m_sharedMaterial: {fileID: 392085163434936357, guid: b61cc31493416594290d3793968a7776, type: 2}
+  m_sharedMaterial: {fileID: -6106472849309118677, guid: b61cc31493416594290d3793968a7776, type: 2}
   m_fontSharedMaterials: []
   m_fontMaterial: {fileID: 0}
   m_fontMaterials: []
@@ -408,7 +408,7 @@ MonoBehaviour:
   m_text: LAST SUBMITTED
   m_isRightToLeft: 0
   m_fontAsset: {fileID: 11400000, guid: b61cc31493416594290d3793968a7776, type: 2}
-  m_sharedMaterial: {fileID: 392085163434936357, guid: b61cc31493416594290d3793968a7776, type: 2}
+  m_sharedMaterial: {fileID: -6106472849309118677, guid: b61cc31493416594290d3793968a7776, type: 2}
   m_fontSharedMaterials: []
   m_fontMaterial: {fileID: 0}
   m_fontMaterials: []
@@ -556,7 +556,7 @@ MonoBehaviour:
   m_text: 10,200
   m_isRightToLeft: 0
   m_fontAsset: {fileID: 11400000, guid: 39c484b4a22288c488625a88b6da2145, type: 2}
-  m_sharedMaterial: {fileID: 2121445518252921147, guid: 39c484b4a22288c488625a88b6da2145, type: 2}
+  m_sharedMaterial: {fileID: -8342687123090027242, guid: 39c484b4a22288c488625a88b6da2145, type: 2}
   m_fontSharedMaterials: []
   m_fontMaterial: {fileID: 0}
   m_fontMaterials: []
@@ -692,7 +692,7 @@ MonoBehaviour:
   m_text: 10,000
   m_isRightToLeft: 0
   m_fontAsset: {fileID: 11400000, guid: 39c484b4a22288c488625a88b6da2145, type: 2}
-  m_sharedMaterial: {fileID: 2121445518252921147, guid: 39c484b4a22288c488625a88b6da2145, type: 2}
+  m_sharedMaterial: {fileID: -8342687123090027242, guid: 39c484b4a22288c488625a88b6da2145, type: 2}
   m_fontSharedMaterials: []
   m_fontMaterial: {fileID: 0}
   m_fontMaterials: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app.hypergames.hypersdk",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "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",