app.hypergames.hypersdk 1.11.0-beta.2 → 1.11.0-beta.3

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# [1.11.0-beta.3](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.2...v1.11.0-beta.3) (2026-08-28)
+
+
+### Bug Fixes
+
+* **replay:** reset random state before playback restart ([526a4d9](https://github.com/mvmhyper/hyper-sdk/commit/526a4d98c9b22241e3c52bb6837145bad999fb2b))
+* **sample:** support lane runner custom restart ([49da385](https://github.com/mvmhyper/hyper-sdk/commit/49da385aaa917de438672a8630d4fe7927741b2a))
+
 # [1.11.0-beta.2](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.1...v1.11.0-beta.2) (2026-08-27)
 
 

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -20,6 +20,7 @@ namespace Hyper.Internal
 
         private static bool _isInitialized;
         private static bool _isSoftRestarting;
+        private static bool _replayRandomResetPending;
         private static bool _customLoadingComplete;
         private static bool _customLoadingActive;
         private static float _customLoadingProgress;
@@ -145,7 +146,8 @@ namespace Hyper.Internal
                 _gameManager != null && _eventManager != null)
             {
                 _replayManager?.PrepareForRestart();
-                ResetReplayRandomState();
+                // Custom cleanup may use random streams. Rewind after cleanup, immediately before OnGameStart.
+                DeferReplayRandomReset();
                 _gameManager.ResetUIStateForCustomRestart();
                 _eventManager.InvokeCustomRestartEvent();
                 _isSoftRestarting = false;
@@ -176,6 +178,19 @@ namespace Hyper.Internal
             HyperRandom.Init(ReplaySessionState.OriginalRandomSeed);
         }
 
+        internal static void ApplyPendingReplayRandomReset()
+        {
+            if (!_replayRandomResetPending) return;
+
+            _replayRandomResetPending = false;
+            ResetReplayRandomState();
+        }
+
+        internal static void DeferReplayRandomReset()
+        {
+            _replayRandomResetPending = true;
+        }
+
         /// <summary>
         /// Coroutine-based restart that properly unloads all scenes before reloading.
         /// Handles async scene operations and ensures clean state before restart.
@@ -414,6 +429,7 @@ namespace Hyper.Internal
             _customLoadingComplete = false;
             _customLoadingActive = false;
             _customLoadingProgress = 0f;
+            _replayRandomResetPending = false;
 
             if (_singletonObject != null)
             {
@@ -472,6 +488,7 @@ namespace Hyper.Internal
             _customLoadingComplete = false;
             _customLoadingActive = false;
             _customLoadingProgress = 0f;
+            _replayRandomResetPending = false;
         }
     }
 }

package/Runtime/Internal/Managers/GameManager.cs

@@ -1025,6 +1025,8 @@ namespace Hyper.Internal.Managers
             if (_gameStartRequested || _hasGameStarted || _hasGameEnded || !IsInGameScene) return;
             _gameStartRequested = true;
 
+            HyperRuntime.ApplyPendingReplayRandomReset();
+
             HideStartGameDeadlineSnackBar();
             _dataManager.UpdateScore(0);
             HyperRuntime.Timer.StartActiveGameTimer();
@@ -1062,7 +1064,7 @@ namespace Hyper.Internal.Managers
 
         /// <summary>
         /// Resets SDK UI state for custom restart flow.
-        /// Called after OnCustomRestart event is fired to prepare the SDK for the developer's restart logic.
+        /// Called before OnCustomRestart so the developer's cleanup starts from reset SDK state.
         /// </summary>
         internal void ResetUIStateForCustomRestart()
         {

package/Samples~/LaneRunner/LaneRunnerSample.unity

@@ -491,7 +491,8 @@ MonoBehaviour:
   laneChangeSpeed: 14
   jumpVelocity: 7.5
   swipeThreshold: 45
-  startPosition: {x: 3.62, y: 0.567, z: 0}
+  startPosition: {x: 3.62, y: 0.5, z: 0}
+  groundHeight: 0.5
 --- !u!54 &554141008
 Rigidbody:
   m_ObjectHideFlags: 0
@@ -574,7 +575,7 @@ BoxCollider:
   m_Material: {fileID: 0}
   m_IncludeLayers:
     serializedVersion: 2
-    m_Bits: 0
+    m_Bits: 1
   m_ExcludeLayers:
     serializedVersion: 2
     m_Bits: 0
@@ -1051,7 +1052,7 @@ BoxCollider:
   m_Material: {fileID: 0}
   m_IncludeLayers:
     serializedVersion: 2
-    m_Bits: 0
+    m_Bits: 1
   m_ExcludeLayers:
     serializedVersion: 2
     m_Bits: 0

package/Samples~/LaneRunner/Prefabs/DoubleScorePickup.prefab

@@ -54,7 +54,7 @@ SphereCollider:
   m_Material: {fileID: 0}
   m_IncludeLayers:
     serializedVersion: 2
-    m_Bits: 0
+    m_Bits: 1
   m_ExcludeLayers:
     serializedVersion: 2
     m_Bits: 0

package/Samples~/LaneRunner/Prefabs/Obstacle.prefab

@@ -54,7 +54,7 @@ BoxCollider:
   m_Material: {fileID: 0}
   m_IncludeLayers:
     serializedVersion: 2
-    m_Bits: 0
+    m_Bits: 1
   m_ExcludeLayers:
     serializedVersion: 2
     m_Bits: 0

package/Samples~/LaneRunner/README.md

@@ -13,13 +13,20 @@ deterministic spawning, a timed score multiplier, and replay integration.
 Assign `LaneRunnerSample` as the Game and Practice scene in Hyper Game Content
 Config, then use Hyper's Editor game-mode menu to run Practice, Battle, or Replay.
 Battle sessions record to `hyper-replay.ndjson` in `Application.persistentDataPath`.
+Enable Custom Restart Flow in Hyper SDK Settings to test in-place Watch Again and
+replay seeking without reloading the scene.
+
+The sample uses only Unity's built-in `Default` layer, `Untagged`, and
+`MainCamera`. Its collider overrides and ground safety do not require changes to
+the importing project's tags, layers, or physics collision matrix.
 
 ## Integration structure
 
 - `LaneRunnerGame` owns rules, score, speed, and power-up state.
 - `LaneRunnerPlayer` owns physical input and applies commands in `FixedUpdate`.
 - `LaneRunnerSpawner` creates deterministic rows using `HyperRandom`.
-- `LaneRunnerTournamentAdapter` connects score, power-ups, and lifecycle to HyperSDK.
+- `LaneRunnerTournamentAdapter` connects score, power-ups, lifecycle, and custom
+  restart handling to HyperSDK.
 - `LaneRunnerReplayAdapter` records accepted commands and injects replay commands
   through the same player path.
 

package/Samples~/LaneRunner/Scripts/Gameplay/LaneRunnerPlayer.cs

@@ -11,7 +11,8 @@ namespace HyperSamples.LaneRunner
         [SerializeField] private float laneChangeSpeed = 14f;
         [SerializeField] private float jumpVelocity = 7.5f;
         [SerializeField] private float swipeThreshold = 45f;
-        [SerializeField] private Vector3 startPosition = new Vector3(0f, 0.68f, 0f);
+        [SerializeField] private Vector3 startPosition = new Vector3(0f, 0.5f, 0f);
+        [SerializeField] private float groundHeight = 0.5f;
 
         public event Action<LaneRunnerCommand> CommandApplied;
 
@@ -48,18 +49,18 @@ namespace HyperSamples.LaneRunner
 
         private void FixedUpdate()
         {
+            StabilizeGround();
+
             if (pendingLaneDelta != 0)
             {
                 int nextLane = Mathf.Clamp(targetLane + pendingLaneDelta, -1, 1);
                 pendingLaneDelta = 0;
-                Debug.Log($"LaneRunnerPlayer: Moving from lane {targetLane} to {nextLane}");
                 if (nextLane != targetLane)
                 {
                     LaneRunnerCommand applied = nextLane < targetLane
                         ? LaneRunnerCommand.MoveLeft
                         : LaneRunnerCommand.MoveRight;
                     targetLane = nextLane;
-                    Debug.Log($"targetLane updated to {targetLane}");
                     CommandApplied?.Invoke(applied);
                 }
             }
@@ -120,7 +121,20 @@ namespace HyperSamples.LaneRunner
 
         private bool IsGrounded()
         {
-            return body.position.y <= 0.68f && body.linearVelocity.y <= 0.05f;
+            return body.position.y <= groundHeight + 0.18f && body.linearVelocity.y <= 0.05f;
+        }
+
+        private void StabilizeGround()
+        {
+            if (body.position.y >= groundHeight || body.linearVelocity.y > 0f) return;
+
+            Vector3 position = body.position;
+            position.y = groundHeight;
+            body.position = position;
+
+            Vector3 velocity = body.linearVelocity;
+            velocity.y = 0f;
+            body.linearVelocity = velocity;
         }
 
         private void ReadTouchInput()

package/Samples~/LaneRunner/Scripts/Gameplay/LaneRunnerSpawner.cs

@@ -61,7 +61,9 @@ namespace HyperSamples.LaneRunner
         {
             for (int i = activeItems.Count - 1; i >= 0; i--)
             {
-                if (activeItems[i] != null) Destroy(activeItems[i].gameObject);
+                if (activeItems[i] == null) continue;
+                activeItems[i].gameObject.SetActive(false);
+                Destroy(activeItems[i].gameObject);
             }
             activeItems.Clear();
         }

package/Samples~/LaneRunner/Scripts/Hyper/LaneRunnerTournamentAdapter.cs

@@ -16,6 +16,7 @@ namespace HyperSamples.LaneRunner
         {
             HyperSDK.Event.OnGameStart += HandleGameStart;
             HyperSDK.Event.OnGameEnded += HandleGameEnded;
+            HyperSDK.Event.OnCustomRestart += HandleCustomRestart;
             game.ScoreChanged += HandleScoreChanged;
             game.DoubleScoreChanged += HandleDoubleScoreChanged;
             game.GameOverRequested += HandleGameOverRequested;
@@ -25,6 +26,7 @@ namespace HyperSamples.LaneRunner
         {
             HyperSDK.Event.OnGameStart -= HandleGameStart;
             HyperSDK.Event.OnGameEnded -= HandleGameEnded;
+            HyperSDK.Event.OnCustomRestart -= HandleCustomRestart;
             game.ScoreChanged -= HandleScoreChanged;
             game.DoubleScoreChanged -= HandleDoubleScoreChanged;
             game.GameOverRequested -= HandleGameOverRequested;
@@ -35,6 +37,11 @@ namespace HyperSamples.LaneRunner
             game.Begin(!HyperSDK.Game.IsReplayMode);
         }
 
+        private void HandleCustomRestart()
+        {
+            game.Stop();
+        }
+
         private void HandleGameEnded()
         {
             game.Stop();

package/package.json

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