app.hypergames.hypersdk 1.4.12 → 1.4.14

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [1.4.14](https://github.com/mvmhyper/hyper-sdk/compare/v1.4.13...v1.4.14) (2026-01-06)
+
+
+### Bug Fixes
+
+* migrate final submit to websockets; refresh CSRF on freeze-resume ([8b445e7](https://github.com/mvmhyper/hyper-sdk/commit/8b445e78d677507cc2ef7bce54d815df0ee0f58b))
+* Minor Bug fixes and improvements. ([a5004b5](https://github.com/mvmhyper/hyper-sdk/commit/a5004b5d054be4e5a432f30a6abcfad4287f70b7))
+
+## [1.4.13](https://github.com/mvmhyper/hyper-sdk/compare/v1.4.12...v1.4.13) (2026-01-01)
+
+
+### Bug Fixes
+
+* Add HyperRandom usage check and scene menu utility ([4e8bad9](https://github.com/mvmhyper/hyper-sdk/commit/4e8bad9a56dc3007c1303ee095b8bfc6cb09903a))
+
 ## [1.4.12](https://github.com/mvmhyper/hyper-sdk/compare/v1.4.11...v1.4.12) (2025-12-23)
 
 

package/Editor/Scripts/Setup/HyperSDKInstaller.cs

@@ -55,35 +55,58 @@ namespace Hyper.Editor
                 return;
             }
 
+            var currentVersion = packageInfo.version;
             var previousVersion = EditorPrefs.GetString(InstallerPrefsKey, string.Empty);
             var sceneExists = File.Exists(HyperLoaderSceneDestination);
             var templateExists = Directory.Exists(WebGLTemplateDestination);
             var configExists = File.Exists(HyperGameContentConfigDestination);
             var settingsExists = File.Exists(HyperSDKSettingsDestination);
 
-            // Only run if version changed or files are missing
-            if (previousVersion == packageInfo.version &&
-                sceneExists &&
-                templateExists &&
-                configExists &&
-                settingsExists)
-            {
-                return;
-            }
-
+            // Check what kind of version change we are dealing with
+            bool isMajorVersionChange = HasMajorVersionChanged(previousVersion, currentVersion);
+            bool isMajorOrMinorVersionChange = HasMajorOrMinorVersionChanged(previousVersion, currentVersion);
+            
             var packageRoot = packageInfo.resolvedPath;
             var hyperLoaderSource = Path.Combine(packageRoot, HyperLoaderSceneRelativePath);
             var templateSource = Path.Combine(packageRoot, WebGLTemplateRelativePath);
             var hyperGameContentConfigSource = Path.Combine(packageRoot, HyperGameContentConfigRelativePath);
             var hyperSDKSettingsSource = Path.Combine(packageRoot, HyperSDKSettingsRelativePath);
 
-            CopyFileWithoutMeta(hyperLoaderSource, HyperLoaderSceneDestination);
-            CopyTemplate(templateSource);
-            CopyFileWithoutMeta(hyperGameContentConfigSource, HyperGameContentConfigDestination);
-            CopyFileWithoutMeta(hyperSDKSettingsSource, HyperSDKSettingsDestination);
+            bool anyFileCopied = false;
+
+            if (!sceneExists || isMajorVersionChange)
+            {
+                CopyFileWithoutMeta(hyperLoaderSource, HyperLoaderSceneDestination);
+                anyFileCopied = true;
+            }
+
+            if (!templateExists || isMajorOrMinorVersionChange)
+            {
+                CopyTemplate(templateSource);
+                anyFileCopied = true;
+            }
+
+            if (!configExists || isMajorOrMinorVersionChange)
+            {
+                CopyFileWithoutMeta(hyperGameContentConfigSource, HyperGameContentConfigDestination);
+                anyFileCopied = true;
+            }
 
-            EditorPrefs.SetString(InstallerPrefsKey, packageInfo.version);
-            AssetDatabase.Refresh();
+            if (!settingsExists || isMajorOrMinorVersionChange)
+            {
+                CopyFileWithoutMeta(hyperSDKSettingsSource, HyperSDKSettingsDestination);
+                anyFileCopied = true;
+            }
+
+            // Always update the stored version, even if no files were copied
+            if (previousVersion != currentVersion)
+            {
+                EditorPrefs.SetString(InstallerPrefsKey, currentVersion);
+                if (anyFileCopied)
+                {
+                    AssetDatabase.Refresh();
+                }
+            }
         }
 
         private static void CopyFileWithoutMeta(string sourcePath, string destinationPath)
@@ -143,6 +166,82 @@ namespace Hyper.Editor
                 FileUtil.DeleteFileOrDirectory(meta);
             }
         }
+
+        /// <summary>
+        /// Parses a semantic version string (e.g., "1.4.5") and returns major, minor, patch components.
+        /// Returns (0, 0, 0) if version string is invalid or empty.
+        /// </summary>
+        private static (int major, int minor, int patch) ParseVersion(string version)
+        {
+            if (string.IsNullOrEmpty(version))
+            {
+                return (0, 0, 0);
+            }
+
+            // Remove any pre-release or build metadata (e.g., "1.4.5-preview.1" -> "1.4.5")
+            var cleanVersion = version.Split('-')[0].Split('+')[0];
+
+            var parts = cleanVersion.Split('.');
+            if (parts.Length < 2)
+            {
+                return (0, 0, 0);
+            }
+
+            int major = int.TryParse(parts[0], out int m) ? m : 0;
+            int minor = int.TryParse(parts[1], out int mi) ? mi : 0;
+            int patch = parts.Length > 2 && int.TryParse(parts[2], out int p) ? p : 0;
+
+            return (major, minor, patch);
+        }
+
+        /// <summary>
+        /// Returns true if the version change represents a major or minor version change (not just patch).
+        /// Examples:
+        /// - 1.4.5 -> 1.4.6: false (patch change)
+        /// - 1.4.5 -> 1.5.0: true (minor change)
+        /// - 1.4.5 -> 2.0.0: true (major change)
+        /// - Empty -> 1.0.0: true (first install)
+        /// </summary>
+        private static bool HasMajorOrMinorVersionChanged(string previousVersion, string currentVersion)
+        {
+            // First install or version is empty
+            if (string.IsNullOrEmpty(previousVersion))
+            {
+                return true;
+            }
+
+            var (prevMajor, prevMinor, _) = ParseVersion(previousVersion);
+            var (currMajor, currMinor, _) = ParseVersion(currentVersion);
+
+            // Major version changed
+            if (currMajor != prevMajor)
+            {
+                return true;
+            }
+
+            // Minor version changed
+            if (currMinor != prevMinor)
+            {
+                return true;
+            }
+
+            // Only patch version changed (or no change)
+            return false;
+        }
+
+        private static bool HasMajorVersionChanged(string previousVersion, string currentVersion)
+        {
+            if(string.IsNullOrEmpty(previousVersion))
+            {
+                return true;
+            }
+
+            var (prevMajor, _, _) = ParseVersion(previousVersion);
+            var (currMajor, _, _) = ParseVersion(currentVersion);
+
+            // Only major version
+            return currMajor != prevMajor;
+        }
     }
 }
 

package/Editor/Scripts/Tools/HyperBuildAssistant.cs

@@ -255,7 +255,7 @@ namespace Hyper.Editor
             {
                 EditorGUILayout.BeginHorizontal();
                 {
-                    if (GUILayout.Toggle(currentTab == TabType.WebGLSettings, "WebGL Settings", tallButtonStyleLeft))
+                    if (GUILayout.Toggle(currentTab == TabType.WebGLSettings, "Configuration", tallButtonStyleLeft))
                     {
                         currentTab = TabType.WebGLSettings;
                     }
@@ -289,7 +289,7 @@ namespace Hyper.Editor
 
         #endregion
 
-        #region WebGL Settings Tab
+        #region Configuration Tab
 
         private static void DrawWebGLSettingsTab()
         {
@@ -563,7 +563,7 @@ namespace Hyper.Editor
                 isOptimal = status.hyperLoaderAtIndex0,
                 current = $"• Current: {(status.hyperLoaderAtIndex0 ? "HyperLoader at index 0" : "HyperLoader not at index 0")}",
                 recommended = "• Recommended: HyperLoader at build index 0",
-                description = "HyperLoader scene must be at build index 0 in Build Settings. This ensures proper SDK initialization before your game starts.",
+                description = "HyperLoader scene must be at build index 0 in Build Settings (from Assets/HyperSDK/HyperLoader.unity). This ensures proper SDK initialization before your game starts.",
                 priority = SettingPriority.Critical,
                 type = SettingType.HyperLoaderSceneIndex
             };
@@ -593,6 +593,18 @@ namespace Hyper.Editor
             };
             CategorizeSettings(buildTargetSetting, optimalSettings, recommendedSettings, outstandingSettings);
 
+            var hyperRandomSetting = new SettingInfo
+            {
+                name = "HyperRandom Usage",
+                isOptimal = status.hyperRandomUsed,
+                current = $"• Current: {(status.hyperRandomUsed ? "HyperRandom detected in your code" : "HyperRandom not found")}",
+                recommended = "• Recommended: Use HyperRandom for deterministic gameplay",
+                description = "HyperRandom ensures deterministic gameplay across devices. Use the RNG Migrator tool (Hyper > RNG Migrator) to migrate UnityEngine.Random and System.Random to HyperRandom.",
+                priority = SettingPriority.Critical,
+                type = SettingType.HyperRandomUsage
+            };
+            CategorizeSettings(hyperRandomSetting, optimalSettings, recommendedSettings, outstandingSettings);
+
             // Note: Texture compression is platform-specific (Android/iOS) and not applicable to WebGL builds
             // WebGL handles texture compression at runtime via browser support
             // This setting is kept for reference but won't affect WebGL builds
@@ -746,6 +758,15 @@ namespace Hyper.Editor
             };
             CategorizeSettings(buildTargetSetting, optimal, recommended, outstanding);
 
+            var hyperRandomSetting = new SettingInfo
+            {
+                name = "HyperRandom Usage",
+                isOptimal = status.hyperRandomUsed,
+                priority = SettingPriority.Critical,
+                type = SettingType.HyperRandomUsage
+            };
+            CategorizeSettings(hyperRandomSetting, optimal, recommended, outstanding);
+
             // Note: Texture compression is platform-specific and not applicable to WebGL builds
         }
 
@@ -1085,6 +1106,12 @@ namespace Hyper.Editor
                     // WebGL handles texture compression at runtime via browser support
                     HyperDebug.LogWarning("Texture compression settings are not applicable to WebGL builds. WebGL handles texture compression automatically at runtime based on browser support.");
                     break;
+
+                case SettingType.HyperRandomUsage:
+                    // Open the RNG Migrator tool to help developers migrate their Random usage
+                    HyperRandomMigrationTool.ShowMigrationTool();
+                    if (IsSDKDeveloper()) HyperDebug.Log("Opened RNG Migrator tool");
+                    break;
             }
 
             RepaintWindow();
@@ -2545,7 +2572,8 @@ namespace Hyper.Editor
             ShowSplashScreen,
             ColorSpace,
             TextureCompression,
-            BuildTargetPlatform
+            BuildTargetPlatform,
+            HyperRandomUsage
         }
 
         private class SettingInfo
@@ -2581,8 +2609,9 @@ namespace Hyper.Editor
             public TextureImporterFormat textureCompression;
             public bool showSplashScreen;
             public BuildTarget buildTarget;
+            public bool hyperRandomUsed;
 
-            public int GetTotalSettings() => 17;
+            public int GetTotalSettings() => 18;
 
             public int GetConfiguredSettings()
             {
@@ -2606,6 +2635,7 @@ namespace Hyper.Editor
                 if (hyperLoaderAtIndex0) count++;
                 if (colorSpace == ColorSpace.Gamma) count++;
                 if (buildTarget == BuildTarget.WebGL) count++;
+                if (hyperRandomUsed) count++;
 
                 return count;
             }
@@ -2713,7 +2743,7 @@ namespace Hyper.Editor
                 // Property may not exist in this Unity version
             }
 
-            // Check if HyperLoader is at build index 0
+            // Check if HyperLoader is at build index 0 (must be from Assets/HyperSDK/, not Packages/)
             bool hyperLoaderAt0 = false;
             try
             {
@@ -2721,8 +2751,8 @@ namespace Hyper.Editor
                 if (scenes != null && scenes.Length > 0 && scenes[0].enabled)
                 {
                     string firstScenePath = scenes[0].path;
-                    hyperLoaderAt0 = firstScenePath.Contains("HyperLoader") ||
-                                     firstScenePath.EndsWith("HyperLoader.unity", System.StringComparison.OrdinalIgnoreCase);
+                    // Only accept the HyperLoader scene from Assets/HyperSDK/, not from Packages/
+                    hyperLoaderAt0 = string.Equals(firstScenePath, HyperConstants.HYPER_LOADER_SCENE_PATH, StringComparison.OrdinalIgnoreCase);
                 }
             }
             catch (System.Exception)
@@ -2766,6 +2796,9 @@ namespace Hyper.Editor
             // Get active build target
             BuildTarget activeBuildTarget = EditorUserBuildSettings.activeBuildTarget;
 
+            // Scan for HyperRandom usage in Assets folder (excluding HyperSDK)
+            bool hyperRandomUsed = ScanForHyperRandomUsage();
+
             return new WebGLSettingsStatus
             {
                 compressionFormat = PlayerSettings.WebGL.compressionFormat,
@@ -2787,10 +2820,55 @@ namespace Hyper.Editor
                 showSplashScreen = PlayerSettings.SplashScreen.show,
                 colorSpace = currentColorSpace,
                 textureCompression = defaultTexFormat,
-                buildTarget = activeBuildTarget
+                buildTarget = activeBuildTarget,
+                hyperRandomUsed = hyperRandomUsed
             };
         }
 
+        /// <summary>
+        /// Scans Assets folder for HyperRandom usage, excluding HyperSDK folder.
+        /// Returns true if HyperRandom is used at least once in developer's code.
+        /// </summary>
+        private static bool ScanForHyperRandomUsage()
+        {
+            try
+            {
+                string assetsPath = Application.dataPath;
+                if (!System.IO.Directory.Exists(assetsPath))
+                    return false;
+
+                string[] csFiles = System.IO.Directory.GetFiles(assetsPath, "*.cs", System.IO.SearchOption.AllDirectories);
+
+                foreach (string filePath in csFiles)
+                {
+                    // Exclude HyperSDK folder
+                    string normalizedPath = filePath.Replace("\\", "/");
+                    if (normalizedPath.Contains("/HyperSDK/") || normalizedPath.Contains("Assets/HyperSDK"))
+                        continue;
+
+                    // Exclude TextMesh Pro
+                    if (normalizedPath.Contains("/TextMesh Pro/") || normalizedPath.Contains("Assets/TextMesh Pro"))
+                        continue;
+
+                    // Quick read to check for HyperRandom usage
+                    string content = System.IO.File.ReadAllText(filePath);
+                    
+                    // Check for HyperRandom usage patterns
+                    if (System.Text.RegularExpressions.Regex.IsMatch(content, @"\bHyperRandom\b", System.Text.RegularExpressions.RegexOptions.IgnoreCase))
+                    {
+                        return true;
+                    }
+                }
+            }
+            catch (System.Exception ex)
+            {
+                // If scan fails, default to false (will show as needing attention)
+                if (IsSDKDeveloper()) HyperDebug.LogWarning($"HyperRandom scan failed: {ex.Message}");
+            }
+
+            return false;
+        }
+
         #endregion
 
         #region Build Asset Analysis

package/Editor/Scripts/Tools/HyperSceneMenu.cs

@@ -0,0 +1,44 @@
+#if UNITY_EDITOR
+using UnityEditor;
+using UnityEditor.SceneManagement;
+using UnityEngine;
+
+namespace Hyper.Editor
+{
+    /// <summary>
+    /// Menu items for opening HyperSDK scenes.
+    /// </summary>
+    static class HyperSceneMenu
+    {
+        private const string HYPERLOADER_SCENE_PATH = "Assets/HyperSDK/HyperLoader.unity";
+        private const string MENU_PATH = "Hyper/Open HyperLoader Scene";
+
+        [MenuItem(MENU_PATH, priority = 200)]
+        private static void OpenHyperLoaderScene()
+        {
+            var sceneAsset = AssetDatabase.LoadAssetAtPath<SceneAsset>(HYPERLOADER_SCENE_PATH);
+            if (sceneAsset == null)
+            {
+                EditorUtility.DisplayDialog(
+                    "Scene Not Found",
+                    $"HyperLoader scene not found at:\n{HYPERLOADER_SCENE_PATH}\n\nPlease ensure the scene exists in the project.",
+                    "OK"
+                );
+                return;
+            }
+
+            if (EditorSceneManager.SaveCurrentModifiedScenesIfUserWantsTo())
+            {
+                EditorSceneManager.OpenScene(HYPERLOADER_SCENE_PATH);
+            }
+        }
+
+        [MenuItem(MENU_PATH, validate = true)]
+        private static bool ValidateOpenHyperLoaderScene()
+        {
+            return !EditorApplication.isPlaying;
+        }
+    }
+}
+#endif
+

package/Editor/Scripts/Tools/HyperSceneMenu.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 781094a40eb9a2d439ddee78020e5d9f

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.112, y: -280.1698}
+  m_AnchoredPosition: {x: 489.20746, y: -280.1698}
   m_SizeDelta: {x: 1044.9, y: 239.347}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!114 &751153944
@@ -840,7 +840,7 @@ GameObject:
   m_Component:
   - component: {fileID: 1064166296}
   m_Layer: 0
-  m_Name: __HyperSDK_BuildMarker_639020542296075009
+  m_Name: __HyperSDK_BuildMarker_639030030877789930
   m_TagString: Untagged
   m_Icon: {fileID: 0}
   m_NavMeshLayer: 0
@@ -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.112, y: -133.2274}
+  m_AnchoredPosition: {x: 489.20746, y: -133.2274}
   m_SizeDelta: {x: 875, y: 54.5378}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!1 &2874543288936963705