@series-inc/rundot-3d-engine 0.6.20 → 0.6.22

package/SKILL.md

@@ -13,10 +13,18 @@ class MyGame extends VenusGame {
         // Load assets
         const stowkit = StowKitSystem.getInstance()
         const buildJson = (await import("../prefabs/build.json")).default
-        await stowkit.loadFromBuildJson(buildJson, {
-            fetchBlob: (path) => fetch(path).then(r => r.blob()),
+
+        // Step 1: Parse build.json (pure, no network)
+        const { prefabs, mounts } = stowkit.parseBuildJson(buildJson, {
+            materialConverter: (mat) => mat, // optional
         })
 
+        // Step 2: Download and register each pack
+        await Promise.all(mounts.map(async (mount) => {
+            const blob = await fetch(mount.path).then(r => r.blob())
+            await stowkit.registerAssetsFromBlob(mount.alias, blob)
+        }))
+
         // Create a player
         const player = new GameObject("Player")
         player.position.set(0, 1, 0)
@@ -310,18 +318,32 @@ animGraph.getCurrentState()
 
 ### StowKitSystem — Asset Loading
 
+Two-step loading: parse build.json first (pure, no network), then download and register each pack.
+
 ```typescript
 import { StowKitSystem } from "@series-inc/rundot-3d-engine/systems"
 
 const stowkit = StowKitSystem.getInstance()
-
-// Load from build.json
-await stowkit.loadFromBuildJson(buildJson, {
-    fetchBlob: (path) => fetch(path).then(r => r.blob()),
+const buildJson = (await import("../prefabs/build.json")).default
+
+// Step 1: Parse build.json — returns prefab collection and mount list (no I/O)
+const { prefabs, mounts } = stowkit.parseBuildJson(buildJson, {
+    materialConverter: (mat) => mat,  // optional — transform materials at load time
+    decoderPaths: {                   // optional — override decoder locations
+        basis: "basis/",
+        draco: "stowkit/draco/",
+        wasm: "stowkit_reader.wasm",
+    },
 })
 
+// Step 2: Download and register each .stow pack (WASM decode, no further network)
+await Promise.all(mounts.map(async (mount) => {
+    const blob = await fetch(mount.path).then(r => r.blob())
+    await stowkit.registerAssetsFromBlob(mount.alias, blob)
+}))
+
 // Access assets
-const mesh = await stowkit.getMesh("name")       // async
+const mesh = await stowkit.getMesh("name")       // async, on-demand load & cache
 const mesh = stowkit.getMeshSync("name")          // sync (null if not loaded)
 const tex = await stowkit.getTexture("name")
 const clip = await stowkit.getAnimation("walk", "character_mesh")
@@ -333,6 +355,24 @@ const clone = await stowkit.cloneMesh("name", castShadow, receiveShadow)
 
 // GPU instancing
 await stowkit.registerMeshForInstancing("coin_batch", "coin_mesh", true, true, 500)
+await stowkit.registerBatchFromPrefab("burger", true, true, 100) // from prefab's stow_mesh component
+```
+
+**Preloading** — pre-decode assets during load screen to avoid pop-in:
+
+```typescript
+await stowkit.preloadAll({
+    meshes: ["level_geometry", "coin_mesh"],
+    skinnedMeshes: { names: ["hero_model"], scale: 1.0 },
+    textures: ["hero_diffuse"],
+    audio: ["bgm_main", "sfx_click"],
+    animations: [{ name: "hero_idle", meshName: "hero_model" }],
+})
+
+// Or individually:
+await stowkit.preloadMeshes(["level_geometry", "coin_mesh"])
+await stowkit.preloadSkinnedMeshes(["hero_model"], 1.0)
+await stowkit.preloadAudio(["bgm_main"])
 ```
 
 ### InputManager — Keyboard, Pointer, Touch & Custom Actions