@genex-ai/cli-demo 0.47.0-dev.74 → 0.48.0-dev.75

package/dist/index.js

@@ -1800,12 +1800,31 @@ async function detectGameStateUsage(cwd = process.cwd()) {
   }
   return false;
 }
+var UI_PHASE_MARKERS = /data-phase|setPhase/;
+async function detectUiPhases(cwd = process.cwd()) {
+  try {
+    const html = await fs10.readFile(path11.join(cwd, "index.html"), "utf8").catch(() => "");
+    if (UI_PHASE_MARKERS.test(html)) return true;
+    const srcDir = path11.join(cwd, "src");
+    const entries = await fs10.readdir(srcDir, { recursive: true });
+    for (const rel of entries) {
+      if (rel.includes("node_modules")) continue;
+      if (!/\.(ts|js|mts|mjs|tsx|jsx|html|css)$/.test(rel)) continue;
+      const content = await fs10.readFile(path11.join(srcDir, rel), "utf8").catch(() => "");
+      if (UI_PHASE_MARKERS.test(content)) return true;
+    }
+    return false;
+  } catch {
+    return true;
+  }
+}
 async function detectFeatures(log, cwd = process.cwd()) {
   return {
     embedSdkVersion: await detectEmbedSdkVersion(cwd),
     multiplayer: await detectMultiplayer(cwd),
     matchmaking: await detectMatchmaking(log, cwd),
-    gameStateUsed: await detectGameStateUsage(cwd)
+    gameStateUsed: await detectGameStateUsage(cwd),
+    uiPhases: await detectUiPhases(cwd)
   };
 }
 function advisoryNudges(log, d) {
@@ -1824,6 +1843,11 @@ function advisoryNudges(log, d) {
       "package.json declares genex.matchmaking but @genex-ai/multiplayer is not installed \u2014 matchmaking cannot work. Install the SDK and use matchmake() (see genex-threejs-multiplayer)."
     );
   }
+  if (!d.uiPhases) {
+    log.warn(
+      "No menu/loader screens detected (no data-phase/setPhase) \u2014 players get a bare HUD with no title screen and no styled loading. Run the genex-threejs-game-ui plan (loader, menu, screen tiers); a cinematic menu is two commands away (genex-ai-menu)."
+    );
+  }
 }
 async function firstPreviewNudge(log, cwd = process.cwd()) {
   const meta = await readProject(cwd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.47.0-dev.74",
+  "version": "0.48.0-dev.75",
   "description": "Set up your ~/.claude workspace, authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/controllers/shared/physics-world.ts

@@ -157,7 +157,8 @@ const _identityMatrix = new THREE.Matrix4();
  * const physics = await PhysicsWorld.create();
  * physics.onBeforeStep(() => controller.update(physics.timeStep));
  * renderer.setAnimationLoop(() => {
- *   physics.step(clock.getDelta());   // fixed substeps + mesh sync + events
+ *   physics.step(delta);              // fixed substeps + mesh sync + events
+ *   // delta = capped performance.now() difference — avoid THREE.Clock.getDelta()
  *   // ...camera + render (render-delta code lives OUT here, never inside)
  * });
  * ```

package/templates/skills/genex-threejs-character-controller/SKILL.md

@@ -94,9 +94,14 @@ physics.onBeforeStep(() => {
 });
 
 // Render phase: step physics, then camera, then animations.
+// Delta comes from performance.now(), NOT THREE.Clock — Clock.getDelta() has
+// repeatedly frozen at 0 in real games (world renders, nothing moves).
 const pivot = new THREE.Vector3();
+let lastT = performance.now();
 renderer.setAnimationLoop(() => {
-  const delta = clock.getDelta();
+  const nowT = performance.now();
+  const delta = Math.min((nowT - lastT) / 1000, 0.1);
+  lastT = nowT;
   physics.step(delta); // runs the fixed substeps + world.step() + mesh sync
 
   pivot.copy(character.currPos).addScaledVector(character.bodyYAxis, 0.5);

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

@@ -169,7 +169,11 @@ Per fixed **substep** (inside `physics.onBeforeStep`), in this order:
 Per **render** frame (inside `renderer.setAnimationLoop`), in this order:
 
 ```ts
-const delta = clock.getDelta();
+// Delta from performance.now() — THREE.Clock.getDelta() has repeatedly frozen
+// at 0 in real games (world renders, nothing moves).
+const nowT = performance.now();
+const delta = Math.min((nowT - lastT) / 1000, 0.1);
+lastT = nowT;
 physics.step(delta);                               // 1. fixed substeps + mesh sync
 
 pivot.copy(character.currPos).addScaledVector(character.bodyYAxis, 0.5);

package/templates/skills/genex-threejs-physics-rapier/SKILL.md

@@ -59,9 +59,11 @@ physics.onBeforeStep(() => {
   // controller.update(), impulses, kinematic platform poses ...
 });
 
-const clock = new THREE.Clock();
+let lastT = performance.now(); // NOT THREE.Clock — its getDelta() has frozen at 0 in real games
 renderer.setAnimationLoop(() => {
-  physics.step(clock.getDelta()); // fixed substeps + mesh sync + events
+  const nowT = performance.now();
+  physics.step(Math.min((nowT - lastT) / 1000, 0.1)); // fixed substeps + mesh sync + events
+  lastT = nowT;
   // camera follow, mixers, HUD go HERE (render-delta work, after the step) —
   // never inside onBeforeStep above
   renderer.render(scene, camera);

package/templates/skills/genex-threejs-vehicle-controllers/SKILL.md

@@ -51,8 +51,11 @@ physics.onBeforeStep(() => {
   drone.update(dt);
 });                                              // 4. world.step() runs after
 
+let lastT = performance.now();
 renderer.setAnimationLoop(() => {
-  physics.step(clock.getDelta()); // fixed substeps + interpolated mesh sync
+  const nowT = performance.now();
+  physics.step(Math.min((nowT - lastT) / 1000, 0.1)); // fixed substeps + interpolated mesh sync
+  lastT = nowT;                   // performance.now() delta — THREE.Clock.getDelta() freezes at 0 in real games
   // camera + render here — render-delta code never goes inside onBeforeStep
 });
 ```