spoint 0.1.42 → 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/package.json

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

package/src/apps/AppContext.js

@@ -1,4 +1,5 @@
 import { CliDebugger } from '../debug/CliDebugger.js'
+import { extractMeshFromGLB } from '../physics/GLBLoader.js'
 
 export class AppContext {
   constructor(entity, runtime) {
@@ -75,6 +76,23 @@ export class AppContext {
           ent._physicsBodyId = bodyId
         }
       },
+      addConvexCollider: (points) => {
+        ent.collider = { type: 'convex', points }
+        if (runtime._physics) {
+          const mt = ent.bodyType === 'dynamic' ? 'dynamic' : ent.bodyType === 'kinematic' ? 'kinematic' : 'static'
+          ent._physicsBodyId = runtime._physics.addBody('convex', points, ent.position, mt, { rotation: ent.rotation, mass: ent.mass })
+        }
+      },
+      addConvexFromModel: (meshIndex = 0) => {
+        if (!ent.model) return
+        const mesh = extractMeshFromGLB(runtime.resolveAssetPath(ent.model), meshIndex)
+        const points = Array.from(mesh.vertices)
+        ent.collider = { type: 'convex', points }
+        if (runtime._physics) {
+          const mt = ent.bodyType === 'dynamic' ? 'dynamic' : ent.bodyType === 'kinematic' ? 'kinematic' : 'static'
+          ent._physicsBodyId = runtime._physics.addBody('convex', points, ent.position, mt, { rotation: ent.rotation, mass: ent.mass })
+        }
+      },
       addForce: (f) => {
         const mass = ent.mass || 1
         ent.velocity[0] += f[0] / mass

package/src/physics/World.js

@@ -59,6 +59,13 @@ export class PhysicsWorld {
     if (shapeType === 'box') shape = new J.BoxShape(new J.Vec3(params[0], params[1], params[2]), 0.05, null)
     else if (shapeType === 'sphere') shape = new J.SphereShape(params)
     else if (shapeType === 'capsule') shape = new J.CapsuleShape(params[1], params[0])
+    else if (shapeType === 'convex') {
+      const pts = new J.VertexList()
+      for (let i = 0; i < params.length; i += 3) pts.push_back(new J.Float3(params[i], params[i + 1], params[i + 2]))
+      const cvx = new J.ConvexHullShapeSettings(pts)
+      shape = cvx.Create().Get()
+      J.destroy(pts); J.destroy(cvx)
+    }
     else return null
     const mt = motionType === 'dynamic' ? J.EMotionType_Dynamic : motionType === 'kinematic' ? J.EMotionType_Kinematic : J.EMotionType_Static
     layer = motionType === 'static' ? LAYER_STATIC : LAYER_DYNAMIC