app.hypergames.hypersdk 1.4.21 → 1.5.0

package/Runtime/Internal/Managers/DataManager.cs

@@ -44,7 +44,7 @@ namespace Hyper.Internal.Managers
         public void UpdateScore(int score)
         {
             if (_gameManager == null) _gameManager = HyperRuntime.GameManager;
-            
+
             if (_gameManager.HasGameEnded) return;
 
             CurrentScore = score;
@@ -56,23 +56,26 @@ namespace Hyper.Internal.Managers
 
             float currentGameSecond = Mathf.Floor(currentTimestamp);
 
-            CurrentScoreData = new ScoreData
+            // Reuse a single ScoreData graph for CurrentScoreData to avoid per-call allocations
+            if (CurrentScoreData == null)
             {
-                cumulativeScore = CurrentScore,
-                timestampUtc = DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(),
-                isFinal = true,
-                scoreSnapshot = new ScoreSnapshot
-                {
-                    scoreTime = currentGameSecond,
-                    scoreDelta = CurrentScore - _lastCapturedScore,
-                    gameplayModifiers = new GameplayModifiers
-                    {
-                        comboModifiers = ComboMultiplier,
-                        globalModifiers = GlobalMultiplier,
-                        activePowerUps = ActivePowerups.ToList()
-                    }
-                }
-            };
+                CurrentScoreData = _currentScoreDataBuffer;
+                CurrentScoreData.scoreSnapshot = _currentSnapshotBuffer;
+                CurrentScoreData.scoreSnapshot.gameplayModifiers = _currentModifiersBuffer;
+            }
+
+            CurrentScoreData.cumulativeScore = CurrentScore;
+            CurrentScoreData.timestampUtc = DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString();
+            CurrentScoreData.isFinal = true;
+
+            var snapshot = CurrentScoreData.scoreSnapshot;
+            snapshot.scoreTime = currentGameSecond;
+            snapshot.scoreDelta = CurrentScore - _lastCapturedScore;
+
+            var modifiers = snapshot.gameplayModifiers;
+            modifiers.comboModifiers = ComboMultiplier;
+            modifiers.globalModifiers = GlobalMultiplier;
+            modifiers.activePowerUps = ActivePowerups;
 
             if (score > GetBestScore())
             {
@@ -130,6 +133,7 @@ namespace Hyper.Internal.Managers
         internal List<ScoreData> PendingScores { get; private set; } = new List<ScoreData>();
         internal TutorialData TutorialData { get; private set; }
         internal bool HasReferencedTutorialResources { get; private set; }
+        private const int SCORE_POOL_CAPACITY = 15;
 
         internal void ConfigurePlayerSoundSetting()
         {
@@ -152,7 +156,7 @@ namespace Hyper.Internal.Managers
         internal void StartCapturingScores()
         {
             if (_gameManager == null) _gameManager = HyperRuntime.GameManager;
-            
+
             if (_scoreCaptureCoroutine == null)
             {
                 _scoreCaptureCoroutine = StartCoroutine(CaptureScoreEverySecond());
@@ -200,6 +204,16 @@ namespace Hyper.Internal.Managers
         private float _lastCapturedGameSecond = -1f;
         private int _lastCapturedScore = 0;
 
+        // Reusable object graph for CurrentScoreData to avoid allocations in UpdateScore()
+        private readonly ScoreData _currentScoreDataBuffer = new ScoreData();
+        private readonly ScoreSnapshot _currentSnapshotBuffer = new ScoreSnapshot();
+        private readonly GameplayModifiers _currentModifiersBuffer = new GameplayModifiers();
+
+        // Pools used for per-second score snapshots captured into PendingScores
+        private readonly Queue<ScoreData> _scoreDataPool = new Queue<ScoreData>();
+        private readonly Queue<ScoreSnapshot> _scoreSnapshotPool = new Queue<ScoreSnapshot>();
+        private readonly Queue<GameplayModifiers> _gameplayModifiersPool = new Queue<GameplayModifiers>();
+
         #endregion
 
         #region Score Capture Logic
@@ -216,23 +230,24 @@ namespace Hyper.Internal.Managers
 
                 if (currentGameSecond > _lastCapturedGameSecond)
                 {
-                    ScoreData newScore = new ScoreData
-                    {
-                        cumulativeScore = CurrentScore,
-                        timestampUtc = DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(),
-                        isFinal = false,
-                        scoreSnapshot = new ScoreSnapshot
-                        {
-                            scoreTime = currentGameSecond,
-                            scoreDelta = CurrentScore - _lastCapturedScore,
-                            gameplayModifiers = new GameplayModifiers
-                            {
-                                comboModifiers = ComboMultiplier,
-                                globalModifiers = GlobalMultiplier,
-                                activePowerUps = ActivePowerups.ToList()
-                            }
-                        }
-                    };
+                    // Get objects from pools to avoid allocations in this hot path
+                    var newScore = GetPooledScoreData();
+                    var snapshot = GetPooledScoreSnapshot();
+                    var modifiers = GetPooledGameplayModifiers();
+
+                    newScore.cumulativeScore = CurrentScore;
+                    newScore.timestampUtc = DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString();
+                    newScore.isFinal = false;
+
+                    snapshot.scoreTime = currentGameSecond;
+                    snapshot.scoreDelta = CurrentScore - _lastCapturedScore;
+
+                    modifiers.comboModifiers = ComboMultiplier;
+                    modifiers.globalModifiers = GlobalMultiplier;
+                    modifiers.activePowerUps = ActivePowerups;
+
+                    snapshot.gameplayModifiers = modifiers;
+                    newScore.scoreSnapshot = snapshot;
 
                     PendingScores.Add(newScore);
 
@@ -244,6 +259,84 @@ namespace Hyper.Internal.Managers
             }
         }
 
+        private ScoreData GetPooledScoreData()
+        {
+            return _scoreDataPool.Count > 0 ? _scoreDataPool.Dequeue() : new ScoreData();
+        }
+
+        private ScoreSnapshot GetPooledScoreSnapshot()
+        {
+            return _scoreSnapshotPool.Count > 0 ? _scoreSnapshotPool.Dequeue() : new ScoreSnapshot();
+        }
+
+        private GameplayModifiers GetPooledGameplayModifiers()
+        {
+            return _gameplayModifiersPool.Count > 0 ? _gameplayModifiersPool.Dequeue() : new GameplayModifiers();
+        }
+
+        internal void ReturnScoreDataToPool(List<ScoreData> scores)
+        {
+            if (scores == null) return;
+
+            for (int i = 0; i < scores.Count; i++)
+            {
+                ReturnScoreDataToPool(scores[i]);
+            }
+        }
+
+        private void ReturnScoreDataToPool(ScoreData data)
+        {
+            if (data == null) return;
+
+            if (data.scoreSnapshot != null)
+            {
+                ReturnScoreSnapshotToPool(data.scoreSnapshot);
+                data.scoreSnapshot = null;
+            }
+
+            data.cumulativeScore = 0;
+            data.isFinal = false;
+            data.timestampUtc = null;
+
+            if (_scoreDataPool.Count < SCORE_POOL_CAPACITY)
+            {
+                _scoreDataPool.Enqueue(data);
+            }
+        }
+
+        private void ReturnScoreSnapshotToPool(ScoreSnapshot snapshot)
+        {
+            if (snapshot == null) return;
+
+            if (snapshot.gameplayModifiers != null)
+            {
+                ReturnGameplayModifiersToPool(snapshot.gameplayModifiers);
+                snapshot.gameplayModifiers = null;
+            }
+
+            snapshot.scoreTime = 0f;
+            snapshot.scoreDelta = 0;
+
+            if (_scoreSnapshotPool.Count < SCORE_POOL_CAPACITY)
+            {
+                _scoreSnapshotPool.Enqueue(snapshot);
+            }
+        }
+
+        private void ReturnGameplayModifiersToPool(GameplayModifiers modifiers)
+        {
+            if (modifiers == null) return;
+
+            modifiers.comboModifiers = 0f;
+            modifiers.globalModifiers = 0f;
+            modifiers.activePowerUps = null;
+
+            if (_gameplayModifiersPool.Count < SCORE_POOL_CAPACITY)
+            {
+                _gameplayModifiersPool.Enqueue(modifiers);
+            }
+        }
+
         private void SetBestScore(ScoreData scoreData, string sessionId)
         {
             BestScoreWrapper bestScore = new BestScoreWrapper(scoreData, sessionId);

package/Runtime/Internal/Managers/GameManager.cs

@@ -190,11 +190,6 @@ namespace Hyper.Internal.Managers
             HandlePauseState(!hasFocus);
         }
 
-        void OnApplicationPause(bool pauseStatus)
-        {
-            HandlePauseState(pauseStatus);
-        }
-
         void HandlePauseState(bool shouldPause)
         {
             if (shouldPause && !_isPaused)

package/Runtime/Internal/ScriptableObjects/HyperSDKSettings.cs

@@ -38,6 +38,9 @@ namespace Hyper.Internal
         [Tooltip("Choose the start CTA overlay shown before gameplay begins. Hyper requires one of these overlays - do not add your own start buttons.")]
         public StartCTA startCTA = StartCTA.TapToPlay;
 
+        [Tooltip("If Start CTA is set to Swipe to Play, choose the swipe direction used for the visual cue.")]
+        public SwipeDirection swipeDirection = SwipeDirection.Up;
+
         #endregion
 
         #region Control Bar Settings

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

@@ -52,6 +52,9 @@ namespace Hyper.Internal
         private const float DARK_THEME_PAUSE_BUTTON_ALPHA = 0.25f;
         private const float LIGHT_THEME_PAUSE_BUTTON_ALPHA = 1f;
 
+        private int lastScore = -1;
+        private readonly char[] _scoreBuffer = new char[16];
+
         void Awake()
         {
             _gameManager = HyperRuntime.GameManager;
@@ -260,7 +263,12 @@ namespace Hyper.Internal
 
         public void UpdateScoreLabel()
         {
-            scoreText.SetText(HyperRuntime.DataManager.CurrentScore.ToString("N0"));
+            int currentScore = HyperRuntime.DataManager.CurrentScore;
+            if (currentScore != lastScore)
+            {
+                lastScore = currentScore;
+                HyperNumberFormatter.SetScoreNoAlloc(_scoreTextComponent, currentScore, _scoreBuffer);
+            }
         }
 
         /// <summary>

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

@@ -3,6 +3,7 @@ using UnityEngine;
 using TMPro;
 using UnityEngine.UI;
 using Hyper.Internal.Animation;
+using System.Text;
 
 namespace Hyper.Internal
 {
@@ -33,6 +34,7 @@ namespace Hyper.Internal
         private int _maxLives;
         private Image[] _heartImages;
         private bool _livesExhaustedTriggered;
+        private readonly StringBuilder _overflowLabelText = new StringBuilder(10);
 
         private void Awake()
         {
@@ -311,16 +313,13 @@ namespace Hyper.Internal
 
             int heartSlots = _heartImages != null ? _heartImages.Length : 0;
             int overflow = Mathf.Max(0, _currentLives - heartSlots);
+
             if (overflow > 0)
             {
-                overflowLabel.gameObject.SetActive(true);
-                overflowLabel.text = $"+{overflow}";
-            }
-            else
-            {
-                overflowLabel.text = string.Empty;
-                overflowLabel.gameObject.SetActive(false);
+                overflowLabel.SetText("+{0}", overflow);
             }
+            
+            overflowLabel.gameObject.SetActive(overflow > 0);
         }
     }
 }

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

@@ -19,7 +19,7 @@ namespace Hyper.Internal
             int seconds = Mathf.FloorToInt(HyperRuntime.Timer.CurrentTime % 60);
 
             // Update the UI text to display in the format 00:00
-            timerText.text = string.Format("{0:00}:{1:00}", minutes, seconds);
+            timerText.SetText("{0:00}:{1:00}", minutes, seconds);
 
         }
     }

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

@@ -104,11 +104,16 @@ namespace Hyper.Internal
         // Called from the SlideRight script once the animation is finished
         public void StartAction()
         {
-            StartLerpingSlider(0.7f, HyperRuntime.BackendManager.scoreSubmissionTimeout);
+            StartLerpingSlider(0.6f, HyperRuntime.BackendManager.scoreSubmissionTimeout);
         }
 
         public void ScoreHasBeenSubmitted()
         {
+            // Change back to "Submitting score" since submission is now successful
+            // and we're just loading to completion
+            if (scoreSubmissionText != null)
+                scoreSubmissionText.text = "Submitting score";
+            
             StopLerpingSlider();
             StartCoroutine(SetLoadingBarComplete());
         }

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

@@ -22,6 +22,7 @@ namespace Hyper.Internal
         private GameManager _gameManager;
         private BackendManager _backendManager;
         private StartCTA _currentCTA;
+        private SwipeDirection _swipeDirection;
 
         // Swipe detection variables
         private Vector2 _swipeStartPosition;
@@ -56,6 +57,9 @@ namespace Hyper.Internal
         public void Configure(StartCTA cta)
         {
             _currentCTA = cta;
+            _swipeDirection = HyperRuntime.Settings != null
+                ? HyperRuntime.Settings.swipeDirection
+                : SwipeDirection.Up;
 
             if (startCtaLabel == null)
             {
@@ -276,27 +280,49 @@ namespace Hyper.Internal
 
         private void UpdateSwipeGraphics()
         {
-            bool showVertical = _currentCTA == StartCTA.SwipeToPlayVertical;
-            bool showHorizontal = _currentCTA == StartCTA.SwipeToPlayHorizontal;
-
             if (swipeGif != null)
             {
-                if (showVertical)
-                {
-                    swipeGif.anchoredPosition = new Vector3(0, 286, 0);
-                    swipeGif.transform.rotation = Quaternion.Euler(0, 0, 90);
-                    swipeGif.gameObject.SetActive(true);
-                }
-                else if (showHorizontal)
+                bool isSwipe =
+                    _currentCTA == StartCTA.SwipeToPlayVertical ||
+                    _currentCTA == StartCTA.SwipeToPlayHorizontal;
+
+                if (!isSwipe)
                 {
-                    swipeGif.anchoredPosition = new Vector3(0, 220, 0);
-                    swipeGif.transform.rotation = Quaternion.Euler(0, 0, 0);
-                    swipeGif.gameObject.SetActive(true);
+                    swipeGif.gameObject.SetActive(false);
+                    return;
                 }
-                else
+
+                // Default positions based on axis (vertical vs horizontal)
+                Vector3 verticalPosition = new Vector3(0, 286, 0);
+                Vector3 horizontalPosition = new Vector3(0, 220, 0);
+
+                float rotationZ;
+                Vector3 anchoredPosition;
+
+                switch (_swipeDirection)
                 {
-                    swipeGif.gameObject.SetActive(false);
+                    case SwipeDirection.Up:
+                        rotationZ = 90f;
+                        anchoredPosition = verticalPosition;
+                        break;
+                    case SwipeDirection.Down:
+                        rotationZ = -90f;
+                        anchoredPosition = verticalPosition;
+                        break;
+                    case SwipeDirection.Left:
+                        rotationZ = 180f;
+                        anchoredPosition = horizontalPosition;
+                        break;
+                    case SwipeDirection.Right:
+                    default:
+                        rotationZ = 0f;
+                        anchoredPosition = horizontalPosition;
+                        break;
                 }
+
+                swipeGif.anchoredPosition = anchoredPosition;
+                swipeGif.transform.rotation = Quaternion.Euler(0, 0, rotationZ);
+                swipeGif.gameObject.SetActive(true);
             }
         }
 
@@ -305,12 +331,16 @@ namespace Hyper.Internal
             float absX = Mathf.Abs(delta.x);
             float absY = Mathf.Abs(delta.y);
 
-            switch (_currentCTA)
+            switch (_swipeDirection)
             {
-                case StartCTA.SwipeToPlayVertical:
-                    return absY >= SWIPE_THRESHOLD && absY >= absX;
-                case StartCTA.SwipeToPlayHorizontal:
-                    return absX >= SWIPE_THRESHOLD && absX >= absY;
+                case SwipeDirection.Up:
+                    return delta.y >= SWIPE_THRESHOLD && absY >= absX;
+                case SwipeDirection.Down:
+                    return -delta.y >= SWIPE_THRESHOLD && absY >= absX;
+                case SwipeDirection.Right:
+                    return delta.x >= SWIPE_THRESHOLD && absX >= absY;
+                case SwipeDirection.Left:
+                    return -delta.x >= SWIPE_THRESHOLD && absX >= absY;
                 default:
                     return false;
             }

package/Runtime/Resources/HyperSDKSettings.asset

@@ -17,6 +17,7 @@ MonoBehaviour:
   pc: 0
   mobile: 1
   startCTA: 0
+  swipeDirection: 0
   controlBarLayout: 0
   controlBarTheme: 1
   useCustomRestartFlow: 0

package/Runtime/Resources/UIPrefabs/StartingInstructionModal.prefab

@@ -24,9 +24,9 @@ RectTransform:
   m_PrefabInstance: {fileID: 0}
   m_PrefabAsset: {fileID: 0}
   m_GameObject: {fileID: 812134488303599474}
-  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
   m_LocalPosition: {x: 0, y: 0, z: 0}
-  m_LocalScale: {x: 1.1, y: 1.1, z: 1.1}
+  m_LocalScale: {x: 0.9, y: 0.9, z: 0.9}
   m_ConstrainProportionsScale: 1
   m_Children:
   - {fileID: 312166748021578777}
@@ -35,7 +35,7 @@ RectTransform:
   m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
   m_AnchorMin: {x: 0.5, y: 0.5}
   m_AnchorMax: {x: 0.5, y: 0.5}
-  m_AnchoredPosition: {x: 0, y: 220}
+  m_AnchoredPosition: {x: 0, y: 210}
   m_SizeDelta: {x: 279.2293, y: 106.4023}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &277624337904105659
@@ -325,7 +325,7 @@ PrefabInstance:
       objectReference: {fileID: 0}
     - target: {fileID: 596696483668891729, guid: bc5495c08b5534447938b4459527fa86, type: 3}
       propertyPath: m_fontSize
-      value: 130
+      value: 120.8
       objectReference: {fileID: 0}
     - target: {fileID: 596696483668891729, guid: bc5495c08b5534447938b4459527fa86, type: 3}
       propertyPath: m_margin.x

package/Runtime/Shared/DTOs/Enums.cs

@@ -145,4 +145,30 @@ namespace Hyper.Shared
         /// </summary>
         SwipeToPlayHorizontal
     }
+
+    /// <summary>
+    /// Direction of swipe used for Start CTA visuals and gesture.
+    /// </summary>
+    public enum SwipeDirection
+    {
+        /// <summary>
+        /// Swipe upwards.
+        /// </summary>
+        Up,
+
+        /// <summary>
+        /// Swipe downwards.
+        /// </summary>
+        Down,
+
+        /// <summary>
+        /// Swipe to the left.
+        /// </summary>
+        Left,
+
+        /// <summary>
+        /// Swipe to the right.
+        /// </summary>
+        Right
+    }
 }

package/Runtime/Shared/Hyper.Shared.asmdef

@@ -1,7 +1,9 @@
 {
     "name": "Hyper.Shared",
     "rootNamespace": "Hyper.Shared",
-    "references": [],
+    "references": [
+        "GUID:6055be8ebefd69e48b49212b09b47b2f"
+    ],
     "includePlatforms": [],
     "excludePlatforms": [],
     "allowUnsafeCode": false,

package/Runtime/Shared/Utils/HyperDebug.cs

@@ -30,7 +30,7 @@ namespace Hyper.Internal
             {
 #if UNITY_EDITOR
                 return true;
-#elif DEVELOPMENT_BUILD
+#elif HYPER_DEVELOPMENT_BUILD
                 return true;
 #else
                 return false;
@@ -45,7 +45,7 @@ namespace Hyper.Internal
         /// <summary>
         /// Standard log message with HyperSDK prefix.
         /// </summary>
-        [Conditional("UNITY_EDITOR"), Conditional("DEVELOPMENT_BUILD")]
+        [Conditional("UNITY_EDITOR"), Conditional("HYPER_DEVELOPMENT_BUILD")]
         public static void Log(string message, UnityEngine.Object context = null)
         {
             if (!IsLoggingEnabled) return;
@@ -55,7 +55,7 @@ namespace Hyper.Internal
         /// <summary>
         /// Info log with automatic caller detection.
         /// </summary>
-        [Conditional("UNITY_EDITOR"), Conditional("DEVELOPMENT_BUILD")]
+        [Conditional("UNITY_EDITOR"), Conditional("HYPER_DEVELOPMENT_BUILD")]
         public static void Info(string message, UnityEngine.Object context = null)
         {
             if (!IsLoggingEnabled) return;
@@ -66,7 +66,7 @@ namespace Hyper.Internal
         /// <summary>
         /// Success log (green) with automatic caller detection.
         /// </summary>
-        [Conditional("UNITY_EDITOR"), Conditional("DEVELOPMENT_BUILD")]
+        [Conditional("UNITY_EDITOR"), Conditional("HYPER_DEVELOPMENT_BUILD")]
         public static void LogSuccess(string message, UnityEngine.Object context = null)
         {
             if (!IsLoggingEnabled) return;
@@ -77,7 +77,7 @@ namespace Hyper.Internal
         /// <summary>
         /// Action log (blue) with automatic caller detection.
         /// </summary>
-        [Conditional("UNITY_EDITOR"), Conditional("DEVELOPMENT_BUILD")]
+        [Conditional("UNITY_EDITOR"), Conditional("HYPER_DEVELOPMENT_BUILD")]
         public static void Action(string message, UnityEngine.Object context = null)
         {
             if (!IsLoggingEnabled) return;
@@ -88,7 +88,7 @@ namespace Hyper.Internal
         /// <summary>
         /// Warning log (orange) with HyperSDK prefix.
         /// </summary>
-        [Conditional("UNITY_EDITOR"), Conditional("DEVELOPMENT_BUILD")]
+        [Conditional("UNITY_EDITOR"), Conditional("HYPER_DEVELOPMENT_BUILD")]
         public static void LogWarning(string message, UnityEngine.Object context = null)
         {
             if (!IsLoggingEnabled) return;
@@ -114,12 +114,22 @@ namespace Hyper.Internal
         /// </summary>
         private static string FormatMessage(string color, string prefix, string message)
         {
+
+#if UNITY_EDITOR
             if (string.IsNullOrEmpty(prefix))
             {
                 return $"<color={color}>{message}</color>";
             }
-            
+
             return $"<color={color}>[{prefix}]</color> {message}";
+#else
+            if (string.IsNullOrEmpty(prefix))
+            {
+                return $"{message}";
+            }
+            
+            return $"[{prefix}] {message}";
+#endif
         }
 
         #endregion

package/Runtime/Shared/Utils/HyperNumberFormatter.cs

@@ -0,0 +1,67 @@
+using TMPro;
+
+namespace Hyper.Internal
+{
+    /// <summary>
+    /// Internal number formatting utilities with minimal GC allocations.
+    /// </summary>
+    public static class HyperNumberFormatter
+    {
+        /// <summary>
+        /// Formats an <see cref="int"/> with thousand separators into the provided buffer.
+        /// Returns the number of characters written.
+        /// </summary>
+        /// <remarks>
+        /// - No string allocations.
+        /// - Caller must ensure <paramref name="buffer"/> is large enough for the largest expected value.
+        /// </remarks>
+        internal static int FormatIntWithCommas(int value, char[] buffer)
+        {
+            long v = value;
+            bool neg = v < 0;
+            if (neg) v = -v;
+
+            int i = buffer.Length;
+            int group = 0;
+
+            do
+            {
+                if (group == 3)
+                {
+                    buffer[--i] = ',';
+                    group = 0;
+                }
+
+                buffer[--i] = (char)('0' + (v % 10));
+                v /= 10;
+                group++;
+            } while (v != 0);
+
+            if (neg)
+            {
+                buffer[--i] = '-';
+            }
+
+            int len = buffer.Length - i;
+
+            // Shift to the beginning of the buffer
+            for (int k = 0; k < len; k++)
+            {
+                buffer[k] = buffer[i + k];
+            }
+
+            return len;
+        }
+
+        /// <summary>
+        /// Convenience helper: formats <paramref name="value"/> into <paramref name="buffer"/>
+        /// and applies it to the given <see cref="TMP_Text"/> without allocations.
+        /// </summary>
+        public static void SetScoreNoAlloc(TMP_Text text, int value, char[] buffer)
+        {
+            int len = FormatIntWithCommas(value, buffer);
+            text.SetCharArray(buffer, 0, len);
+        }
+    }
+}
+

package/Runtime/Shared/Utils/HyperNumberFormatter.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: 759fa1992061f1d42b7eeef01700a5a7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app.hypergames.hypersdk",
-  "version": "1.4.21",
+  "version": "1.5.0",
   "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",