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

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+# [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)
+
+
+### Bug Fixes
+
+* **replay:** respect custom restart flows ([7470a17](https://github.com/mvmhyper/hyper-sdk/commit/7470a17c60534465500a202c24b0e360f61850fc))
+* **replay:** shorten automatic replay start ([d05dc92](https://github.com/mvmhyper/hyper-sdk/commit/d05dc9267fbf05d392135eac3bb7c4f69b786eff))
+* **timer:** align game time with fixed simulation ([b690d86](https://github.com/mvmhyper/hyper-sdk/commit/b690d861e178f05b21f1a7fbd87e255d97008a8b))
+
 # [1.11.0-beta.1](https://github.com/mvmhyper/hyper-sdk/compare/v1.10.0...v1.11.0-beta.1) (2026-08-26)
 
 

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;
@@ -118,13 +119,13 @@ namespace Hyper.Internal
         }
 
         /// <summary>
-        /// Restarts a replay from HyperLoader even when custom restart is enabled.
-        /// Replay metadata, including the original seed value, remains available to the loader.
+        /// Restarts replay playback while preserving its downloaded data and original seed.
+        /// Uses the configured custom restart flow when available, otherwise reloads HyperLoader.
         /// </summary>
         internal static void RestartReplaySession()
         {
             ReplaySessionState.ResetForWatchAgain();
-            RestartReplayFromLoader();
+            RestartReplay();
         }
 
         internal static void SeekReplaySession(float targetProgress, float resumeSpeed, float seekSpeed)
@@ -133,14 +134,26 @@ namespace Hyper.Internal
 
             ReplaySessionState.RequestSeek(targetProgress, resumeSpeed, seekSpeed);
             ReplaySessionState.ResetForSeekRestart();
-            RestartReplayFromLoader();
+            RestartReplay();
         }
 
-        private static void RestartReplayFromLoader()
+        private static void RestartReplay()
         {
             _isSoftRestarting = true;
             Time.timeScale = 1f;
 
+            if (_settings != null && _settings.useCustomRestartFlow &&
+                _gameManager != null && _eventManager != null)
+            {
+                _replayManager?.PrepareForRestart();
+                // Custom cleanup may use random streams. Rewind after cleanup, immediately before OnGameStart.
+                DeferReplayRandomReset();
+                _gameManager.ResetUIStateForCustomRestart();
+                _eventManager.InvokeCustomRestartEvent();
+                _isSoftRestarting = false;
+                return;
+            }
+
             if (_host != null)
             {
                 _host.StartCoroutine(RestartSessionCoroutine());
@@ -152,6 +165,32 @@ namespace Hyper.Internal
             }
         }
 
+        internal static void ResetReplayRandomState()
+        {
+            int originalSeed = unchecked((int)ReplaySessionState.OriginalRandomSeed);
+            if (HyperRandom.CurrentSeed == originalSeed)
+            {
+                // Preserve references held by game code while rewinding every stream.
+                HyperRandom.ResetAll();
+                return;
+            }
+
+            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.
@@ -390,6 +429,7 @@ namespace Hyper.Internal
             _customLoadingComplete = false;
             _customLoadingActive = false;
             _customLoadingProgress = 0f;
+            _replayRandomResetPending = false;
 
             if (_singletonObject != null)
             {
@@ -448,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,26 +1064,39 @@ 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()
         {
             HideGameOverModal();
             HidePauseModals();
+            if (_replayOverModal != null) _replayOverModal.SetActive(false);
 
             // Reset game state flags
             _hasGameStarted = false;
             _gameStartRequested = false;
             _hasGameEnded = false;
+            _replayEndHandled = false;
+            _replayFocusSuspended = false;
             _isPaused = false;
             _isFrozenBeforePause = false;
 
-            HyperRuntime.Timer.Reset();
+            HyperRuntime.Timer.ResetForGameRestart();
             HyperRuntime.DataManager.UpdateScore(0);
             HyperRuntime.DataManager.RestoreAudioAfterGameSessionEnd();
 
             ShowControlBarElements();
-            ShowStartingInstructionModal();
+            _replayControllerComponent?.ResetForReplayRestart();
+
+            if (IsReplayMode && ReplaySessionState.IsSeeking)
+            {
+                HideStartingInstructionModal();
+                StartCoroutine(StartSeekingReplayWhenReady());
+            }
+            else
+            {
+                ShowStartingInstructionModal();
+            }
         }
 
         #endregion

package/Runtime/Internal/Managers/ReplayManager.cs

@@ -39,6 +39,12 @@ namespace Hyper.Internal.Managers
             ReplaySessionState.SetProgress(_playback.Progress01);
         }
 
+        internal void PrepareForRestart()
+        {
+            _endingGame = false;
+            _playback?.Stop();
+        }
+
         internal void Cleanup()
         {
             if (_eventManager != null)

package/Runtime/Internal/Managers/TimeManager.cs

@@ -43,7 +43,7 @@ namespace Hyper.Internal.Managers
         private bool _isSessionRunning;
         private bool _sessionWarningTriggered;
         private bool _timeUpTriggered;
-        private bool _replayTimeUpPending;
+        private bool _timeUpPending;
 
         private float _lastUnscaledTime;
         private bool _hasGameEnded;
@@ -65,7 +65,7 @@ namespace Hyper.Internal.Managers
             _hasBackendSessionDuration = false;
             _lastUnscaledTime = Time.unscaledTime;
             _timeUpTriggered = false;
-            _replayTimeUpPending = false;
+            _timeUpPending = false;
         }
 
         #endregion
@@ -91,27 +91,21 @@ namespace Hyper.Internal.Managers
             float unscaledDelta = Time.unscaledTime - _lastUnscaledTime;
             _lastUnscaledTime = Time.unscaledTime;
 
-            if (!_gameManager.IsReplayMode)
-            {
-                float gameTimerDelta = Mathf.Approximately(Time.timeScale, 0f)
-                    ? 0f
-                    : unscaledDelta;
-
-                UpdatePracticeTimer(gameTimerDelta);
-                UpdateBattleTimer(gameTimerDelta);
-            }
-
             UpdateSessionTimer(unscaledDelta);
-            DispatchPendingReplayTimeUp();
+            DispatchPendingTimeUp();
         }
 
         internal void FixedTick()
         {
-            if (!_gameManager.IsReplayMode || Mathf.Approximately(Time.timeScale, 0f))
+            if (Mathf.Approximately(Time.timeScale, 0f))
                 return;
 
-            UpdatePracticeTimer(Time.fixedDeltaTime);
-            UpdateBattleTimer(Time.fixedDeltaTime, true);
+            float gameTimerDelta = _gameManager != null && _gameManager.IsReplayMode
+                ? Time.fixedDeltaTime
+                : Time.fixedUnscaledDeltaTime;
+
+            UpdatePracticeTimer(gameTimerDelta);
+            UpdateBattleTimer(gameTimerDelta);
         }
 
         public void Reset()
@@ -120,6 +114,19 @@ namespace Hyper.Internal.Managers
             _lastUnscaledTime = Time.unscaledTime;
         }
 
+        internal void ResetForGameRestart()
+        {
+            _practiceTimer = 0f;
+            _battleTimer = _gameManager != null ? _gameManager.Config.TimeLimit : 0f;
+            _isPracticeRunning = false;
+            _isBattleRunning = false;
+            _timeUpTriggered = false;
+            _timeUpPending = false;
+            _hasGameEnded = false;
+            _hasGameStarted = false;
+            _lastUnscaledTime = Time.unscaledTime;
+        }
+
         public void ResumeGameTimersAfterPause()
         {
             if (_gameManager.IsBattleMode)
@@ -150,7 +157,7 @@ namespace Hyper.Internal.Managers
         public void StopAllTimers()
         {
             _hasGameEnded = true;
-            _replayTimeUpPending = false;
+            _timeUpPending = false;
             StopBattle();
             StopPractice();
         }
@@ -262,7 +269,7 @@ namespace Hyper.Internal.Managers
             }
         }
 
-        private void UpdateBattleTimer(float delta, bool deferTimeUp = false)
+        private void UpdateBattleTimer(float delta)
         {
             if (_isBattleRunning)
             {
@@ -280,7 +287,7 @@ namespace Hyper.Internal.Managers
                     _battleTimer = 0;
                     if (!_timeUpTriggered)
                     {
-                        TriggerTimeUp(deferTimeUp);
+                        QueueTimeUp();
                     }
                 }
             }
@@ -292,30 +299,23 @@ namespace Hyper.Internal.Managers
 
                     if (_battleTimer <= 0 && !_timeUpTriggered)
                     {
-                        TriggerTimeUp(deferTimeUp);
+                        QueueTimeUp();
                     }
                 }
             }
         }
 
-        private void TriggerTimeUp(bool defer)
+        private void QueueTimeUp()
         {
-            if (defer)
-            {
-                _replayTimeUpPending = true;
-                return;
-            }
-
-            _timeUpTriggered = true;
-            _eventManager?.InvokeTimeUpEvent();
+            _timeUpPending = true;
         }
 
-        private void DispatchPendingReplayTimeUp()
+        private void DispatchPendingTimeUp()
         {
-            if (!_replayTimeUpPending)
+            if (!_timeUpPending)
                 return;
 
-            _replayTimeUpPending = false;
+            _timeUpPending = false;
             if (_hasGameEnded || _timeUpTriggered)
                 return;
 

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

@@ -132,6 +132,32 @@ namespace Hyper.Internal
             if (progressSlider != null) progressSlider.SetValueWithoutNotify(1f);
         }
 
+        internal void ResetForReplayRestart()
+        {
+            float playbackSpeed = ReplaySessionState.UserPlaybackSpeed;
+            if (!ReplaySessionState.IsSeeking && playbackSpeeds != null && playbackSpeeds.Length > 0)
+            {
+                playbackSpeed = SanitizePlaybackSpeed(playbackSpeeds[0]);
+                ReplaySessionState.SetPlaybackSpeed(playbackSpeed);
+                Time.timeScale = playbackSpeed;
+            }
+
+            isCapturingSeek = false;
+            pendingSeekTarget = ReplaySessionState.IsSeeking
+                ? ReplaySessionState.SeekTarget01
+                : 0f;
+            wasSeeking = ReplaySessionState.IsSeeking;
+
+            if (progressSlider != null)
+            {
+                progressSlider.SetValueWithoutNotify(pendingSeekTarget);
+            }
+
+            UpdatePlaybackSpeedLabel(playbackSpeed);
+            AlignPlaybackSpeedIndex(playbackSpeed);
+            SetSeekingPresentation(ReplaySessionState.IsSeeking);
+        }
+
         private void ExitReplay()
         {
             if (exitButton != null) exitButton.interactable = false;

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

@@ -23,6 +23,13 @@ namespace Hyper.Internal
             if (exitButton != null) exitButton.onClick.AddListener(Exit);
         }
 
+        private void OnEnable()
+        {
+            _handled = false;
+            if (watchAgainButton != null) watchAgainButton.interactable = true;
+            if (exitButton != null) exitButton.interactable = true;
+        }
+
         private void OnDestroy()
         {
             if (watchAgainButton != null) watchAgainButton.onClick.RemoveListener(WatchAgain);

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

@@ -14,7 +14,7 @@ namespace Hyper.Internal
         [SerializeField] private BlinkingText blinkingText;
         [SerializeField] private RectTransform swipeGif;
         [SerializeField] private RectTransform handSpriteInGif;
-        [SerializeField] private float replayAutoStartDelay = 2f;
+        [SerializeField] private float replayAutoStartDelay = 1f;
         private GameManager _gameManager;
         private StartCTA _currentCTA;
         private SwipeDirection _swipeDirection;

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.1",
+  "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",