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

package/CHANGELOG.md

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

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