spoint 0.1.32 → 0.1.33

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/client/app.js

@@ -929,6 +929,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 +952,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 +1334,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.33",
   "description": "Physics and netcode SDK for multiplayer game servers",
   "type": "module",
   "main": "src/index.js",