app.hypergames.hypersdk 1.7.1 → 1.8.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.8.1](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.0...v1.8.1) (2026-04-02)
+
+
+### Bug Fixes
+
+* runtime ignores developer's HyperSDKSettings ([26127c1](https://github.com/mvmhyper/hyper-sdk/commit/26127c10c47e64aaa47144c7158833140822cc50))
+
+# [1.8.0](https://github.com/mvmhyper/hyper-sdk/compare/v1.7.1...v1.8.0) (2026-04-02)
+
+
+### Features
+
+* expose safe-area-adjusted screen dimensions via IScreenAPI ([ba874e2](https://github.com/mvmhyper/hyper-sdk/commit/ba874e2dec213acf24e58caef5fca29d4975e1cb))
+
 ## [1.7.1](https://github.com/mvmhyper/hyper-sdk/compare/v1.7.0...v1.7.1) (2026-04-02)
 
 

package/Editor/Scripts/Windows/HyperCoreSettingsWindow.cs

@@ -13,8 +13,6 @@ namespace Hyper.Editor
     {
         #region Private Fields
 
-        private const string PrefKey = "Hyper/Mode";
-
         private static HyperSDKSettings _settings;
         private UnityEditor.Editor _settingsEditor;
         private Vector2 _scrollPosition;

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -228,6 +228,22 @@ namespace Hyper.Internal
                 return matchingResources[0];
             }
 
+            // Prefer the project-configured copy over the package template.
+            // HyperSDKSettings: configured if the developer has enabled at least one platform/orientation flag.
+            if (typeof(T) == typeof(HyperSDKSettings))
+            {
+                for (int i = 0; i < matchingResources.Count; i++)
+                {
+                    var settings = matchingResources[i] as HyperSDKSettings;
+                    if (settings != null && settings.IsConfigured)
+                    {
+                        return matchingResources[i];
+                    }
+                }
+                return matchingResources.Count > 1 ? matchingResources[1] : matchingResources[0];
+            }
+
+            // HyperGameContentConfig: configured if it has a valid game scene assigned.
             if (typeof(T) == typeof(HyperGameContentConfig))
             {
                 for (int i = 0; i < matchingResources.Count; i++)

package/Runtime/Internal/ScriptableObjects/HyperSDKSettings.cs

@@ -57,6 +57,17 @@ namespace Hyper.Internal
 
         #endregion
 
+        #region Validation
+
+        /// <summary>
+        /// Returns true if this settings asset has been configured by the developer.
+        /// A fresh package template has all platform/orientation flags set to false,
+        /// so any asset with at least one flag enabled is considered the project copy.
+        /// </summary>
+        public bool IsConfigured => portrait || landscape || pc || mobile;
+
+        #endregion
+
         #region Restart Flow Settings
 
         [Space(20)]

package/Runtime/Internal/UI/Components/PauseButton.cs

@@ -1,9 +1,10 @@
 using Hyper.Internal.Managers;
 using UnityEngine;
+using UnityEngine.EventSystems;
 
 namespace Hyper.Internal
 {
-    internal class PauseButton : MonoBehaviour
+    internal class PauseButton : MonoBehaviour, IPointerDownHandler
     {
         [SerializeField] GameObject notifyDot;
         private GameManager _gameManager;
@@ -16,17 +17,15 @@ namespace Hyper.Internal
         private void Start()
         {
             if (notifyDot != null)
-            {
                 notifyDot.SetActive(false);
-            }
         }
 
         private void Notify()
         {
-            if(_gameManager.HasGameStarted) notifyDot.SetActive(true);
+            if (_gameManager.HasGameStarted) notifyDot.SetActive(true);
         }
 
-        public void PauseGame()
+        public void OnPointerDown(PointerEventData eventData)
         {
             _gameManager.PauseGame();
         }

package/Runtime/Public/Core/HyperSDK.cs

@@ -16,6 +16,7 @@ namespace Hyper
         private static DataAPIAdapter _dataAdapter;
         private static EventAPIAdapter _eventAdapter;
         private static LoaderAPIAdapter _loaderAdapter;
+        private static ScreenAPIAdapter _screenAdapter;
 
         /// <summary>
         /// Returns true if the SDK runtime has been initialized.
@@ -106,6 +107,20 @@ namespace Hyper
             }
         }
 
+        /// <summary>
+        /// Access safe-area-adjusted screen dimensions.
+        /// Use instead of Screen.width / Screen.height to account for notches and system insets.
+        /// </summary>
+        public static IScreenAPI Screen
+        {
+            get
+            {
+                if (_screenAdapter == null)
+                    _screenAdapter = new ScreenAPIAdapter();
+                return _screenAdapter;
+            }
+        }
+
         /// <summary>
         /// Current Hyper SDK version string.
         /// </summary>
@@ -346,6 +361,23 @@ namespace Hyper
         event Action OnCustomRestart;
     }
 
+    /// <summary>
+    /// Safe-area-adjusted screen dimensions.
+    /// Use these instead of Screen.width / Screen.height to match the playable area after notch and system inset adjustments.
+    /// </summary>
+    public interface IScreenAPI
+    {
+        /// <summary>
+        /// Usable screen width in pixels after safe area insets are applied.
+        /// </summary>
+        float Width { get; }
+
+        /// <summary>
+        /// Usable screen height in pixels after safe area insets are applied.
+        /// </summary>
+        float Height { get; }
+    }
+
     #region Adapter Implementations
 
     /// <summary>
@@ -365,6 +397,40 @@ namespace Hyper
         }
     }
 
+    /// <summary>
+    /// Bridges the public screen API to the platform safe area.
+    /// </summary>
+    internal sealed class ScreenAPIAdapter : IScreenAPI
+    {
+        public float Width => GetSafeArea().width;
+
+        public float Height
+        {
+            get
+            {
+                var sa = GetSafeArea();
+                return sa.y + sa.height;
+            }
+        }
+
+        private Rect GetSafeArea()
+        {
+#if UNITY_WEBGL && !UNITY_EDITOR
+            var config = HyperRuntime.GameManager?.Config;
+            if (config != null)
+            {
+                var insets = config.SafeArea;
+                float x = insets.left;
+                float y = 0f;
+                float width = UnityEngine.Screen.width - insets.left - insets.right;
+                float height = UnityEngine.Screen.height - insets.top;
+                return new Rect(x, y, width, height);
+            }
+#endif
+            return UnityEngine.Screen.safeArea;
+        }
+    }
+
     /// <summary>
     /// Bridges the public game API to the internal GameManager without exposing it to consumers.
     /// </summary>

package/Runtime/Resources/HyperSDKSettings.asset

@@ -12,12 +12,12 @@ MonoBehaviour:
   m_Script: {fileID: 11500000, guid: 56c34fa8aa6f98746a3664aa1d18f483, type: 3}
   m_Name: HyperSDKSettings
   m_EditorClassIdentifier: 
-  portrait: 1
+  portrait: 0
   landscape: 0
   pc: 0
-  mobile: 1
+  mobile: 0
   startCTA: 0
-  swipeDirection: 0
+  swipeDirection: 2
   controlBarLayout: 0
   controlBarTheme: 1
   useCustomRestartFlow: 0

package/Runtime/Resources/UIPrefabs/ControlBar.prefab

@@ -718,19 +718,7 @@ MonoBehaviour:
   m_TargetGraphic: {fileID: 6337179202905528179}
   m_OnClick:
     m_PersistentCalls:
-      m_Calls:
-      - m_Target: {fileID: 4052121302679636064}
-        m_TargetAssemblyTypeName: Hyper.PauseButton, Assembly-CSharp
-        m_MethodName: PauseGame
-        m_Mode: 1
-        m_Arguments:
-          m_ObjectArgument: {fileID: 0}
-          m_ObjectArgumentAssemblyTypeName: UnityEngine.Object, UnityEngine
-          m_IntArgument: 0
-          m_FloatArgument: 0
-          m_StringArgument: 
-          m_BoolArgument: 0
-        m_CallState: 2
+      m_Calls: []
 --- !u!114 &4052121302679636064
 MonoBehaviour:
   m_ObjectHideFlags: 0

package/package.json

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