@umicat/phaser-sdk 1.0.14 → 1.0.15

package/dist/scene/SceneLoader.js

@@ -109,6 +109,20 @@ export function preloadSceneAssets(scene, sceneFile, manifest) {
         queueAssetLoad(scene, asset);
         state.requestedAssetIds.add(id);
     }
+    // Audio assets are GLOBAL — BGM / SFX are played from code (`sound.play(key)`),
+    // not attached to a scene entity — so the entity walk above never collects
+    // them and they'd never load. Eagerly load every audio asset in the manifest
+    // so `cache.audio.has(key)` is true and the game can play it with no manual
+    // BootScene preload. (Without this, registering BGM in the manifest silently
+    // produced no sound — the asset existed but was never queued.)
+    for (const asset of manifest.assets ?? []) {
+        if (asset.kind !== 'audio')
+            continue;
+        if (state.requestedAssetIds.has(asset.id))
+            continue;
+        queueAssetLoad(scene, asset);
+        state.requestedAssetIds.add(asset.id);
+    }
 }
 function collectAssetIds(entities, manifest, resolveTilemapFile) {
     const ids = new Set();
@@ -345,10 +359,15 @@ function queueAssetLoad(scene, asset) {
             }
             return;
         case 'audio':
-            scene.load.audio(asset.textureKey, asset.path);
+            // Fall back to `id` when `textureKey` is absent. Audio (and json) entries
+            // are naturally written as `{ id, path, kind:'audio' }` — "textureKey" is
+            // a misnomer for a sound — so an agent/human routinely omits it. Without
+            // the fallback the clip loads under key `undefined` and `sound.play(id)`
+            // silently no-ops (the "generated BGM never plays" bug).
+            scene.load.audio(asset.textureKey || asset.id, asset.path);
             return;
         case 'json':
-            scene.load.json(asset.textureKey, asset.path);
+            scene.load.json(asset.textureKey || asset.id, asset.path);
             return;
         default: {
             const exhaustive = asset.kind;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/phaser-sdk",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Umicat Phaser 3 SDK — game infrastructure for the Umicat platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",