app.hypergames.hypersdk 1.8.15 → 1.8.16

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [1.8.16](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.15...v1.8.16) (2026-06-11)
+
+
+### Bug Fixes
+
+* **loader:** expose custom loading start hook ([acdec3a](https://github.com/mvmhyper/hyper-sdk/commit/acdec3a1c484a1b476690f3ac5ca8e38877915a6))
+* **safe-area:** add ignore safe area component + upm sync ([9c1ea51](https://github.com/mvmhyper/hyper-sdk/commit/9c1ea5165c7b5bb4e97396ff0e7d375db52a1041))
+* **ui:** improve HyperCanvas landscape layout ([2a3ba8c](https://github.com/mvmhyper/hyper-sdk/commit/2a3ba8c2fa753bc5ab13934c49ba0dee0571814d))
+
 ## [1.8.15](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.14...v1.8.15) (2026-06-04)
 
 

package/Editor/Scripts/Build/HyperBuildPipeline.cs

@@ -727,7 +727,7 @@ namespace Hyper.Editor
             return true;
         }
 
-        private static bool ValidateConfigurationAssets(HyperBuildProfile profile)
+        internal static bool ValidateConfigurationAssets(HyperBuildProfile profile)
         {
             if (!LoadConfigurationAssets())
             {

package/HyperLoader.unity

@@ -304,7 +304,7 @@ RectTransform:
   m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
   m_AnchorMin: {x: 0, y: 1}
   m_AnchorMax: {x: 0, y: 1}
-  m_AnchoredPosition: {x: 489.20746, y: -280.1698}
+  m_AnchoredPosition: {x: 1059.0492, y: -280.1698}
   m_SizeDelta: {x: 1044.9, y: 239.347}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!114 &751153944
@@ -1092,7 +1092,7 @@ RectTransform:
   m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
   m_AnchorMin: {x: 0, y: 1}
   m_AnchorMax: {x: 0, y: 1}
-  m_AnchoredPosition: {x: 489.20746, y: -133.2274}
+  m_AnchoredPosition: {x: 1059.0492, y: -133.2274}
   m_SizeDelta: {x: 875, y: 54.5378}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!1 &2874543288936963705

package/Runtime/Internal/Bootstrap/HyperLoader.cs

@@ -343,14 +343,12 @@ namespace Hyper.Internal
 
         private IEnumerator WaitForCustomPreLoading()
         {
-            HyperRuntime.CustomLoadingComplete = false;
-            HyperRuntime.CustomLoadingProgress = 0f;
-
             float simulatedProgress = 0f;
             const float simulatedSpeed = 0.15f;
             const float simulatedCap = 0.70f;
 
             HyperDebug.Log("Custom pre-loading enabled. Waiting for HyperSDK.Loader.CompleteCustomLoading()");
+            HyperRuntime.BeginCustomLoading();
 
             while (!HyperRuntime.CustomLoadingComplete)
             {
@@ -371,6 +369,7 @@ namespace Hyper.Internal
             // Snap to end of custom loading range
             _bootstrapProgress = _progressAfterCustomLoad;
             _loadingBarSlider.value = _bootstrapProgress;
+            HyperRuntime.EndCustomLoading();
         }
 
         private long GetRandomSeed()

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -20,7 +20,9 @@ namespace Hyper.Internal
         private static bool _isInitialized;
         private static bool _isSoftRestarting;
         private static bool _customLoadingComplete;
+        private static bool _customLoadingActive;
         private static float _customLoadingProgress;
+        private static Action _customLoadingStarted;
         private static HyperSDKSettings _settings;
         private static HyperGameContentConfig _gameContent;
         private static GameManager _gameManager;
@@ -40,6 +42,7 @@ namespace Hyper.Internal
             get => _customLoadingComplete;
             set => _customLoadingComplete = value;
         }
+        internal static bool CustomLoadingActive => _customLoadingActive;
         internal static float CustomLoadingProgress
         {
             get => _customLoadingProgress;
@@ -53,6 +56,31 @@ namespace Hyper.Internal
         internal static EventManager EventManager => _eventManager;
         internal static TimerManager Timer => _timerManager;
 
+        internal static event Action CustomLoadingStarted
+        {
+            add => _customLoadingStarted += value;
+            remove => _customLoadingStarted -= value;
+        }
+
+        internal static void BeginCustomLoading()
+        {
+            _customLoadingComplete = false;
+            _customLoadingProgress = 0f;
+            _customLoadingActive = true;
+            _customLoadingStarted?.Invoke();
+        }
+
+        internal static void CompleteCustomLoading()
+        {
+            _customLoadingComplete = true;
+            _customLoadingActive = false;
+        }
+
+        internal static void EndCustomLoading()
+        {
+            _customLoadingActive = false;
+        }
+
         /// <summary>
         /// Perform a full soft restart of the Hyper session.
         ///
@@ -309,6 +337,7 @@ namespace Hyper.Internal
             HyperRandom.Clear();
             _gameContent = null;
             _customLoadingComplete = false;
+            _customLoadingActive = false;
             _customLoadingProgress = 0f;
 
             if (_singletonObject != null)
@@ -359,6 +388,7 @@ namespace Hyper.Internal
             _gameContent = null;
             _isInitialized = false;
             _customLoadingComplete = false;
+            _customLoadingActive = false;
             _customLoadingProgress = 0f;
         }
     }

package/Runtime/Internal/Managers/BackendManager.cs

@@ -3,6 +3,7 @@ using Newtonsoft.Json.Linq;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Linq;
 using System.Globalization;
 using System.Runtime.InteropServices;
 using System.Text;
@@ -10,7 +11,6 @@ using UnityEngine;
 using UnityEngine.Networking;
 using Hyper.Internal;
 using Hyper.Shared;
-using System.Linq;
 
 namespace Hyper.Internal.Managers
 {

package/Runtime/Internal/Managers/GameManager.cs

@@ -1002,16 +1002,18 @@ namespace Hyper.Internal.Managers
             _canvasScaler = _canvas.GetComponent<CanvasScaler>();
             _canvasScaler.uiScaleMode = CanvasScaler.ScaleMode.ScaleWithScreenSize;
             _canvasScaler.referenceResolution = new Vector2(1080, 1920);
-            _canvasScaler.matchWidthOrHeight = IsPortrait() ? 0.43f : 0.63f;
+            _canvasScaler.matchWidthOrHeight = IsPortrait() ? 0.43f : 0.593f;
 
-            CreateSafeArea();
-            CreateBlockerUI();
+            CreateHyperCanvasSafeArea();
+            CreateHyperCanvasBlockerUI();
         }
 
-        private void CreateSafeArea()
+        private void CreateHyperCanvasSafeArea()
         {
             _safeArea = new GameObject("SafeArea", typeof(RectTransform));
             RectTransform safeAreaRect = _safeArea.GetComponent<RectTransform>();
+
+            //? Attaching safe area to HyperCanvas
             safeAreaRect.SetParent(_canvas.transform, false);
 
             safeAreaRect.anchorMin = Vector2.zero;
@@ -1019,10 +1021,13 @@ namespace Hyper.Internal.Managers
             safeAreaRect.offsetMin = Vector2.zero;
             safeAreaRect.offsetMax = Vector2.zero;
 
-            _safeArea.AddComponent<SafeArea>();
+            if (IsPortrait())
+            {
+                _safeArea.AddComponent<SafeArea>();
+            }
         }
 
-        private void CreateBlockerUI()
+        private void CreateHyperCanvasBlockerUI()
         {
             _blockerUI = new GameObject("BlockerUI",
                 typeof(RectTransform), typeof(CanvasRenderer), typeof(Image));
@@ -1396,7 +1401,7 @@ namespace Hyper.Internal.Managers
         private void ShowTimeUpModalInternal()
         {
             _hasGameEnded = true;
-            
+
             if (_timeUpModal == null)
             {
                 EnsureTimeUpModal();

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

@@ -41,13 +41,19 @@ namespace Hyper.Internal
                 loadingCircle.SetActive(false);
 
             _gameManager = HyperRuntime.GameManager;
+
+            if (!_gameManager.IsPortrait()) // If landscape, position Y-50 + scale 1.2f
+            {
+                GetComponent<RectTransform>().anchoredPosition = new Vector2(0, -50);
+                GetComponent<RectTransform>().localScale = new Vector3(1.2f, 1.2f, 1.2f);
+            }
         }
 
         public void Init()
         {
             if (scoreSubmissionText != null)
                 scoreSubmissionText.text = "Submitting score";
-                
+
             if (loadingBarSlider != null)
                 loadingBarSlider.value = 0.075f;
 
@@ -56,7 +62,7 @@ namespace Hyper.Internal
 
         public void StartLerpingSlider(float targetValue, float duration)
         {
-            if(loadingBarSlider == null)
+            if (loadingBarSlider == null)
             {
                 return;
             }
@@ -65,7 +71,7 @@ namespace Hyper.Internal
             {
                 StopCoroutine(sliderCoroutine);
             }
-            
+
             sliderCoroutine = StartCoroutine(LerpSlider(targetValue, duration));
         }
 
@@ -113,7 +119,7 @@ namespace Hyper.Internal
             // and we're just loading to completion
             if (scoreSubmissionText != null)
                 scoreSubmissionText.text = "Submitting score";
-            
+
             StopLerpingSlider();
             StartCoroutine(SetLoadingBarComplete());
         }

package/Runtime/Public/Core/HyperSDK.cs

@@ -303,6 +303,17 @@ namespace Hyper
     /// </summary>
     public interface ILoaderAPI
     {
+        /// <summary>
+        /// True while the HyperLoader is waiting for custom pre-loading to finish.
+        /// </summary>
+        bool IsCustomLoadingActive { get; }
+
+        /// <summary>
+        /// Fired after SDK/bootstrap setup is ready and custom pre-loading may begin.
+        /// If subscribed while custom loading is already active, the handler is invoked immediately.
+        /// </summary>
+        event Action OnCustomLoadingStarted;
+
         /// <summary>
         /// Report progress of your custom loading (0.0 to 1.0).
         /// This feeds into the loading bar so players see smooth progress during your custom work.
@@ -385,6 +396,29 @@ namespace Hyper
     /// </summary>
     internal sealed class LoaderAPIAdapter : ILoaderAPI
     {
+        private Action _onCustomLoadingStarted;
+
+        public LoaderAPIAdapter()
+        {
+            HyperRuntime.CustomLoadingStarted += HandleCustomLoadingStarted;
+        }
+
+        public bool IsCustomLoadingActive => HyperRuntime.CustomLoadingActive;
+
+        public event Action OnCustomLoadingStarted
+        {
+            add
+            {
+                _onCustomLoadingStarted += value;
+
+                if (HyperRuntime.CustomLoadingActive)
+                {
+                    value?.Invoke();
+                }
+            }
+            remove => _onCustomLoadingStarted -= value;
+        }
+
         public void ReportCustomLoadingProgress(float progress)
         {
             HyperRuntime.CustomLoadingProgress = Mathf.Clamp01(progress);
@@ -392,9 +426,14 @@ namespace Hyper
 
         public void CompleteCustomLoading()
         {
-            HyperRuntime.CustomLoadingComplete = true;
+            HyperRuntime.CompleteCustomLoading();
             HyperDebug.Log("Custom pre-loading complete. Bootstrap resuming");
         }
+
+        private void HandleCustomLoadingStarted()
+        {
+            _onCustomLoadingStarted?.Invoke();
+        }
     }
 
     /// <summary>

package/Runtime/Public/IgnoreSafeArea.cs

@@ -0,0 +1,56 @@
+using UnityEngine;
+
+namespace Hyper
+{
+    /// <summary>
+    /// Allows a UI element to render outside the SDK safe area.
+    /// Useful for full-screen canvas backgrounds that should extend behind notches or insets.
+    /// </summary>
+    [AddComponentMenu("Hyper/Ignore Safe Area")]
+    [DisallowMultipleComponent]
+    [RequireComponent(typeof(RectTransform))]
+    public sealed class IgnoreSafeArea : MonoBehaviour
+    {
+        private const string SafeAreaObjectName = "SafeArea";
+
+        private void Awake()
+        {
+            MoveOutsideSafeArea();
+        }
+
+        private void Start()
+        {
+            MoveOutsideSafeArea();
+        }
+
+        private void MoveOutsideSafeArea()
+        {
+            Transform safeArea = transform.parent;
+            if (safeArea == null || safeArea.name != SafeAreaObjectName)
+            {
+                return;
+            }
+
+            Transform canvasTransform = safeArea.parent;
+            if (canvasTransform == null)
+            {
+                return;
+            }
+
+            int siblingIndex = safeArea.GetSiblingIndex();
+            transform.SetParent(canvasTransform, false);
+            transform.SetSiblingIndex(siblingIndex);
+
+            StretchToParent(GetComponent<RectTransform>());
+        }
+
+        private static void StretchToParent(RectTransform rectTransform)
+        {
+            rectTransform.anchorMin = Vector2.zero;
+            rectTransform.anchorMax = Vector2.one;
+            rectTransform.pivot = new Vector2(0.5f, 0.5f);
+            rectTransform.anchoredPosition = Vector2.zero;
+            rectTransform.sizeDelta = Vector2.zero;
+        }
+    }
+}

package/Runtime/Public/IgnoreSafeArea.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a83d6bba35d74a8bbf08dce93a976c30
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Resources/HyperGameContentConfig.asset.meta

@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: a8fa619245978144b907285114851cc4
+guid: 6018677dae71f2b4f96fd71521fdc0fd
 NativeFormatImporter:
   externalObjects: {}
   mainObjectFileID: 11400000

package/Runtime/Resources/UIPrefabs/GamePausedModal_Battle_Landscape.prefab

@@ -556,7 +556,7 @@ PrefabInstance:
       objectReference: {fileID: 0}
     - target: {fileID: 7363684731116559227, guid: a339c1d0d1ed34649bc790f13508f5c1, type: 3}
       propertyPath: m_AnchoredPosition.y
-      value: 0
+      value: -50
       objectReference: {fileID: 0}
     - target: {fileID: 7363684731116559227, guid: a339c1d0d1ed34649bc790f13508f5c1, type: 3}
       propertyPath: m_LocalEulerAnglesHint.x

package/Runtime/Resources/UIPrefabs/GamePausedModal_Practice_Landscape.prefab

@@ -438,7 +438,7 @@ PrefabInstance:
       objectReference: {fileID: 0}
     - target: {fileID: 1058585634037846549, guid: d9d0c284a651b3a488ec179c56fe7d7f, type: 3}
       propertyPath: m_AnchoredPosition.y
-      value: 0
+      value: -50
       objectReference: {fileID: 0}
     - target: {fileID: 1058585634037846549, guid: d9d0c284a651b3a488ec179c56fe7d7f, type: 3}
       propertyPath: m_LocalEulerAnglesHint.x

package/Runtime/Resources/UIPrefabs/RetryTimeExpiredModal_Landscape.prefab

@@ -160,6 +160,18 @@ PrefabInstance:
       propertyPath: m_SizeDelta.y
       value: 870.2895
       objectReference: {fileID: 0}
+    - target: {fileID: 9176982616275533154, guid: 856acbd60978d3740849e762e87c5e7c, type: 3}
+      propertyPath: m_LocalScale.x
+      value: 0.96
+      objectReference: {fileID: 0}
+    - target: {fileID: 9176982616275533154, guid: 856acbd60978d3740849e762e87c5e7c, type: 3}
+      propertyPath: m_LocalScale.y
+      value: 0.96
+      objectReference: {fileID: 0}
+    - target: {fileID: 9176982616275533154, guid: 856acbd60978d3740849e762e87c5e7c, type: 3}
+      propertyPath: m_LocalScale.z
+      value: 0.96
+      objectReference: {fileID: 0}
     - target: {fileID: 9176982616275533154, guid: 856acbd60978d3740849e762e87c5e7c, type: 3}
       propertyPath: m_LocalPosition.x
       value: 0
@@ -194,7 +206,7 @@ PrefabInstance:
       objectReference: {fileID: 0}
     - target: {fileID: 9176982616275533154, guid: 856acbd60978d3740849e762e87c5e7c, type: 3}
       propertyPath: m_AnchoredPosition.y
-      value: 0
+      value: -50
       objectReference: {fileID: 0}
     - target: {fileID: 9176982616275533154, guid: 856acbd60978d3740849e762e87c5e7c, type: 3}
       propertyPath: m_LocalEulerAnglesHint.x

package/Runtime/Resources/UIPrefabs/ScoreSubmissionFailedModal_Landscape.prefab

@@ -28,7 +28,7 @@ RectTransform:
   m_GameObject: {fileID: 858581963775131442}
   m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
   m_LocalPosition: {x: 0, y: 0, z: 0}
-  m_LocalScale: {x: 0.82, y: 0.82, z: 0.82}
+  m_LocalScale: {x: 0.96, y: 0.96, z: 0.96}
   m_ConstrainProportionsScale: 1
   m_Children:
   - {fileID: 3260987079844009583}
@@ -39,7 +39,7 @@ RectTransform:
   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: 0}
+  m_AnchoredPosition: {x: 0, y: -50}
   m_SizeDelta: {x: 890.68, y: 854.7493}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &5855589522202011792

package/Runtime/Resources/UIPrefabs/SessionTimedOutModal.prefab

@@ -40,7 +40,7 @@ RectTransform:
   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: 0}
+  m_AnchoredPosition: {x: 0, y: -15}
   m_SizeDelta: {x: 890.6797, y: 784.1287}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &7474295978719854104

package/package.json

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