@genex-ai/cli-demo 0.92.0 → 0.93.0-dev.235

package/dist/index.js

@@ -8,7 +8,7 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var RAW_CHANNEL = "latest";
+var RAW_CHANNEL = "dev";
 var CLI_CHANNEL = RAW_CHANNEL === "dev" ? "dev" : "latest";
 var STANDS = {
   prod: { api: "https://api.genex.games", dashboard: "https://genex.games" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.92.0",
+  "version": "0.93.0-dev.235",
   "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/skills/genex-ai-skybox/SKILL.md

@@ -116,7 +116,7 @@ scene.background = texture; // keep the raw texture for the visible sky
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this skybox generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-texture/SKILL.md

@@ -225,7 +225,7 @@ first one is the one a screenshot of the whole arena will not show you.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -151,7 +151,7 @@ set belongs to `$genex-ai-hud` — both build on `npx genex image`/`video`.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Nothing plays / black surface** — the first `video.play()` must run inside a user

package/templates/skills/genex-getting-started/SKILL.md

@@ -131,7 +131,7 @@ and re-link the clone to the same live game:
 ```bash
 git clone <the game's repo url> my-game && cd my-game
 npm install
-npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 ```
 
 Don't know the slug? **`npx genex list`** prints every game on your account —
@@ -158,7 +158,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-threejs-multiplayer/SKILL.md

@@ -331,6 +331,23 @@ halves of this rule are non-negotiable:
    `minPlayers: 2, maxPlayers: 2`: the instant the second player joins). If it doesn't close on
    both, the lobby is broken — fix it; do not ship a waiting room you haven't watched close.
 
+**While `status === 'searching'` the roster is EMPTY — count the queue, not `players`.** The
+matchmaker never parks a searcher in a room as a non-player: until it can seat you, you are in the
+search line and in no room at all, so `players`/`connectedPlayers` are `[]`. A pre-match screen that
+counts `players.length` there shows `0 / 2` to a player who is sitting in it, forever. Use the queue
+count — it includes YOU, so it reads `1 / 2` when you are alone — and switch to the roster the moment
+you are seated:
+
+```ts
+const v = mm.matchmaking;
+const lobbyCount = v.status === "searching" ? Math.max(v.queue.size, 1) : v.connectedPlayers.length;
+```
+
+This bites hardest in the commonest co-op shape: with `minPlayers === maxPlayers` (e.g. `2` and `2`)
+the room can only be formed once BOTH searchers exist, so you go `searching → playing` and **never
+pass through `waiting`** — the screen the player stares at is the SEARCHING screen, and driving it
+off `players.length` pins it at `0 / target` for its entire life.
+
 Two ways to present the lobby:
 
 - **A) UI lobby (Dota-style).** While `status === 'waiting'`, render an OVERLAY from `mm.matchmaking`
@@ -552,6 +569,35 @@ fights (many writers). A ball on `objects` glides and has one owner. That's the
   nearest `tier.remoteAvatarCap` remotes (`$genex-threejs-adaptive-quality`) — freeze the
   mixer and billboard or hide the rest; a room allows up to 64 players and 64 live avatars
   is a real phone memory kill on its own.
+- **Build each remote's body exactly ONCE — reserve the id BEFORE the first `await`.** You read
+  `room.players` every frame, but loading a body is async and slow (seconds). If the only guard is
+  the map you fill *after* the await, every frame in that window passes it: you spawn one body per
+  frame, each stranded where it spawned — a trail of frozen clones behind the moving player — plus
+  dozens of wasted loads. Mark the id synchronously, and drop the body if that player left mid-load:
+
+  ```ts
+  const bodies = new Map<string, Body>();
+  const loading = new Set<string>();                      // the seat reservation
+  function ensureBody(p: Player) {
+    if (bodies.has(p.id) || loading.has(p.id)) return;    // BOTH — checked before any await
+    loading.add(p.id);
+    void (async () => {
+      try {
+        const body = await loadVrmClone(p.avatarUrl || "./assets/avatar.vrm");
+        if (!room.activePlayers.has(p.id)) return;        // left while loading — never add it
+        scene.add(body.scene);
+        bodies.set(p.id, body);
+      } finally { loading.delete(p.id); }                 // always release, success or throw
+    })();
+  }
+  // Each frame: ensureBody for every remote, then drop bodies whose id is gone.
+  for (const [id, body] of bodies) {
+    if (!room.activePlayers.has(id)) { scene.remove(body.scene); bodies.delete(id); }
+  }
+  ```
+
+  The same rule covers anything else you lazily load per player or per object (nameplates, weapon
+  models, audio): a check that straddles an `await` is not a guard.
 - `room.activePlayers` — the connected-only subset of `room.players`; use its size for live quorum.
 - `room.objects` — shared objects nobody owns until claimed (a ball, an NPC):
   - `claim(id)` — **legacy** optimistic request. It flips local ownership immediately and is corrected

package/templates/skills/genex-updates/SKILL.md

@@ -38,7 +38,7 @@ update, so update immediately.)
 Run exactly the command the nudge printed, from the game project root:
 
 ```bash
-npm i -D @genex-ai/cli-demo@latest   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@dev   # the genex CLI (a dev dependency)
 npm i @genex-ai/embed-sdk@latest     # identity/saves SDK (ships inside the game)
 npm i @genex-ai/multiplayer@latest   # multiplayer SDK (only if the game uses it)
 ```