@genex-ai/cli-demo 1.34.1-dev.696 → 1.34.2-dev.698

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.34.1-dev.696",
+  "version": "1.34.2-dev.698",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/controllers/shared/colliders.ts

@@ -64,6 +64,30 @@ export interface ColliderOptions {
 const massPropertiesConflictError =
   "Please pick ONLY ONE of the `density`, `mass` and `massProperties` options.";
 
+// Diagnose invalid root/body wiring once per body, without changing the
+// upstream-compatible root-relative placement or retaining disposed bodies.
+const warnedColliderBodies = new WeakSet<RAPIER.RigidBody>();
+
+function warnMismatchedColliderFrame(body: RAPIER.RigidBody, root: THREE.Object3D): void {
+  if (warnedColliderBodies.has(body)) return;
+  const position = root.getWorldPosition(new THREE.Vector3());
+  const rotation = root.getWorldQuaternion(new THREE.Quaternion());
+  const t = body.translation();
+  const r = body.rotation();
+  const distance = Math.hypot(position.x - t.x, position.y - t.y, position.z - t.z);
+  // q and -q describe the same rotation.
+  const rotationDifference = 1 - Math.abs(rotation.dot(new THREE.Quaternion(r.x, r.y, r.z, r.w)));
+  if (distance <= 1e-4 && rotationDifference <= 1e-6) return;
+  warnedColliderBodies.add(body);
+  console.warn(
+    "[GENEX_COLLIDER_FRAME_MISMATCH] collidersFromObject uses its root as the body's frame, " +
+    "but their world poses differ. This can put invisible collisions away from the rendered meshes. " +
+    "Pass the root registered to this body, or use convexHullColliderFromMesh / " +
+    "trimeshColliderFromMesh for separate meshes attached to a shared body. " +
+    "Trimeshes are for static geometry only. Collider placement was not changed.",
+  );
+}
+
 /**
  * Auto-generate one collider per visible mesh under `object3d` — the vanilla
  * equivalent of the upstream `<RigidBody colliders="...">` prop. Works on GLB
@@ -82,6 +106,7 @@ export function collidersFromObject(
 ): RAPIER.Collider[] {
   const colliders: RAPIER.Collider[] = [];
   object3d.updateWorldMatrix(true, false);
+  warnMismatchedColliderFrame(body, object3d);
   const invertedRootMatrix = object3d.matrixWorld.clone().invert();
   const rootWorldScale = object3d.getWorldScale(new THREE.Vector3());
 

package/templates/skills/genex-threejs-character-controller/references/wiring.md

@@ -35,7 +35,12 @@ cuboidCollider(world, groundBody, [45, 0.25, 45], { friction: 1 }); // HALF exte
 For loaded GLB level pieces, `collidersFromObject(world, body, gltf.scene, "trimesh")`
 auto-generates colliders per mesh (`"hull"` for dynamic props from
 `$genex-ai-model`; `"trimesh"` only on static geometry). `cuboidCollider`
-takes **half** extents — do not halve twice.
+takes **half** extents — do not halve twice. The auto-collider root must be
+the object registered to that body. For separate positioned obstacles sharing
+one fixed body, call `convexHullColliderFromMesh` per mesh (or
+`trimeshColliderFromMesh` for concave static surfaces). Passing each leaf to
+`collidersFromObject` rebases it to the body origin; a
+`GENEX_COLLIDER_FRAME_MISMATCH` warning identifies this wiring error.
 
 ## 3. Character
 

package/templates/skills/genex-threejs-physics-rapier/references/colliders-from-assets.md

@@ -96,7 +96,22 @@ trimeshColliderFromMesh(world, fixedBody, levelMesh, { friction: 1 });
 ```
 
 Both bake the mesh's current world transform relative to the body, so the
-collider lands exactly where the mesh renders.
+collider lands where the mesh renders. For several positioned obstacles on
+one fixed body, use these helpers per mesh; do not call `collidersFromObject`
+with each leaf as the root of that same body:
+
+```ts
+const obstaclesBody = physics.createBody({ type: "fixed" });
+for (const obstacle of obstacleMeshes) {
+  convexHullColliderFromMesh(world, obstaclesBody, obstacle, { friction: 1 });
+}
+```
+
+Use trimeshes instead for concave static surfaces. A
+`GENEX_COLLIDER_FRAME_MISMATCH` warning means the auto-collider root and body
+have different world poses. Check visible geometry against collisions; the
+warning does not repair their placement. Correctly registered roots keep the
+existing auto-collider behavior.
 
 ## Hull vs trimesh