spoint 0.1.32 → 0.1.34

package/SKILL.md

@@ -762,6 +762,10 @@ App reloads never happen mid-tick. Queue drains at end of each tick. After each
 
 ## Client Rendering
 
+### GLB Shader Stall Prevention
+
+The engine automatically calls `renderer.compileAsync(object, camera)` immediately after adding any GLB or procedural mesh to the scene. This prevents first-draw GPU stall for dynamically loaded entities (environment models, physics crates, power crates, smart objects, drag-and-drop models). No action is needed from app code — warmup is handled in `loadEntityModel` and `loadQueuedModels`. VRM players use a separate one-time warmup path.
+
 ### render(ctx) Return Value
 
 ```js

package/apps/world/index.js

@@ -63,6 +63,5 @@ export default {
     { id: 'power-crates', position: [0, 0, 0], app: 'power-crate' },
     { id: 'interact-box', position: [-100, 3, -100], app: 'interactable' }
   ],
-  playerModel: './apps/tps-game/Cleetus.vrm',
   spawnPoint: [-35, 3, -65]
 }

package/client/app.js

@@ -714,6 +714,10 @@ function initAssets(playerModelUrl) {
     animAssets = result
     assetsLoaded = true
     checkAllLoaded()
+  }).catch(err => {
+    console.warn('[assets] player model unavailable:', err.message)
+    assetsLoaded = true
+    checkAllLoaded()
   })
 }
 
@@ -929,6 +933,7 @@ function loadEntityModel(entityId, entityState) {
     const ep = entityState.position; group.position.set(ep[0], ep[1], ep[2])
     const er = entityState.rotation; if (er) group.quaternion.set(er[0], er[1], er[2], er[3])
     scene.add(group)
+    renderer.compileAsync(group, camera).catch(() => renderer.compile(group, camera))
     entityMeshes.set(entityId, group)
     pendingLoads.delete(entityId)
     if (!environmentLoaded) { environmentLoaded = true; checkAllLoaded() }
@@ -951,6 +956,7 @@ function loadEntityModel(entityId, entityState) {
     })
     model.updateMatrixWorld(true)
     scene.add(model)
+    renderer.compileAsync(model, camera).catch(() => renderer.compile(model, camera))
     entityMeshes.set(entityId, model)
     cam.setEnvironment(colliders)
     scene.remove(ground)
@@ -1332,6 +1338,7 @@ function loadQueuedModels() {
         group.position.set(x, y, z)
         group.userData.isDroppedModel = true
         scene.add(group)
+        renderer.compileAsync(group, camera).catch(() => renderer.compile(group, camera))
         const envApp = appModules.get('environment')
         if (envApp?.onEvent) {
           envApp.onEvent({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spoint",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "description": "Physics and netcode SDK for multiplayer game servers",
   "type": "module",
   "main": "src/index.js",