app.hypergames.hypersdk 1.8.22 → 1.8.26

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## [1.8.26](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.25...v1.8.26) (2026-07-09)
+
+
+### Bug Fixes
+
+* address SDK publishing issues ([f00551a](https://github.com/mvmhyper/hyper-sdk/commit/f00551a681bf5e1011410677e220ca3c372648dd))
+
+## [1.8.25](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.24...v1.8.25) (2026-07-09)
+
+
+### Bug Fixes
+
+* repair SDK publish workflow ([e718b78](https://github.com/mvmhyper/hyper-sdk/commit/e718b78b593abfacf49395e87e780ee0e7529b00))
+
+## [1.8.24](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.23...v1.8.24) (2026-07-09)
+
+
+### Bug Fixes
+
+* simplify tutorial available modal ([5a2056d](https://github.com/mvmhyper/hyper-sdk/commit/5a2056d0cac32028e552b250fc76e2a961a04291))
+* support tutorial announcement modal landscape ([db5e7d6](https://github.com/mvmhyper/hyper-sdk/commit/db5e7d639865fdf14ef74947ac0809b1e167f832))
+
+## [1.8.23](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.22...v1.8.23) (2026-07-08)
+
+
+### Bug Fixes
+
+* signal tutorial availability before cache completes ([7a8d043](https://github.com/mvmhyper/hyper-sdk/commit/7a8d043e016c36007b088535f06ae5f4bb4ae64d))
+
 ## [1.8.22](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.21...v1.8.22) (2026-07-08)
 
 

package/Runtime/Internal/Managers/BackendManager.cs

@@ -1644,6 +1644,12 @@ namespace Hyper.Internal.Managers
         {
             switch (result)
             {
+                case "available":
+                    tutorialExistsButFailed = false;
+                    tutorialFetchSuccess = false;
+                    TutorialAvailability = TutorialAvailabilityState.Available;
+                    break;
+
                 case "success":
                     _isFetchingTutorial = false;
                     tutorialExistsButFailed = false;
@@ -1697,7 +1703,7 @@ namespace Hyper.Internal.Managers
 
         private bool IsTutorialFetchComplete()
         {
-            return TutorialAvailability == TutorialAvailabilityState.Available ||
+            return (TutorialAvailability == TutorialAvailabilityState.Available && !_isFetchingTutorial) ||
                    TutorialAvailability == TutorialAvailabilityState.Unavailable;
         }
 
@@ -1757,7 +1763,7 @@ namespace Hyper.Internal.Managers
         private IEnumerator SimulateTutorialFetch()
         {
             var value = UnityEngine.Random.Range(0, 4);
-            Debug.Log($"[Tutorial] Simulating tutorial fetch result: {value}");
+            // Debug.Log($"[Tutorial] Simulating tutorial fetch result: {value}");
 
             switch (value)
             {

package/Runtime/Internal/Managers/GameManager.cs

@@ -1559,6 +1559,7 @@ namespace Hyper.Internal.Managers
                 return;
             }
 
+            _tutorialAnnouncementModalComponent.ConfigureForOrientation(ResolvePortraitFlag());
             _tutorialAnnouncementModalComponent.Show(() =>
             {
                 MarkTutorialAnnouncementSeen();

package/Runtime/Internal/UI/Animation/SlideUp.cs

@@ -93,6 +93,11 @@ namespace Hyper.Internal
         }
 
         public void SlideDownAnimation()
+        {
+            SlideDownAnimation(0.5f);
+        }
+
+        public void SlideDownAnimation(float duration)
         {
             if (!isInitialized || rectTransform == null)
             {
@@ -107,7 +112,7 @@ namespace Hyper.Internal
             RecalcOffScreenY();
 
             // Animate to off-screen position
-            rectTransform.DOAnchorPosY(offScreenY, 0.5f)
+            rectTransform.DOAnchorPosY(offScreenY, duration)
                 .SetEase(HyperTween.Ease.InQuad)
                 .SetUpdate(true)
                 .OnComplete(() =>

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

@@ -9,9 +9,17 @@ namespace Hyper.Internal
 
         private System.Action _onClosed;
         private bool _hasClosed;
+        private RectTransform _rectTransform;
+        private Vector2 _defaultAnchoredPosition;
 
         private void Awake()
         {
+            _rectTransform = GetComponent<RectTransform>();
+            if (_rectTransform != null)
+            {
+                _defaultAnchoredPosition = _rectTransform.anchoredPosition;
+            }
+
             if (closeButton == null)
             {
                 closeButton = GetComponentInChildren<Button>(true);
@@ -35,6 +43,19 @@ namespace Hyper.Internal
             }
         }
 
+        internal void ConfigureForOrientation(bool isPortrait)
+        {
+            if (_rectTransform == null) return;
+
+            Vector2 anchoredPosition = _defaultAnchoredPosition;
+            if (!isPortrait)
+            {
+                anchoredPosition.y = -50f;
+            }
+
+            _rectTransform.anchoredPosition = anchoredPosition;
+        }
+
         internal void Show(System.Action onClosed)
         {
             _onClosed = onClosed;

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

@@ -1234,7 +1234,7 @@ namespace Hyper.Internal
             }
 
             if (videoPlayer != null) videoPlayer.enabled = false;
-            slideUp.SlideDownAnimation();
+            slideUp.SlideDownAnimation(SlideInDuration);
         }
 
         private void UpdateNavigationButtons()

package/Runtime/Plugins/WebGL/HyperTutorialCachePlugin.jslib

@@ -8,6 +8,7 @@ mergeInto(LibraryManager.library, {
     const gameObject = UTF8ToString(gameObjectPtr);
 
     const endpoint = `${baseUrl}/games/${gameSlug}/tutorials`;
+    let tutorialRecordsFound = false;
 
     caches.open("tutorial-cache").then(async (cache) => {
       try {
@@ -22,6 +23,9 @@ mergeInto(LibraryManager.library, {
           return;
         }
 
+        tutorialRecordsFound = true;
+        SendMessage(gameObject, "OnTutorialCacheComplete", "available");
+
         const cards = records
           .filter(r => r && r.fileUrl)
           .map((record, index) => ({
@@ -48,7 +52,7 @@ mergeInto(LibraryManager.library, {
         SendMessage(gameObject, "OnTutorialCacheComplete", "success");
       } catch (e) {
         console.error("Tutorial caching error:", e);
-        const status = e.message.includes("Download failed") ? "download_failed" : "fetch_failed";
+        const status = tutorialRecordsFound || e.message.includes("Download failed") ? "download_failed" : "fetch_failed";
         SendMessage(gameObject, "OnTutorialCacheComplete", status);
       }
     });

package/Runtime/Resources/UIPrefabs/TutorialAnnouncementModal.prefab

@@ -257,81 +257,6 @@ MonoBehaviour:
   m_hasFontAssetChanged: 0
   m_baseMaterial: {fileID: 0}
   m_maskOffset: {x: 0, y: 0, z: 0, w: 0}
---- !u!1 &3461072911430653139
-GameObject:
-  m_ObjectHideFlags: 0
-  m_CorrespondingSourceObject: {fileID: 0}
-  m_PrefabInstance: {fileID: 0}
-  m_PrefabAsset: {fileID: 0}
-  serializedVersion: 6
-  m_Component:
-  - component: {fileID: 6045797237084068160}
-  - component: {fileID: 7858062609381968049}
-  - component: {fileID: 5916393371149723254}
-  m_Layer: 5
-  m_Name: How To Play Image
-  m_TagString: Untagged
-  m_Icon: {fileID: 0}
-  m_NavMeshLayer: 0
-  m_StaticEditorFlags: 0
-  m_IsActive: 1
---- !u!224 &6045797237084068160
-RectTransform:
-  m_ObjectHideFlags: 0
-  m_CorrespondingSourceObject: {fileID: 0}
-  m_PrefabInstance: {fileID: 0}
-  m_PrefabAsset: {fileID: 0}
-  m_GameObject: {fileID: 3461072911430653139}
-  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
-  m_LocalPosition: {x: 0, y: 0, z: 0}
-  m_LocalScale: {x: 1, y: 1, z: 1}
-  m_ConstrainProportionsScale: 0
-  m_Children: []
-  m_Father: {fileID: 4123193494548902652}
-  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
-  m_AnchorMin: {x: 0.5, y: 1}
-  m_AnchorMax: {x: 0.5, y: 1}
-  m_AnchoredPosition: {x: 0, y: -257.0842}
-  m_SizeDelta: {x: 609.1098, y: 416.5139}
-  m_Pivot: {x: 0.5, y: 0.5}
---- !u!222 &7858062609381968049
-CanvasRenderer:
-  m_ObjectHideFlags: 0
-  m_CorrespondingSourceObject: {fileID: 0}
-  m_PrefabInstance: {fileID: 0}
-  m_PrefabAsset: {fileID: 0}
-  m_GameObject: {fileID: 3461072911430653139}
-  m_CullTransparentMesh: 1
---- !u!114 &5916393371149723254
-MonoBehaviour:
-  m_ObjectHideFlags: 0
-  m_CorrespondingSourceObject: {fileID: 0}
-  m_PrefabInstance: {fileID: 0}
-  m_PrefabAsset: {fileID: 0}
-  m_GameObject: {fileID: 3461072911430653139}
-  m_Enabled: 1
-  m_EditorHideFlags: 0
-  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
-  m_Name: 
-  m_EditorClassIdentifier: 
-  m_Material: {fileID: 0}
-  m_Color: {r: 1, g: 1, b: 1, a: 1}
-  m_RaycastTarget: 1
-  m_RaycastPadding: {x: 0, y: 0, z: 0, w: 0}
-  m_Maskable: 1
-  m_OnCullStateChanged:
-    m_PersistentCalls:
-      m_Calls: []
-  m_Sprite: {fileID: 21300000, guid: 79ea1f5df2417914697380a19c4438fc, type: 3}
-  m_Type: 0
-  m_PreserveAspect: 1
-  m_FillCenter: 1
-  m_FillMethod: 4
-  m_FillAmount: 1
-  m_FillClockwise: 1
-  m_FillOrigin: 0
-  m_UseSpriteMesh: 1
-  m_PixelsPerUnitMultiplier: 1
 --- !u!1 &3513764185288973057
 GameObject:
   m_ObjectHideFlags: 0
@@ -364,9 +289,9 @@ RectTransform:
   m_Children: []
   m_Father: {fileID: 4123193494548902652}
   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: -94.44171}
+  m_AnchorMin: {x: 0.5, y: 1}
+  m_AnchorMax: {x: 0.5, y: 1}
+  m_AnchoredPosition: {x: 0, y: -126.7}
   m_SizeDelta: {x: 634.0235, y: 133.6543}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &3097566720818362696
@@ -502,7 +427,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.00090575, y: -236.0161}
+  m_AnchoredPosition: {x: -0.000009777315, y: -16}
   m_SizeDelta: {x: 634.03, y: 118.2242}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &5167194094165994009
@@ -533,7 +458,7 @@ MonoBehaviour:
   m_OnCullStateChanged:
     m_PersistentCalls:
       m_Calls: []
-  m_text: You can replay game tutorials anytime from the pause menu.
+  m_text: Tap the pause icon in the top right to watch tutorials anytime.
   m_isRightToLeft: 0
   m_fontAsset: {fileID: 11400000, guid: 849755e149fecd54d9c6ec82145e4a1e, type: 2}
   m_sharedMaterial: {fileID: -153029463916510471, guid: 849755e149fecd54d9c6ec82145e4a1e, type: 2}
@@ -560,8 +485,8 @@ MonoBehaviour:
   m_faceColor:
     serializedVersion: 2
     rgba: 4294967295
-  m_fontSize: 35
-  m_fontSizeBase: 35
+  m_fontSize: 36
+  m_fontSizeBase: 36
   m_fontWeight: 400
   m_enableAutoSizing: 0
   m_fontSizeMin: 18
@@ -635,7 +560,6 @@ RectTransform:
   m_LocalScale: {x: 1.25, y: 1.25, z: 1.25}
   m_ConstrainProportionsScale: 1
   m_Children:
-  - {fileID: 6045797237084068160}
   - {fileID: 6968122340101791087}
   - {fileID: 3032462698273761709}
   - {fileID: 1763693822121464465}
@@ -643,8 +567,8 @@ 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: 0}
-  m_SizeDelta: {x: 708.9152, y: 970.8}
+  m_AnchoredPosition: {x: 0, y: -0.0000076293945}
+  m_SizeDelta: {x: 708.9152, y: 517.7589}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &6745477405133080417
 CanvasRenderer:

package/Runtime/Resources/UIPrefabs/TutorialLandscapeModal.prefab

@@ -556,7 +556,7 @@ RectTransform:
   m_AnchorMin: {x: 0, y: 0}
   m_AnchorMax: {x: 1, y: 0}
   m_AnchoredPosition: {x: 0, y: 178.46335}
-  m_SizeDelta: {x: -729.2227, y: 95.0967}
+  m_SizeDelta: {x: -874.37915, y: 95.0967}
   m_Pivot: {x: 0.5, y: 0.5}
 --- !u!222 &1858963877420389427
 CanvasRenderer:
@@ -613,7 +613,7 @@ MonoBehaviour:
   m_faceColor:
     serializedVersion: 2
     rgba: 4294967295
-  m_fontSize: 24.55
+  m_fontSize: 35
   m_fontSizeBase: 42
   m_fontWeight: 400
   m_enableAutoSizing: 1

package/package.json

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

package/Runtime/Resources/Sprites/Frame 2147224037.png.meta

@@ -1,156 +0,0 @@
-fileFormatVersion: 2
-guid: 79ea1f5df2417914697380a19c4438fc
-TextureImporter:
-  internalIDToNameTable:
-  - first:
-      213: 4044033671516185218
-    second: Frame 2147224037_0
-  externalObjects: {}
-  serializedVersion: 13
-  mipmaps:
-    mipMapMode: 0
-    enableMipMap: 0
-    sRGBTexture: 1
-    linearTexture: 0
-    fadeOut: 0
-    borderMipMap: 0
-    mipMapsPreserveCoverage: 0
-    alphaTestReferenceValue: 0.5
-    mipMapFadeDistanceStart: 1
-    mipMapFadeDistanceEnd: 3
-  bumpmap:
-    convertToNormalMap: 0
-    externalNormalMap: 0
-    heightScale: 0.25
-    normalMapFilter: 0
-    flipGreenChannel: 0
-  isReadable: 0
-  streamingMipmaps: 0
-  streamingMipmapsPriority: 0
-  vTOnly: 0
-  ignoreMipmapLimit: 0
-  grayScaleToAlpha: 0
-  generateCubemap: 6
-  cubemapConvolution: 0
-  seamlessCubemap: 0
-  textureFormat: 1
-  maxTextureSize: 2048
-  textureSettings:
-    serializedVersion: 2
-    filterMode: 1
-    aniso: 1
-    mipBias: 0
-    wrapU: 1
-    wrapV: 1
-    wrapW: 1
-  nPOTScale: 0
-  lightmap: 0
-  compressionQuality: 50
-  spriteMode: 1
-  spriteExtrude: 1
-  spriteMeshType: 1
-  alignment: 0
-  spritePivot: {x: 0.5, y: 0.5}
-  spritePixelsToUnits: 100
-  spriteBorder: {x: 0, y: 0, z: 0, w: 0}
-  spriteGenerateFallbackPhysicsShape: 0
-  alphaUsage: 1
-  alphaIsTransparency: 1
-  spriteTessellationDetail: -1
-  textureType: 8
-  textureShape: 1
-  singleChannelComponent: 0
-  flipbookRows: 1
-  flipbookColumns: 1
-  maxTextureSizeSet: 0
-  compressionQualitySet: 0
-  textureFormatSet: 0
-  ignorePngGamma: 0
-  applyGammaDecoding: 0
-  swizzle: 50462976
-  cookieLightType: 0
-  platformSettings:
-  - serializedVersion: 4
-    buildTarget: DefaultTexturePlatform
-    maxTextureSize: 1024
-    resizeAlgorithm: 0
-    textureFormat: -1
-    textureCompression: 1
-    compressionQuality: 50
-    crunchedCompression: 1
-    allowsAlphaSplitting: 0
-    overridden: 0
-    ignorePlatformSupport: 0
-    androidETC2FallbackOverride: 0
-    forceMaximumCompressionQuality_BC6H_BC7: 0
-  - serializedVersion: 4
-    buildTarget: Standalone
-    maxTextureSize: 2048
-    resizeAlgorithm: 0
-    textureFormat: -1
-    textureCompression: 1
-    compressionQuality: 50
-    crunchedCompression: 0
-    allowsAlphaSplitting: 0
-    overridden: 0
-    ignorePlatformSupport: 0
-    androidETC2FallbackOverride: 0
-    forceMaximumCompressionQuality_BC6H_BC7: 0
-  - serializedVersion: 4
-    buildTarget: WebGL
-    maxTextureSize: 2048
-    resizeAlgorithm: 0
-    textureFormat: -1
-    textureCompression: 1
-    compressionQuality: 50
-    crunchedCompression: 0
-    allowsAlphaSplitting: 0
-    overridden: 0
-    ignorePlatformSupport: 0
-    androidETC2FallbackOverride: 0
-    forceMaximumCompressionQuality_BC6H_BC7: 0
-  spriteSheet:
-    serializedVersion: 2
-    sprites:
-    - serializedVersion: 2
-      name: Frame 2147224037_0
-      rect:
-        serializedVersion: 2
-        x: 0
-        y: 0
-        width: 1180
-        height: 808
-      alignment: 0
-      pivot: {x: 0, y: 0}
-      border: {x: 0, y: 0, z: 0, w: 0}
-      customData: 
-      outline: []
-      physicsShape: []
-      tessellationDetail: -1
-      bones: []
-      spriteID: 282e072b23b4f1830800000000000000
-      internalID: 4044033671516185218
-      vertices: []
-      indices: 
-      edges: []
-      weights: []
-    outline: []
-    customData: 
-    physicsShape: []
-    bones: []
-    spriteID: 5e97eb03825dee720800000000000000
-    internalID: 0
-    vertices: []
-    indices: 
-    edges: []
-    weights: []
-    secondaryTextures: []
-    spriteCustomMetadata:
-      entries: []
-    nameFileIdTable:
-      Frame 2147224037_0: 4044033671516185218
-  mipmapLimitGroupName: 
-  pSDRemoveMatte: 0
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: