@genex-ai/cli-demo 0.15.0 → 0.16.0

package/dist/index.js

@@ -1110,6 +1110,24 @@ async function detectMultiplayer(cwd = process.cwd()) {
     return false;
   }
 }
+async function detectMatchmaking(log, cwd = process.cwd()) {
+  let pkg;
+  try {
+    pkg = JSON.parse(await fs8.readFile(path9.join(cwd, "package.json"), "utf8"));
+  } catch (err) {
+    log.dim(`  (skipping matchmaking \u2014 couldn't read package.json: ${String(err)})`);
+    return null;
+  }
+  const mm = pkg.genex?.matchmaking;
+  if (mm && typeof mm.preset === "string" && mm.preset) {
+    return {
+      preset: mm.preset,
+      ...mm.winCondition ? { winCondition: mm.winCondition } : {},
+      ...mm.config ? { config: mm.config } : {}
+    };
+  }
+  return null;
+}
 async function runPublish(opts) {
   const log = createLogger({ quiet: opts.quiet });
   log.plain(c.bold("genex publish"));
@@ -1151,6 +1169,8 @@ async function runPublish(opts) {
     const embedSdkVersion = await detectEmbedSdkVersion();
     if (embedSdkVersion) body.embedSdkVersion = embedSdkVersion;
     body.multiplayer = await detectMultiplayer();
+    const matchmaking = await detectMatchmaking(log);
+    if (matchmaking) body.matchmaking = matchmaking;
     res = await fetch(`${apiUrl}/api/projects/${meta.id}/publish`, {
       method: "POST",
       headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },

package/package.json

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

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

@@ -37,7 +37,62 @@ example, the shared-object/ball code, rotation, and host usage. Read
 npm i @genex-ai/multiplayer
 ```
 
-`objects` and `host` need `@genex-ai/multiplayer` **≥ 0.4.0**.
+This skill targets `@genex-ai/multiplayer` **≥ 0.7.0** (`objects`/`host` since 0.4; `matchmake()` since 0.5; presets + `score()`/`finish()` since 0.6; `createPrivate()`/`joinPrivate()` since 0.7).
+
+## Matchmaking (competitive presets — server-owned)
+
+When players should be **matched into separate capped rooms** rather than share one big room (a 1v1
+duel, an FFA arena, N-v-N teams, an invite lobby), use `matchmake()` instead of `connect()`. It
+returns a handle whose **`session` is `null` while searching** — render your OWN "finding a match…"
+HUD from `mm.matchmaking` (its `status`, `queue.position`, `players`/`opponents`, `teams`, `scores`,
+`winCondition`), and switch to the game once `session` goes live:
+
+```ts
+// Pass auth as a FUNCTION — one matchmake() handle re-joins the queue/match many times (re-search,
+// requeue) over a session, and embed tokens rotate (~10 min). A function is read fresh each (re)join;
+// a static object goes stale and gets rejected mid-session.
+const mm = await matchmake<MyState>({ url, room: slug, auth: () => getColyseusAuth() });
+mm.on('matched', () => {/* session is live — start the game */});
+// each frame: if (mm.session) renderGame(mm.session); else renderSearchingHud(mm.matchmaking);
+mm.on('matchEnded', ({ winnerId, scores, draw }) => {/* result screen */});
+mm.on('error', (e) => {/* a (re)join failed, e.g. auth — usually transient; the handle keeps searching */});
+
+// Report ONLY your own outcome — the server adjudicates. Which call fits depends on the win condition:
+mm.eliminated();   // I'm out              (lastStanding)
+mm.score(1);       // I scored             (firstToScore / highScoreInTime)
+mm.finish();       // I finished the race  (firstToFinish)
+```
+
+Everything is **server-owned** — set once in `package.json` under `genex.matchmaking`, reported at
+publish; the client declares nothing. You never run matchmaking logic: the server owns the queue,
+roles, winner-stays, forfeit, timeout, and the win condition.
+
+```jsonc
+"genex": {
+  "matchmaking": {
+    "preset": "arena",                 // duel | arena | teams | private
+    "winCondition": "firstToScore",    // lastStanding | firstToScore | highScoreInTime | firstToFinish
+    "config": { "scoreTarget": 20, "maxPlayers": 8 }   // numeric knobs, optional
+  }
+}
+```
+
+Presets: **duel** (1v1 winner-stays), **arena** (N-player FFA, join-anytime), **teams** (balanced
+N-v-N), **private** (invite-code lobby). Win conditions: **lastStanding** (last one alive),
+**firstToScore** (first to the score target), **highScoreInTime** (top score at the time cap),
+**firstToFinish** (first to finish). A round that hits the time cap undecided is a draw.
+
+**Private lobbies** (for `preset: 'private'`) don't use `matchmake()` — a host makes an invite code
+and friends join it; the lobby is persistent (rounds replay, nobody is evicted):
+
+```ts
+import { createPrivate, joinPrivate } from "@genex-ai/multiplayer";
+const lobby = await createPrivate<MyState>({ url, room: slug, auth: () => getColyseusAuth() });  // live NOW
+showCode(lobby.code);                                                   // share this
+// a friend, elsewhere:
+const lobby = await joinPrivate<MyState>(code, { url, room: slug, auth: () => getColyseusAuth() });
+// same handle API as matchmake(): lobby.session, lobby.matchmaking, eliminated()/score()/finish(), cancel()
+```
 
 ## Connect