app.hypergames.hypersdk 1.11.0-beta.17 → 1.11.0-beta.18

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [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)
 
 

package/Runtime/Internal/Core/HyperRuntime.cs

@@ -15,6 +15,8 @@ namespace Hyper.Internal
     /// </summary>
     internal static class HyperRuntime
     {
+        private const float ReplayCustomRestartTimeoutSeconds = 10f;
+
         private static HyperRuntimeHost _host;
         private static GameObject _singletonObject;
 
@@ -22,6 +24,7 @@ namespace Hyper.Internal
         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;
@@ -123,7 +126,8 @@ namespace Hyper.Internal
         }
 
         /// <summary>
-        /// Restarts replay playback through HyperLoader while preserving replay session data.
+        /// Restarts replay playback while preserving replay session data. Uses the configured
+        /// game-owned custom restart flow when available and falls back to HyperLoader.
         /// </summary>
         internal static void RestartReplaySession()
         {
@@ -147,8 +151,64 @@ namespace Hyper.Internal
 
             _replayCustomRestartPending = false;
             _replayRandomResetPending = false;
+            int restartVersion = ++_replayCustomRestartVersion;
             _replayManager?.PrepareForRestart();
 
+            if (_settings != null && _settings.useCustomRestartFlow &&
+                _host != null && _gameManager != null && _eventManager != null)
+            {
+                _replayCustomRestartPending = true;
+                _replayRandomResetPending = true;
+                _gameManager.ResetUIStateForCustomRestart();
+
+                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());
@@ -443,6 +503,7 @@ namespace Hyper.Internal
             _customLoadingProgress = 0f;
             _replayRandomResetPending = false;
             _replayCustomRestartPending = false;
+            _replayCustomRestartVersion++;
             _fixedSimulationTimeSeconds = 0d;
 
             if (_singletonObject != null)
@@ -504,6 +565,7 @@ namespace Hyper.Internal
             _customLoadingProgress = 0f;
             _replayRandomResetPending = false;
             _replayCustomRestartPending = false;
+            _replayCustomRestartVersion++;
             _fixedSimulationTimeSeconds = 0d;
         }
     }

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/package.json

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