app.hypergames.hypersdk 1.11.3-beta.1 → 1.11.4

package/CHANGELOG.md

@@ -1,4 +1,12 @@
-## [1.11.3-beta.1](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.2...v1.11.3-beta.1) (2026-10-15)
+## [1.11.4](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.3...v1.11.4) (2026-10-16)
+
+
+### Bug Fixes
+
+* **sdk:** keep Play Again overlay until scene handoff ([baf5397](https://github.com/mvmhyper/hyper-sdk/commit/baf5397fa8f397cc06223f6943abf9baae114035))
+* **sdk:** remove tutorial modal when no tutorial exists ([e6c4f6a](https://github.com/mvmhyper/hyper-sdk/commit/e6c4f6a08e914c2e4b7cdd1488c71b8f2ff05a5c))
+
+## [1.11.3](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.2...v1.11.3) (2026-10-15)
 
 
 ### Bug Fixes

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -120,6 +120,7 @@ namespace Hyper.Internal
             }
             else
             {
+                _gameManager?.PreserveUIForSceneRestart();
                 ClearAllDontDestroyOnLoadObjects();
                 SceneManager.LoadScene("HyperLoader");
             }
@@ -215,6 +216,7 @@ namespace Hyper.Internal
             }
             else
             {
+                _gameManager?.PreserveUIForSceneRestart();
                 ClearAllDontDestroyOnLoadObjects();
                 SceneManager.LoadScene("HyperLoader");
             }
@@ -267,6 +269,9 @@ namespace Hyper.Internal
         /// </summary>
         private static IEnumerator RestartSessionCoroutine()
         {
+            _gameManager?.PreserveUIForSceneRestart();
+            // Render the disabled buttons and spinner before scene cleanup starts.
+            yield return null;
             yield return UnloadAllScenesCoroutine();
 
             Clear();

package/Runtime/Internal/Managers/GameManager.cs

@@ -74,6 +74,20 @@ namespace Hyper.Internal.Managers
             EndGame();
         }
 
+        internal void PreserveUIForSceneRestart()
+        {
+            if (_hyperCanvasObject == null) return;
+
+            // Keep the modal and shade until the game scene unloads, then let the
+            // scene destroy them before HyperLoader presents its own loading UI.
+            Scene activeScene = SceneManager.GetActiveScene();
+            if (_hyperCanvasObject.scene != activeScene)
+            {
+                SceneManager.MoveGameObjectToScene(_hyperCanvasObject, activeScene);
+            }
+            _hyperCanvasObject = null;
+        }
+
         internal void Cleanup()
         {
             StopAllCoroutines();
@@ -637,6 +651,8 @@ namespace Hyper.Internal.Managers
 
         internal void AddTutorialModal(bool showModal = false)
         {
+            if (_backendManager.tutorialDoesNotExist) return;
+
             bool isPortrait = ResolvePortraitFlag();
             var activeModal = EnsureTutorialModal(isPortrait);
             _tutorialModalComponent = activeModal.GetComponent<TutorialModal>();

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

@@ -23,11 +23,15 @@ namespace Hyper.Internal
         [SerializeField]
         private GameObject loadingBar;
         [SerializeField]
-        private GameObject loadingCircle;
+        [UnityEngine.Serialization.FormerlySerializedAs("loadingCircle")]
+        private GameObject exitLoadingCircle;
+        [SerializeField]
+        private GameObject playAgainLoadingCircle;
         private Slider loadingBarSlider;
         Coroutine sliderCoroutine;
 
         private GameManager _gameManager;
+        private bool _restartRequested;
 
         private void Awake()
         {
@@ -37,8 +41,10 @@ namespace Hyper.Internal
             if (loadingBarSlider != null)
                 loadingBarSlider.value = 0.075f;
 
-            if (loadingCircle != null)
-                loadingCircle.SetActive(false);
+            if (exitLoadingCircle != null)
+                exitLoadingCircle.SetActive(false);
+
+            SetPlayAgainLoading(false);
 
             _gameManager = HyperRuntime.GameManager;
 
@@ -103,6 +109,15 @@ namespace Hyper.Internal
 
         private void OnEnable()
         {
+            _restartRequested = false;
+            if (buttonHolder != null)
+            {
+                buttonHolder.interactable = true;
+                buttonHolder.alpha = 1f;
+            }
+            if (exitLoadingCircle != null) exitLoadingCircle.SetActive(false);
+            SetPlayAgainLoading(false);
+
             currentScore.text = HyperRuntime.DataManager.CurrentScore.ToString("N0");
             bestScore.text = HyperRuntime.DataManager.GetBestScore().ToString("N0");
         }
@@ -171,15 +186,40 @@ namespace Hyper.Internal
             buttonHolder.interactable = false;
             buttonHolder.alpha = 0.6f;
 
-            // Enable loading circle for exit action
-            loadingCircle.SetActive(true);
+            // Enable only the exit button's loading circle.
+            SetPlayAgainLoading(false);
+            exitLoadingCircle.SetActive(true);
 
             HyperRuntime.DataManager.MuteAudioForGameSessionEnd();
             HyperRuntime.BackendManager.LogEvent(ConsoleEventType.PracticeGameEnd);
         }
 
+        private void SetPlayAgainLoading(bool isLoading)
+        {
+            if (playAgainLoadingCircle == null) return;
+
+            playAgainLoadingCircle.SetActive(isLoading);
+            Transform button = playAgainLoadingCircle.transform.parent;
+            if (button != null)
+            {
+                TMP_Text label = button.GetComponentInChildren<TMP_Text>(true);
+                if (label != null) label.gameObject.SetActive(!isLoading);
+            }
+        }
+
         public void PlayAgain()
         {
+            if (_restartRequested) return;
+            _restartRequested = true;
+
+            if (buttonHolder != null)
+            {
+                buttonHolder.interactable = false;
+                buttonHolder.alpha = 0.6f;
+            }
+            if (exitLoadingCircle != null) exitLoadingCircle.SetActive(false);
+            SetPlayAgainLoading(true);
+
             HyperRuntime.RestartSession();
         }
 

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

@@ -26,7 +26,6 @@ namespace Hyper.Internal
             rectTransform = GetComponent<RectTransform>();
 
             _eventManager.OnTutorialLoadingComplete += HandleTutorialLoadingComplete;
-            _eventManager.OnTutorialDoesNotExist += HandleTutorialFailed;
             _eventManager.OnTutorialFetchFailed += HandleTutorialFailed;
         }
 
@@ -48,7 +47,6 @@ namespace Hyper.Internal
             {
                 _eventManager.OnTutorialLoadingComplete -= HandleTutorialLoadingComplete;
                 _eventManager.OnTutorialFetchFailed -= HandleTutorialFailed;
-                _eventManager.OnTutorialDoesNotExist -= HandleTutorialFailed;
             }
         }
 

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

@@ -108,6 +108,7 @@ namespace Hyper.Internal
 
             _eventManager.OnTutorialResourcesReferenced += ShowTutorialBasedOnType;
             _eventManager.OnTutorialLoadingComplete += HandleTutorialLoadingComplete;
+            _eventManager.OnTutorialDoesNotExist += HandleTutorialDoesNotExist;
         }
 
         void OnEnable()
@@ -1133,12 +1134,19 @@ namespace Hyper.Internal
             }
         }
 
+        private void HandleTutorialDoesNotExist()
+        {
+            gameObject.SetActive(false);
+            Destroy(gameObject);
+        }
+
         private void OnDestroy()
         {
             if (_eventManager == null) return;
 
             _eventManager.OnTutorialResourcesReferenced -= ShowTutorialBasedOnType;
             _eventManager.OnTutorialLoadingComplete -= HandleTutorialLoadingComplete;
+            _eventManager.OnTutorialDoesNotExist -= HandleTutorialDoesNotExist;
         }
 
         private void DisplayImage(int index)

package/Runtime/Resources/UIPrefabs/GameOverModal_Battle.prefab

@@ -254,7 +254,7 @@ MonoBehaviour:
   scoreSubmissionText: {fileID: 4314462782470164325}
   buttonHolder: {fileID: 0}
   loadingBar: {fileID: 7071240272076755227}
-  loadingCircle: {fileID: 0}
+  exitLoadingCircle: {fileID: 0}
 --- !u!114 &7863664679590643807
 MonoBehaviour:
   m_ObjectHideFlags: 0

package/Runtime/Resources/UIPrefabs/GameOverModal_Practice.prefab

@@ -193,7 +193,8 @@ MonoBehaviour:
   scoreSubmissionText: {fileID: 0}
   buttonHolder: {fileID: 1454075834828744570}
   loadingBar: {fileID: 0}
-  loadingCircle: {fileID: 4090140612718772822}
+  exitLoadingCircle: {fileID: 4090140612718772822}
+  playAgainLoadingCircle: {fileID: 700000000000000001}
 --- !u!114 &2358495542796786633
 MonoBehaviour:
   m_ObjectHideFlags: 0
@@ -1261,7 +1262,10 @@ PrefabInstance:
       objectReference: {fileID: 0}
     m_RemovedComponents: []
     m_RemovedGameObjects: []
-    m_AddedGameObjects: []
+    m_AddedGameObjects:
+    - targetCorrespondingSourceObject: {fileID: 446956918503945639, guid: 7196382af023e984dbe20e6bcdc9933c, type: 3}
+      insertIndex: -1
+      addedObject: {fileID: 700000000000000002}
     m_AddedComponents: []
   m_SourcePrefab: {fileID: 100100000, guid: 7196382af023e984dbe20e6bcdc9933c, type: 3}
 --- !u!224 &4567816188166193046 stripped
@@ -1455,3 +1459,114 @@ RectTransform:
   m_CorrespondingSourceObject: {fileID: 446956918503945639, guid: 51f1fa5ca88e94a4f8c654ed76e16c02, type: 3}
   m_PrefabInstance: {fileID: 6772588356203191674}
   m_PrefabAsset: {fileID: 0}
+--- !u!1 &700000000000000001
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 700000000000000002}
+  - component: {fileID: 700000000000000003}
+  - component: {fileID: 700000000000000004}
+  - component: {fileID: 700000000000000005}
+  - component: {fileID: 700000000000000006}
+  m_Layer: 5
+  m_Name: Play Again Loader
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 0
+--- !u!224 &700000000000000002
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 700000000000000001}
+  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 0.75, y: 0.75, z: 0.75}
+  m_ConstrainProportionsScale: 1
+  m_Children: []
+  m_Father: {fileID: 4567816188166193046}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0.5, y: 0.5}
+  m_AnchorMax: {x: 0.5, y: 0.5}
+  m_AnchoredPosition: {x: 0, y: 14}
+  m_SizeDelta: {x: 100, y: 100}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &700000000000000003
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 700000000000000001}
+  m_CullTransparentMesh: 1
+--- !u!114 &700000000000000004
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 700000000000000001}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
+  m_Name:
+  m_EditorClassIdentifier:
+  m_Material: {fileID: 0}
+  m_Color: {r: 1, g: 1, b: 1, a: 1}
+  m_RaycastTarget: 1
+  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Sprite: {fileID: 21300000, guid: 5c57961c662dfdd46a321974424c3f15, type: 3}
+  m_Type: 0
+  m_PreserveAspect: 1
+  m_FillCenter: 1
+  m_FillMethod: 4
+  m_FillAmount: 1
+  m_FillClockwise: 1
+  m_FillOrigin: 0
+  m_UseSpriteMesh: 0
+  m_PixelsPerUnitMultiplier: 1
+--- !u!95 &700000000000000005
+Animator:
+  serializedVersion: 7
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 700000000000000001}
+  m_Enabled: 1
+  m_Avatar: {fileID: 0}
+  m_Controller: {fileID: 9100000, guid: 3b038a3cf997e10408e5ae13866f375e, type: 2}
+  m_CullingMode: 0
+  m_UpdateMode: 0
+  m_ApplyRootMotion: 0
+  m_LinearVelocityBlending: 0
+  m_StabilizeFeet: 0
+  m_AnimatePhysics: 0
+  m_WarningMessage:
+  m_HasTransformHierarchy: 1
+  m_AllowConstantClipSamplingOptimization: 1
+  m_KeepAnimatorStateOnDisable: 0
+  m_WriteDefaultValuesOnDisable: 0
+--- !u!225 &700000000000000006
+CanvasGroup:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 700000000000000001}
+  m_Enabled: 1
+  m_Alpha: 1
+  m_Interactable: 1
+  m_BlocksRaycasts: 1
+  m_IgnoreParentGroups: 1

package/package.json

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