spoint 0.1.41 → 0.1.43

package/SKILL.md

@@ -239,6 +239,14 @@ ctx.physics.addCapsuleCollider(radius, fullHeight)
 ctx.physics.addTrimeshCollider()
 // Builds static mesh from entity.model path. Static only.
 
+ctx.physics.addConvexCollider(points)
+// points: flat Float32Array or Array of [x,y,z,x,y,z,...] vertex positions
+// Builds a ConvexHullShape from the provided point cloud. Supports all motion types.
+
+ctx.physics.addConvexFromModel(meshIndex = 0)
+// Extracts vertex positions from entity.model GLB and builds ConvexHullShape.
+// Simpler and faster than trimesh for dynamic objects like vehicles/crates.
+
 ctx.physics.addForce([fx, fy, fz])    // Impulse: velocity += force / mass
 ctx.physics.setVelocity([vx, vy, vz]) // Set velocity directly
 ```
@@ -544,6 +552,12 @@ ctx.physics.addCapsuleCollider(radius, fullHeight)
 ctx.physics.addTrimeshCollider()
 // Static trimesh from entity.model. Only for static bodies.
 
+ctx.physics.addConvexCollider(points)
+// points: flat array [x,y,z,x,y,z,...]. Supports all motion types (dynamic/kinematic/static).
+
+ctx.physics.addConvexFromModel(meshIndex = 0)
+// Extracts vertices from entity.model GLB and builds ConvexHullShape. Good for dynamic vehicles/crates.
+
 ctx.physics.addForce([fx, fy, fz])     // velocity += force / mass
 ctx.physics.setVelocity([vx, vy, vz])
 ```
@@ -1068,6 +1082,14 @@ The engine manually applies `gravity[1] * dt` to Y velocity. This is already han
 
 `addTrimeshCollider()` creates a static mesh. No dynamic or kinematic trimesh support.
 
+### Convex hull for dynamic objects
+
+Use `addConvexCollider(points)` or `addConvexFromModel()` for dynamic/kinematic bodies that need shape-accurate physics (vehicles, crates). Convex hulls support all motion types unlike trimesh. `addConvexFromModel()` reads vertices from the entity's GLB at setup time - call it after setting `entity.model`.
+
+### Animation library is cached globally
+
+`loadAnimationLibrary()` loads `/anim-lib.glb` only once and caches the result. All subsequent calls return the cached result immediately. The library is also pre-fetched in parallel with the VRM download during initialization.
+
 ### Tick drops under load
 
 TickSystem processes max 4 ticks per loop. If the server falls more than 4 ticks behind (31ms at 128 TPS), those ticks are dropped silently.

package/client/animation.js

@@ -123,12 +123,21 @@ function normalizeClips(gltf, vrmVersion, vrmHumanoid) {
   return clips
 }
 
+let _animLibCache = null
+let _animLibPromise = null
+
 export async function loadAnimationLibrary(vrmVersion, vrmHumanoid) {
-  const loader = new GLTFLoader()
-  const gltf = await loader.loadAsync('/anim-lib.glb')
-  const normalizedClips = normalizeClips(gltf, vrmVersion || '1', vrmHumanoid)
-  console.log(`[anim] Loaded animation library (${normalizedClips.size} clips):`, [...normalizedClips.keys()])
-  return { normalizedClips }
+  if (_animLibCache) return _animLibCache
+  if (_animLibPromise) return _animLibPromise
+  _animLibPromise = (async () => {
+    const loader = new GLTFLoader()
+    const gltf = await loader.loadAsync('/anim-lib.glb')
+    const normalizedClips = normalizeClips(gltf, vrmVersion || '1', vrmHumanoid)
+    console.log(`[anim] Loaded animation library (${normalizedClips.size} clips):`, [...normalizedClips.keys()])
+    _animLibCache = { normalizedClips }
+    return _animLibCache
+  })()
+  return _animLibPromise
 }
 
 export function createPlayerAnimator(vrm, allClips, vrmVersion, animConfig = {}) {

package/client/app.js

@@ -713,16 +713,16 @@ function detectVrmVersion(buffer) {
 
 function initAssets(playerModelUrl) {
   loadingMgr.setStage('DOWNLOAD')
-  assetsReady = loadingMgr.fetchWithProgress(playerModelUrl).then(b => {
+  const animLibPromise = loadAnimationLibrary('1', null)
+  assetsReady = loadingMgr.fetchWithProgress(playerModelUrl).then(async b => {
     vrmBuffer = b
     loadingMgr.setStage('PROCESS')
-    return loadAnimationLibrary(detectVrmVersion(b), null)
-  }).then(result => {
-    animAssets = result
+    animAssets = await animLibPromise
     assetsLoaded = true
     checkAllLoaded()
   }).catch(err => {
     console.warn('[assets] player model unavailable:', err.message)
+    animLibPromise.then(r => { animAssets = r }).catch(() => {})
     assetsLoaded = true
     checkAllLoaded()
   })
@@ -840,7 +840,16 @@ function evaluateAppModule(code) {
   try {
     let stripped = code.replace(/^import\s+.*$/gm, '')
     stripped = stripped.replace(/const\s+__dirname\s*=.*import\.meta\.url.*$/gm, 'const __dirname = "/"')
-    const wrapped = stripped.replace(/export\s+default\s*/, 'return ').replace(/export\s+/g, '')
+    stripped = stripped.replace(/export\s+/g, '')
+    const exportDefaultIdx = stripped.search(/\bdefault\s*[\{(]/)
+    let wrapped
+    if (exportDefaultIdx !== -1) {
+      const before = stripped.slice(0, exportDefaultIdx)
+      const after = stripped.slice(exportDefaultIdx + 'default'.length).trimStart()
+      wrapped = before + '\nreturn ' + after + '\n//# sourceURL=app-module.js'
+    } else {
+      wrapped = stripped.replace(/\bdefault\s*/, 'return ') + '\n//# sourceURL=app-module.js'
+    }
     const join = (...parts) => parts.filter(Boolean).join('/')
     const readdirSync = () => []
     const statSync = () => ({ isDirectory: () => false })
@@ -969,6 +978,7 @@ function loadEntityModel(entityId, entityState) {
     fitShadowFrustum()
     pendingLoads.delete(entityId)
     if (!environmentLoaded) { environmentLoaded = true; checkAllLoaded() }
+    if (loadingScreenHidden) renderer.compileAsync(scene, camera).catch(() => renderer.compile(scene, camera))
   }, (progress) => { if (progress.total > 0) console.log('[gltf]', url, Math.round(progress.loaded / progress.total * 100) + '%') }, (err) => { console.error('[gltf]', url, err); pendingLoads.delete(entityId) })
 }
 
@@ -1117,7 +1127,8 @@ function checkAllLoaded() {
   loadingMgr.setStage('INIT')
   loadingMgr.complete()
   loadingScreenHidden = true
-  warmupShaders().then(() => loadingScreen.hide()).catch(() => loadingScreen.hide())
+  loadingScreen.hide()
+  warmupShaders().catch(() => {})
 }
 
 function initInputHandler() {

package/client/index.html

@@ -13,7 +13,7 @@
       "three": "https://esm.sh/three@0.171.0",
       "three/addons/": "https://esm.sh/three@0.171.0/examples/jsm/",
       "@pixiv/three-vrm": "https://esm.sh/@pixiv/three-vrm@3?external=three",
-      "three-mesh-bvh": "https://esm.sh/three-mesh-bvh@0.8.4?external=three",
+      "three-mesh-bvh": "/vendor/three-mesh-bvh.module.js",
       "webjsx": "https://esm.sh/webjsx@0.0.73",
       "webjsx/jsx-runtime": "https://esm.sh/webjsx@0.0.73/jsx-runtime"
     }