app.hypergames.hypersdk 1.11.0-beta.24 → 1.11.0-beta.26

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.11.0-beta.26](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.25...v1.11.0-beta.26) (2026-09-07)
+
+
+### Bug Fixes
+
+* **sample:** refine replay integration template ([5a345df](https://github.com/mvmhyper/hyper-sdk/commit/5a345df87d19a6df11af4117fbeed1e21e8e9f9a))
+
+# [1.11.0-beta.25](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.24...v1.11.0-beta.25) (2026-09-04)
+
+
+### Features
+
+* **replay:** include final score metadata ([463dcad](https://github.com/mvmhyper/hyper-sdk/commit/463dcadd4df5e5684f3be328b0ec361f25f26f2a))
+
 # [1.11.0-beta.24](https://github.com/mvmhyper/hyper-sdk/compare/v1.11.0-beta.23...v1.11.0-beta.24) (2026-09-04)
 
 

package/Runtime/Internal/Bootstrap/HyperLoader.cs

@@ -448,7 +448,11 @@ namespace Hyper.Internal
                     return false;
                 }
 
-                ReplaySessionState.SetMetadata(replay.PlayerName, replay.AvatarUrl, replay.Seed);
+                ReplaySessionState.SetMetadata(
+                    replay.PlayerName,
+                    replay.AvatarUrl,
+                    replay.Seed,
+                    replay.FinalScore);
                 ReplaySessionState.SetReplayData(replay.ActivityNdjson);
                 HyperDebug.Log($"Replay loaded from {path}");
                 return true;

package/Runtime/Internal/Managers/BackendManager.cs

@@ -179,7 +179,8 @@ namespace Hyper.Internal.Managers
                             ReplaySessionState.SetMetadata(
                                 replay.PlayerName,
                                 replay.AvatarUrl,
-                                replay.Seed);
+                                replay.Seed,
+                                replay.FinalScore);
                             ReplaySessionState.SetReplayData(replay.ActivityNdjson);
                             HyperDebug.Log($"Replay downloaded for entry {entryId}.");
                             onSuccess?.Invoke();
@@ -289,9 +290,10 @@ namespace Hyper.Internal.Managers
                 string seedLine = reader.ReadLine();
                 string nameLine = reader.ReadLine();
                 string avatarLine = reader.ReadLine();
+                string scoreLine = reader.ReadLine();
                 string activities = reader.ReadToEnd();
 
-                if (seedLine == null || nameLine == null || avatarLine == null)
+                if (seedLine == null || nameLine == null || avatarLine == null || scoreLine == null)
                 {
                     error = "The replay response is missing required metadata.";
                     return false;
@@ -302,6 +304,7 @@ namespace Hyper.Internal.Managers
                     JArray seedData = JArray.Parse(seedLine);
                     JArray nameData = JArray.Parse(nameLine);
                     JArray avatarData = JArray.Parse(avatarLine);
+                    JArray scoreData = JArray.Parse(scoreLine);
 
                     if (seedData.Count != 1 ||
                         seedData[0].Type != JTokenType.Integer ||
@@ -327,6 +330,18 @@ namespace Hyper.Internal.Managers
                         return false;
                     }
 
+                    if (scoreData.Count != 1 ||
+                        scoreData[0].Type != JTokenType.Integer ||
+                        !int.TryParse(
+                            scoreData[0].ToString(),
+                            NumberStyles.Integer,
+                            CultureInfo.InvariantCulture,
+                            out int finalScore))
+                    {
+                        error = "Replay metadata contains an invalid final score.";
+                        return false;
+                    }
+
                     if (string.IsNullOrWhiteSpace(activities))
                     {
                         error = "The replay response contains no gameplay activities.";
@@ -337,6 +352,7 @@ namespace Hyper.Internal.Managers
                         seed,
                         nameData[0].Value<string>() ?? string.Empty,
                         avatarData[0].Value<string>() ?? string.Empty,
+                        finalScore,
                         activities);
 
                     return true;
@@ -354,13 +370,20 @@ namespace Hyper.Internal.Managers
             internal long Seed { get; }
             internal string PlayerName { get; }
             internal string AvatarUrl { get; }
+            internal int FinalScore { get; }
             internal string ActivityNdjson { get; }
 
-            internal ReplayResponse(long seed, string playerName, string avatarUrl, string activityNdjson)
+            internal ReplayResponse(
+                long seed,
+                string playerName,
+                string avatarUrl,
+                int finalScore,
+                string activityNdjson)
             {
                 Seed = seed;
                 PlayerName = playerName;
                 AvatarUrl = avatarUrl;
+                FinalScore = finalScore;
                 ActivityNdjson = activityNdjson;
             }
         }

package/Runtime/Internal/Managers/DataManager.cs

@@ -375,6 +375,7 @@ namespace Hyper.Internal.Managers
                 new object[] { HyperRandom.CurrentSeed }));
             _editorReplay.AppendLine(JsonConvert.SerializeObject(new object[] { "hypergamer" }));
             _editorReplay.AppendLine(JsonConvert.SerializeObject(new object[] { string.Empty }));
+            _editorReplayMetadataLength = _editorReplay.Length;
 #endif
             _replayRecorder?.StartSession();
         }
@@ -426,6 +427,7 @@ namespace Hyper.Internal.Managers
 
 #if UNITY_EDITOR
         private readonly StringBuilder _editorReplay = new StringBuilder(4096);
+        private int _editorReplayMetadataLength;
 
         private void CaptureEditorReplayActivity(object[] activity)
         {
@@ -434,6 +436,8 @@ namespace Hyper.Internal.Managers
 
         private void SaveEditorReplay()
         {
+            string finalScoreLine = JsonConvert.SerializeObject(new object[] { CurrentScore }) + Environment.NewLine;
+            _editorReplay.Insert(_editorReplayMetadataLength, finalScoreLine);
             try
             {
                 File.WriteAllText(ReplaySessionState.EditorReplayFilePath, _editorReplay.ToString());
@@ -443,6 +447,10 @@ namespace Hyper.Internal.Managers
             {
                 HyperDebug.LogWarning($"Unable to save Editor replay: {exception.Message}");
             }
+            finally
+            {
+                _editorReplay.Remove(_editorReplayMetadataLength, finalScoreLine.Length);
+            }
         }
 #endif
 

package/Runtime/Internal/Replay/ReplaySessionState.cs

@@ -14,6 +14,7 @@ namespace Hyper.Internal
         public static string AvatarUrl { get; private set; }
         public static string EntryId { get; private set; }
         public static string ReplayNdjson { get; private set; }
+        public static int? FinalScore { get; private set; }
         public static Texture2D AvatarTexture { get; private set; }
         public static bool HasReplayData => !string.IsNullOrWhiteSpace(ReplayNdjson);
         public static long OriginalRandomSeed { get; private set; }
@@ -48,6 +49,7 @@ namespace Hyper.Internal
             AvatarUrl = avatarUrl ?? string.Empty;
             EntryId = entryId ?? string.Empty;
             ReplayNdjson = string.Empty;
+            FinalScore = null;
             ReleaseAvatarTexture();
             OriginalRandomSeed = originalRandomSeed;
             Progress01 = 0f;
@@ -61,13 +63,18 @@ namespace Hyper.Internal
             GameplayStartProgress01 = 0f;
         }
 
-        public static void SetMetadata(string playerName, string avatarUrl, long originalRandomSeed)
+        public static void SetMetadata(
+            string playerName,
+            string avatarUrl,
+            long originalRandomSeed,
+            int finalScore)
         {
             if (!IsActive) return;
 
             PlayerName = playerName ?? string.Empty;
             AvatarUrl = avatarUrl ?? string.Empty;
             OriginalRandomSeed = originalRandomSeed;
+            FinalScore = finalScore;
         }
 
         public static void SetReplayData(string ndjson)
@@ -193,6 +200,7 @@ namespace Hyper.Internal
             AvatarUrl = string.Empty;
             EntryId = string.Empty;
             ReplayNdjson = string.Empty;
+            FinalScore = null;
             ReleaseAvatarTexture();
             OriginalRandomSeed = 0;
             Progress01 = 0f;

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

@@ -1,3 +1,4 @@
+using System.Globalization;
 using TMPro;
 using UnityEngine;
 using UnityEngine.UI;
@@ -38,7 +39,7 @@ namespace Hyper.Internal
 
             if (scoreValue != null)
             {
-                scoreValue.text = (HyperRuntime.DataManager?.CurrentScore ?? 0).ToString("N0");
+                scoreValue.text = FormatFinalScore(ReplaySessionState.FinalScore);
             }
 
             if (scoreOwnerName != null)
@@ -99,6 +100,13 @@ namespace Hyper.Internal
                 : $"@{normalizedName.ToUpperInvariant()}'S SCORE";
         }
 
+        internal static string FormatFinalScore(int? finalScore)
+        {
+            return finalScore.HasValue
+                ? finalScore.Value.ToString("N0", CultureInfo.InvariantCulture)
+                : "--";
+        }
+
         private void UpdateSoundPresentation()
         {
             bool isSoundOn = HyperRuntime.DataManager == null || HyperRuntime.DataManager.GetSound() == 1;

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

@@ -134,7 +134,7 @@ Rigidbody:
   m_ImplicitTensor: 1
   m_UseGravity: 0
   m_IsKinematic: 1
-  m_Interpolate: 0
+  m_Interpolate: 1
   m_Constraints: 0
   m_CollisionDetection: 0
 --- !u!114 &3724547471223867592

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

@@ -134,7 +134,7 @@ Rigidbody:
   m_ImplicitTensor: 1
   m_UseGravity: 0
   m_IsKinematic: 1
-  m_Interpolate: 0
+  m_Interpolate: 1
   m_Constraints: 0
   m_CollisionDetection: 0
 --- !u!114 &6935381596637914183

package/Samples~/LaneRunner/README.md

@@ -13,8 +13,10 @@ 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 supports custom replay restarts, but enable **Replay Custom Restart**
+only after repeated Watch Again tests reproduce the original run. Enable
+**Allow Replay Seeking** only after accelerated reconstruction is stable on
+desktop and mobile WebGL.
 
 The sample uses only Unity's built-in `Default` layer, `Untagged`, and
 `MainCamera`. Its collider overrides and ground safety do not require changes to
@@ -40,3 +42,18 @@ HyperSDK.Replay.OnAction += HandleReplayAction;
 
 `RecordActivity` records only during active Battle gameplay. The SDK owns replay
 timestamps, file loading, scheduling, pause handling, progress, and completion.
+
+## Replay integration checklist
+
+1. Read physical input in `Update`, queue commands, and consume them in
+   `FixedUpdate` with gameplay and physics.
+2. Record only commands the game accepts, then route `HyperSDK.Replay.OnAction`
+   through the same command path.
+3. Use `HyperRandom` for gameplay randomness and interpolate moving Rigidbodies
+   so fixed simulation still renders smoothly.
+4. Verify the original replay and repeated Watch Again runs at every supported
+   speed on desktop and mobile WebGL.
+5. Leave **Replay Custom Restart** disabled unless the game clears all gameplay
+   state, spawned objects, coroutines, pools, and cached references correctly.
+6. Leave **Allow Replay Seeking** disabled for physics-heavy games unless their
+   accelerated reconstruction has been tested and remains deterministic.

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

@@ -47,7 +47,7 @@ namespace HyperSamples.LaneRunner
                 }
 
                 item.Advance(distance);
-                if (item.transform.position.x < despawnX)
+                if (item.PositionX < despawnX)
                     RemoveItemAt(i);
             }
 

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

@@ -2,14 +2,21 @@ using UnityEngine;
 
 namespace HyperSamples.LaneRunner
 {
-    [RequireComponent(typeof(Collider))]
+    [RequireComponent(typeof(Collider), typeof(Rigidbody))]
     public sealed class LaneRunnerTrackItem : MonoBehaviour
     {
         [SerializeField] private bool doubleScorePickup;
 
         public bool IsCollected { get; private set; }
+        public float PositionX => body.position.x;
 
         private LaneRunnerGame game;
+        private Rigidbody body;
+
+        private void Awake()
+        {
+            body = GetComponent<Rigidbody>();
+        }
 
         public void Initialize(LaneRunnerGame owner)
         {
@@ -19,7 +26,7 @@ namespace HyperSamples.LaneRunner
 
         public void Advance(float distance)
         {
-            transform.position += Vector3.left * distance;
+            body.MovePosition(body.position + Vector3.left * distance);
         }
 
         private void OnTriggerEnter(Collider other)

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

@@ -40,6 +40,7 @@ namespace HyperSamples.LaneRunner
         private void HandleCustomRestart()
         {
             game.Stop();
+            // The SDK rewinds replay state and RNG before OnGameStart rebuilds the run.
             HyperSDK.Game.CompleteCustomRestart();
         }
 

package/package.json

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