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

package/CHANGELOG.md

@@ -1,3 +1,149 @@
+# [1.11.0-beta.21](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.20...v1.11.0-beta.21) (2026-09-03)
+
+
+### Bug Fixes
+
+* **replay:** align gameplay activities to fixed ticks ([1e681b9](https://github.com/mvmhyper/hyper-sdk/commit/1e681b9c7f314a48c417f6e76cb2d4024c890ad3))
+
+# [1.11.0-beta.20](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.19...v1.11.0-beta.20) (2026-09-02)
+
+
+### Bug Fixes
+
+* **replay:** separate replay restart configuration ([de01d37](https://github.com/mvmhyper/hyper-sdk/commit/de01d37027fdde5d4f8803fa10e060d48a080316))
+
+# [1.11.0-beta.19](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.18...v1.11.0-beta.19) (2026-09-01)
+
+
+### Bug Fixes
+
+* **replay:** stop seeking at requested progress ([54bf74a](https://github.com/mvmhyper/hyper-sdk/commit/54bf74a4b66b7c19e1398acd611a7d9557ccbcf3))
+
+# [1.11.0-beta.18](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.17...v1.11.0-beta.18) (2026-09-01)
+
+
+### Features
+
+* **replay:** support custom replay restarts ([bf722ab](https://github.com/mvmhyper/hyper-sdk/commit/bf722abe48add18c356922c60231cb2017e28443))
+
+# [1.11.0-beta.17](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.16...v1.11.0-beta.17) (2026-09-01)
+
+
+### Features
+
+* **replay:** refine seek loading progress ([3d01f94](https://github.com/mvmhyper/hyper-sdk/commit/3d01f94d7e6ce360a61dd3d257149cf7f3237bcb))
+
+# [1.11.0-beta.16](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.15...v1.11.0-beta.16) (2026-08-31)
+
+
+### Bug Fixes
+
+* **replay:** show seek preparation progress ([60213f7](https://github.com/mvmhyper/hyper-sdk/commit/60213f784c5bff39da4634590545fe4d0e4c0911))
+
+# [1.11.0-beta.15](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.14...v1.11.0-beta.15) (2026-08-31)
+
+
+### Features
+
+* **replay:** show seek completion progress ([4e7c1b8](https://github.com/mvmhyper/hyper-sdk/commit/4e7c1b807bd9f34b97477ef39aa9ca3c06316ef3))
+
+# [1.11.0-beta.14](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.13...v1.11.0-beta.14) (2026-08-31)
+
+
+### Bug Fixes
+
+* **replay:** keep seek loader animating ([7e13938](https://github.com/mvmhyper/hyper-sdk/commit/7e13938ce718a238506c08c30744ff24ed7fa710))
+
+# [1.11.0-beta.13](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.12...v1.11.0-beta.13) (2026-08-31)
+
+
+### Bug Fixes
+
+* **replay:** reduce default seek speed to 10x ([ccaf5b9](https://github.com/mvmhyper/hyper-sdk/commit/ccaf5b9807fd9439627072518317ad7f079e544c))
+
+# [1.11.0-beta.12](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.11...v1.11.0-beta.12) (2026-08-31)
+
+
+### Bug Fixes
+
+* **replay:** reduce default seek speed ([d757710](https://github.com/mvmhyper/hyper-sdk/commit/d757710d107a0a496c9d7daa1434004a682bd355))
+
+# [1.11.0-beta.11](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.10...v1.11.0-beta.11) (2026-08-30)
+
+
+### Bug Fixes
+
+* **replay:** apply 30x seek speed on beta ([564769e](https://github.com/mvmhyper/hyper-sdk/commit/564769e4764f27fd301f0e1dc52a4434635f93b7))
+* **replay:** reduce default seek speed ([2cd0a34](https://github.com/mvmhyper/hyper-sdk/commit/2cd0a34c6390725d1c57fc3fa5f691f618c45083))
+
+
+### Features
+
+* **replay:** increase default seek speed ([d1a5a46](https://github.com/mvmhyper/hyper-sdk/commit/d1a5a464c1e3e149255bf0d2d183439e9c29cfb3))
+
+# [1.11.0-beta.10](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.9...v1.11.0-beta.10) (2026-08-30)
+
+
+### Bug Fixes
+
+* **replay:** reduce default seek speed ([f70551a](https://github.com/mvmhyper/hyper-sdk/commit/f70551aea942274ace1cb952ddae4e9edb0c1c12))
+
+# [1.11.0-beta.9](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.8...v1.11.0-beta.9) (2026-08-30)
+
+
+### Bug Fixes
+
+* **replay:** show loader while exiting paused replay ([4a2e7a6](https://github.com/mvmhyper/hyper-sdk/commit/4a2e7a6045017ea8ed3ae3525271440dbf013e6c))
+
+# [1.11.0-beta.8](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.7...v1.11.0-beta.8) (2026-08-30)
+
+
+### Bug Fixes
+
+* **replay:** mute audio while seeking ([5ab8cd1](https://github.com/mvmhyper/hyper-sdk/commit/5ab8cd1411493cb5add07b51dc190c85251f99d2))
+
+# [1.11.0-beta.7](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.6...v1.11.0-beta.7) (2026-08-30)
+
+
+### Bug Fixes
+
+* **replay:** stabilize scene reload seeking ([dd9ac63](https://github.com/mvmhyper/hyper-sdk/commit/dd9ac632d08349d9578f64ae0b2dc2ab905a26af))
+
+# [1.11.0-beta.6](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.5...v1.11.0-beta.6) (2026-08-29)
+
+
+### Bug Fixes
+
+* **timer:** restore gameplay timers after pause ([ca82d57](https://github.com/mvmhyper/hyper-sdk/commit/ca82d57df87618807cbae611c0a9d6acc14f8470))
+
+# [1.11.0-beta.5](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.4...v1.11.0-beta.5) (2026-08-28)
+
+
+### Bug Fixes
+
+* **replay:** wait for custom restart readiness ([43f1aeb](https://github.com/mvmhyper/hyper-sdk/commit/43f1aeb6a127c8c12dbb8379e7230d64ef5e0763))
+
+
+### Features
+
+* **replay:** add replay pause controls ([b9fb470](https://github.com/mvmhyper/hyper-sdk/commit/b9fb470e65c69e66a8a9611b0caa7e5417b1e4bf))
+* **replay:** update replay control bar assets ([79ce8c0](https://github.com/mvmhyper/hyper-sdk/commit/79ce8c0f1b68129ae5b8bcf18a302117cf11c885))
+
+# [1.11.0-beta.4](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.3...v1.11.0-beta.4) (2026-08-28)
+
+
+### Bug Fixes
+
+* **replay:** align recording with fixed simulation ([ae2b322](https://github.com/mvmhyper/hyper-sdk/commit/ae2b32216a0a9ea125572d788eee3bfd846414b0))
+
+# [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/Editor/Scripts/Inspectors/HyperSDKSettingsEditor.cs

@@ -170,6 +170,12 @@ namespace Hyper.Editor
                 settings.useCustomRestartFlow = EditorGUILayout.Toggle(
                         new GUIContent("Use Custom Restart Flow"),
                         settings.useCustomRestartFlow);
+                settings.useCustomReplayRestartFlow = EditorGUILayout.Toggle(
+                        new GUIContent(
+                            "Use Custom Replay Restart Flow",
+                            "Use game-owned restart logic for replay Watch Again and seeking. " +
+                            "Disabled uses HyperLoader to rebuild deterministic game state."),
+                        settings.useCustomReplayRestartFlow);
 
                 EditorGUILayout.Space(12);
                 // Draw Editor Testing            

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
@@ -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

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -15,11 +15,16 @@ namespace Hyper.Internal
     /// </summary>
     internal static class HyperRuntime
     {
+        private const float ReplayCustomRestartTimeoutSeconds = 10f;
+
         private static HyperRuntimeHost _host;
         private static GameObject _singletonObject;
 
         private static bool _isInitialized;
         private static bool _isSoftRestarting;
+        private static bool _replayRandomResetPending;
+        private static bool _replayCustomRestartPending;
+        private static int _replayCustomRestartVersion;
         private static bool _customLoadingComplete;
         private static bool _customLoadingActive;
         private static float _customLoadingProgress;
@@ -32,6 +37,7 @@ namespace Hyper.Internal
         private static EventManager _eventManager;
         private static TimerManager _timerManager;
         private static ReplayManager _replayManager;
+        private static double _fixedSimulationTimeSeconds;
 
         internal static bool IsInitialized => _isInitialized;
         internal static bool IsSoftRestarting
@@ -39,6 +45,7 @@ namespace Hyper.Internal
             get => _isSoftRestarting;
             set => _isSoftRestarting = value;
         }
+        internal static bool IsReplayCustomRestartPending => _replayCustomRestartPending;
         internal static bool CustomLoadingComplete
         {
             get => _customLoadingComplete;
@@ -58,6 +65,7 @@ namespace Hyper.Internal
         internal static EventManager EventManager => _eventManager;
         internal static TimerManager Timer => _timerManager;
         internal static ReplayManager ReplayManager => _replayManager;
+        internal static double FixedSimulationTimeSeconds => _fixedSimulationTimeSeconds;
 
         internal static event Action CustomLoadingStarted
         {
@@ -118,8 +126,8 @@ namespace Hyper.Internal
         }
 
         /// <summary>
-        /// Restarts replay playback while preserving its downloaded data and original seed.
-        /// Uses the configured custom restart flow when available, otherwise reloads HyperLoader.
+        /// Restarts replay playback while preserving replay session data. Uses the game-owned
+        /// replay restart flow only when explicitly enabled and otherwise reloads HyperLoader.
         /// </summary>
         internal static void RestartReplaySession()
         {
@@ -141,17 +149,66 @@ namespace Hyper.Internal
             _isSoftRestarting = true;
             Time.timeScale = 1f;
 
-            if (_settings != null && _settings.useCustomRestartFlow &&
-                _gameManager != null && _eventManager != null)
+            _replayCustomRestartPending = false;
+            _replayRandomResetPending = false;
+            int restartVersion = ++_replayCustomRestartVersion;
+            _replayManager?.PrepareForRestart();
+
+            if (_settings != null && _settings.useCustomReplayRestartFlow &&
+                _host != null && _gameManager != null && _eventManager != null)
             {
-                _replayManager?.PrepareForRestart();
-                ResetReplayRandomState();
+                _replayCustomRestartPending = true;
+                _replayRandomResetPending = true;
                 _gameManager.ResetUIStateForCustomRestart();
-                _eventManager.InvokeCustomRestartEvent();
-                _isSoftRestarting = false;
-                return;
+
+                try
+                {
+                    if (!_eventManager.InvokeCustomRestartEvent())
+                    {
+                        HyperDebug.LogWarning(
+                            "[Replay] Custom restart has no handler; falling back to HyperLoader.");
+                        BeginReplaySceneRestart(restartVersion);
+                        return;
+                    }
+
+                    _host.StartCoroutine(WaitForReplayCustomRestart(restartVersion));
+                    return;
+                }
+                catch (Exception exception)
+                {
+                    HyperDebug.LogWarning(
+                        $"[Replay] Custom restart failed; falling back to HyperLoader: {exception.Message}");
+                    BeginReplaySceneRestart(restartVersion);
+                    return;
+                }
             }
 
+            BeginReplaySceneRestart(restartVersion);
+        }
+
+        private static IEnumerator WaitForReplayCustomRestart(int restartVersion)
+        {
+            float timeoutAt = Time.realtimeSinceStartup + ReplayCustomRestartTimeoutSeconds;
+            while (_replayCustomRestartPending && restartVersion == _replayCustomRestartVersion &&
+                   Time.realtimeSinceStartup < timeoutAt)
+            {
+                yield return null;
+            }
+
+            if (!_replayCustomRestartPending || restartVersion != _replayCustomRestartVersion) yield break;
+
+            HyperDebug.LogWarning(
+                $"[Replay] Custom restart did not complete within {ReplayCustomRestartTimeoutSeconds:0} seconds; " +
+                "falling back to HyperLoader.");
+            BeginReplaySceneRestart(restartVersion);
+        }
+
+        private static void BeginReplaySceneRestart(int restartVersion)
+        {
+            if (restartVersion != _replayCustomRestartVersion) return;
+
+            _replayCustomRestartPending = false;
+            _replayRandomResetPending = false;
             if (_host != null)
             {
                 _host.StartCoroutine(RestartSessionCoroutine());
@@ -176,6 +233,34 @@ namespace Hyper.Internal
             HyperRandom.Init(ReplaySessionState.OriginalRandomSeed);
         }
 
+        internal static void ApplyPendingReplayRandomReset()
+        {
+            if (!_replayRandomResetPending) return;
+
+            _replayRandomResetPending = false;
+            ResetReplayRandomState();
+        }
+
+        internal static void DeferReplayRandomReset()
+        {
+            _replayRandomResetPending = true;
+        }
+
+        internal static void CompleteCustomRestart()
+        {
+            if (!_replayCustomRestartPending || _host == null) return;
+
+            _replayCustomRestartPending = false;
+            _host.StartCoroutine(CompleteReplayCustomRestartNextFrame());
+        }
+
+        private static IEnumerator CompleteReplayCustomRestartNextFrame()
+        {
+            yield return null;
+            _gameManager?.CompleteReplayCustomRestart();
+            _isSoftRestarting = false;
+        }
+
         /// <summary>
         /// Coroutine-based restart that properly unloads all scenes before reloading.
         /// Handles async scene operations and ensures clean state before restart.
@@ -184,6 +269,7 @@ namespace Hyper.Internal
         {
             yield return UnloadAllScenesCoroutine();
 
+            Clear();
             ClearAllDontDestroyOnLoadObjects();
             SceneManager.LoadScene("HyperLoader");
         }
@@ -381,6 +467,7 @@ namespace Hyper.Internal
         internal static void FixedTick()
         {
             if (!_isInitialized) return;
+            _fixedSimulationTimeSeconds += Time.fixedDeltaTime;
             _replayManager?.FixedTick();
             _timerManager?.FixedTick();
         }
@@ -414,6 +501,10 @@ namespace Hyper.Internal
             _customLoadingComplete = false;
             _customLoadingActive = false;
             _customLoadingProgress = 0f;
+            _replayRandomResetPending = false;
+            _replayCustomRestartPending = false;
+            _replayCustomRestartVersion++;
+            _fixedSimulationTimeSeconds = 0d;
 
             if (_singletonObject != null)
             {
@@ -472,6 +563,10 @@ namespace Hyper.Internal
             _customLoadingComplete = false;
             _customLoadingActive = false;
             _customLoadingProgress = 0f;
+            _replayRandomResetPending = false;
+            _replayCustomRestartPending = false;
+            _replayCustomRestartVersion++;
+            _fixedSimulationTimeSeconds = 0d;
         }
     }
 }

package/Runtime/Internal/Managers/DataManager.cs

@@ -219,6 +219,7 @@ namespace Hyper.Internal.Managers
         internal void ConfigurePlayerSoundSetting()
         {
             SetSound(GetSound());
+            ReplaySessionState.EnsureAudioMutedDuringSeek();
             if (_gameManager == null) _gameManager = HyperRuntime.GameManager;
         }
 
@@ -462,7 +463,7 @@ namespace Hyper.Internal.Managers
 
         private static double GetSimulationTimeSeconds()
         {
-            return Time.fixedTimeAsDouble;
+            return HyperRuntime.FixedSimulationTimeSeconds;
         }
 
         private ScoreData GetPooledScoreData()

package/Runtime/Internal/Managers/EventManager.cs

@@ -79,7 +79,13 @@ namespace Hyper.Internal.Managers
         internal void InvokeGameEndedEvent() => OnGameEnded?.Invoke();
         internal void InvokeLivesExhaustedEvent() => OnLivesExhausted?.Invoke();
         internal void InvokeHealthExhaustedEvent() => OnHealthExhausted?.Invoke();
-        internal void InvokeCustomRestartEvent() => OnCustomRestart?.Invoke();
+        internal bool InvokeCustomRestartEvent()
+        {
+            Action handler = OnCustomRestart;
+            if (handler == null) return false;
+            handler.Invoke();
+            return true;
+        }
         internal void InvokeConnectionLostEvent() => OnInternetConnectionLost?.Invoke();
         internal void InvokeConnectionFoundEvent() => OnInternetConnectionFound?.Invoke();
         internal void InvokeBackendSocketManuallyClosedEvent() => OnBackendSocketManuallyClosed?.Invoke();

package/Runtime/Internal/Managers/GameManager.cs

@@ -191,6 +191,41 @@ namespace Hyper.Internal.Managers
             Resources.UnloadUnusedAssets();
         }
 
+        internal void PauseReplay()
+        {
+            if (!IsReplayMode || !_hasGameStarted || _isPaused || _hasGameEnded)
+            {
+                return;
+            }
+
+            _isPaused = true;
+            _savedReplayTimeScale = Time.timeScale > 0f
+                ? Time.timeScale
+                : ReplaySessionState.PlaybackSpeed;
+            Time.timeScale = 0f;
+            HyperRuntime.Timer.PauseGameplayTimers();
+
+            _previousTimeScale = 0f;
+            _eventManager.InvokeTimeScaleFrozenEvent();
+            ReplayPresentationCanvas.SetSeekingLayer(false);
+            SetBlockerActive(true);
+            ShowReplayPauseModal();
+        }
+
+        internal void ResumeReplay()
+        {
+            if (!IsReplayMode || !_isPaused || _hasGameEnded) return;
+
+            _isPaused = false;
+            HidePauseModals();
+            Time.timeScale = _savedReplayTimeScale > 0f ? _savedReplayTimeScale : 1f;
+            HyperRuntime.Timer.ResumeGameTimersAfterPause();
+
+            _previousTimeScale = Time.timeScale;
+            _eventManager.InvokeTimeScaleResumedEvent();
+            ReplayPresentationCanvas.SetSeekingLayer(ReplaySessionState.IsSeeking);
+        }
+
         internal void ResumeGame()
         {
             _isPaused = false;
@@ -222,51 +257,7 @@ namespace Hyper.Internal.Managers
         private void HandleReplayFocus(bool hasFocus)
         {
             if (!_hasGameStarted || _hasGameEnded) return;
-
-            if (!hasFocus && _replayFocusResumeCoroutine != null)
-            {
-                StopCoroutine(_replayFocusResumeCoroutine);
-                _replayFocusResumeCoroutine = null;
-            }
-
-            if (!hasFocus && !_replayFocusSuspended)
-            {
-                _replayFocusSuspended = true;
-                _savedReplayTimeScale = Time.timeScale;
-                Time.timeScale = 0f;
-                HyperRuntime.Timer.PauseGameplayTimers();
-
-                // WebGL may stop producing frames immediately after focus loss,
-                // so suspend replay timing here instead of waiting for Update.
-                _previousTimeScale = 0f;
-                _eventManager.InvokeTimeScaleFrozenEvent();
-                HyperDebug.Log("Time scale frozen event invoked");
-            }
-            else if (hasFocus && _replayFocusSuspended)
-            {
-                if (_replayFocusResumeCoroutine == null)
-                {
-                    _replayFocusResumeCoroutine = StartCoroutine(ResumeReplayAfterFocus());
-                }
-            }
-        }
-
-        private IEnumerator ResumeReplayAfterFocus()
-        {
-            // WebGL reports focus before Unity refreshes its unscaled clock. Keep
-            // gameplay and replay frozen briefly while session time continues.
-            yield return new WaitForSecondsRealtime(1f);
-
-            _replayFocusResumeCoroutine = null;
-            if (!_replayFocusSuspended || _hasGameEnded) yield break;
-
-            _replayFocusSuspended = false;
-            Time.timeScale = _savedReplayTimeScale > 0f ? _savedReplayTimeScale : 1f;
-            HyperRuntime.Timer.ResumeGameTimersAfterPause();
-
-            _previousTimeScale = Time.timeScale;
-            _eventManager.InvokeTimeScaleResumedEvent();
-            HyperDebug.Log("Time scale resumed event invoked");
+            if (!hasFocus) PauseReplay();
         }
 
         void HandlePauseState(bool shouldPause)
@@ -552,7 +543,7 @@ namespace Hyper.Internal.Managers
 
         internal void ShowStartGameDeadline(int timeLeft)
         {
-            if (_hasGameStarted || !IsInGameScene) return;
+            if (_hasGameStarted || !IsInGameScene || IsReplayMode) return;
 
             EnsureStartGameDeadlineBar();
             _eventManager.OnSessionAboutToExpire += ChangeDeadlineColorToRed;
@@ -728,7 +719,6 @@ namespace Hyper.Internal.Managers
         private bool _isPortrait;
         private float _previousTimeScale = 1f;
         private float _savedTimeScaleBeforePause = 1f;
-        private bool _replayFocusSuspended;
         private float _savedReplayTimeScale = 1f;
 
         #endregion
@@ -1025,6 +1015,8 @@ namespace Hyper.Internal.Managers
             if (_gameStartRequested || _hasGameStarted || _hasGameEnded || !IsInGameScene) return;
             _gameStartRequested = true;
 
+            HyperRuntime.ApplyPendingReplayRandomReset();
+
             HideStartGameDeadlineSnackBar();
             _dataManager.UpdateScore(0);
             HyperRuntime.Timer.StartActiveGameTimer();
@@ -1062,7 +1054,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()
         {
@@ -1075,7 +1067,6 @@ namespace Hyper.Internal.Managers
             _gameStartRequested = false;
             _hasGameEnded = false;
             _replayEndHandled = false;
-            _replayFocusSuspended = false;
             _isPaused = false;
             _isFrozenBeforePause = false;
 
@@ -1086,6 +1077,12 @@ namespace Hyper.Internal.Managers
             ShowControlBarElements();
             _replayControllerComponent?.ResetForReplayRestart();
 
+            if (IsReplayMode && HyperRuntime.IsReplayCustomRestartPending)
+            {
+                HideStartingInstructionModal();
+                return;
+            }
+
             if (IsReplayMode && ReplaySessionState.IsSeeking)
             {
                 HideStartingInstructionModal();
@@ -1097,6 +1094,20 @@ namespace Hyper.Internal.Managers
             }
         }
 
+        internal void CompleteReplayCustomRestart()
+        {
+            if (!IsReplayMode || _gameStartRequested || _hasGameStarted || _hasGameEnded) return;
+
+            if (ReplaySessionState.IsSeeking)
+            {
+                StartCoroutine(StartSeekingReplayWhenReady());
+            }
+            else
+            {
+                ShowStartingInstructionModal();
+            }
+        }
+
         #endregion
 
         #region Game End Logic
@@ -1138,7 +1149,6 @@ namespace Hyper.Internal.Managers
 
             _replayEndHandled = true;
             _hasGameEnded = true;
-            _replayFocusSuspended = false;
             Time.timeScale = 1f;
             _eventManager.InvokeGameEndedEvent();
             HyperRuntime.Timer.StopAllTimers();
@@ -1160,10 +1170,12 @@ namespace Hyper.Internal.Managers
                 _eventManager.InvokeGameEndedEvent();
             }
 
+            _isPaused = false;
             Time.timeScale = 1f;
             HyperRuntime.Timer.StopAllTimers();
             _dataManager.StopCapturingScores();
             HyperRuntime.BackendManager.StopSendingScores();
+            HidePauseModals();
             _replayControllerComponent?.SetReplayEnded();
             ReplaySessionState.Clear();
             ReplayPresentationCanvas.DestroyCurrent();
@@ -1274,8 +1286,8 @@ namespace Hyper.Internal.Managers
         private GameObject _replayControllerObject;
         private ReplayController _replayControllerComponent;
         private GameObject _replayOverModal;
+        private GameObject _replayPausedModal;
         private Coroutine _replayConnectionCheckCoroutine;
-        private Coroutine _replayFocusResumeCoroutine;
 
         private GameObject _connectionStatusBar;
         private GameObject _startGameDeadlineStatusBar;
@@ -1505,6 +1517,30 @@ namespace Hyper.Internal.Managers
             _replayOverModal.transform.SetAsLastSibling();
         }
 
+        private void ShowReplayPauseModal()
+        {
+            if (_replayPausedModal == null)
+            {
+                if (_canvas == null) CreateCanvas();
+                GameObject prefab = Resources.Load<GameObject>("UIPrefabs/ReplayPausedModal");
+                if (prefab == null)
+                {
+                    HyperDebug.LogWarning("[GameManager] ReplayPausedModal prefab not found.");
+                    ResumeReplay();
+                    return;
+                }
+
+                _replayPausedModal = InstantiateModal(prefab);
+                if (_replayPausedModal.GetComponent<ReplayPausedModal>() == null)
+                {
+                    _replayPausedModal.AddComponent<ReplayPausedModal>();
+                }
+            }
+
+            _replayPausedModal.SetActive(true);
+            _replayPausedModal.transform.SetAsLastSibling();
+        }
+
         private void EnsureConnectionStatusBar()
         {
             if (_connectionStatusBar != null) return;
@@ -1753,6 +1789,7 @@ namespace Hyper.Internal.Managers
         internal void HidePauseModals()
         {
             SetBlockerActive(false);
+            if (_replayPausedModal != null) _replayPausedModal.SetActive(false);
             if (_battleGamePausedModal != null) _battleGamePausedModal.SetActive(false);
             if (_practicePausedModal != null) _practicePausedModal.SetActive(false);
             if (_battleGamePausedLandscapeModal != null) _battleGamePausedLandscapeModal.SetActive(false);

package/Runtime/Internal/Managers/ReplayManager.cs

@@ -36,7 +36,10 @@ namespace Hyper.Internal.Managers
         {
             if (_playback == null || !_playback.IsPlaying) return;
             _playback.Tick();
-            ReplaySessionState.SetProgress(_playback.Progress01);
+            if (ReplaySessionState.SetProgress(_playback.Progress01))
+            {
+                UnityEngine.Time.timeScale = ReplaySessionState.PlaybackSpeed;
+            }
         }
 
         internal void PrepareForRestart()
@@ -74,6 +77,7 @@ namespace Hyper.Internal.Managers
             }
 
             _playback.Begin(ReplaySessionState.ReplayNdjson);
+            ReplaySessionState.SetGameplayStartProgress(_playback.GameplayStartProgress01);
         }
 
         private void HandleGameEnded()