@genex-ai/cli-demo 1.6.7-dev.444 → 1.7.0-dev.445

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.6.7-dev.444",
+  "version": "1.7.0-dev.445",
   "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/voice/voice-proximity.ts

@@ -60,7 +60,9 @@ export interface ProximityVoiceOptions {
   maxDistance?: number;
   /** Falloff steepness. Default 1.4 — a little sharper than linear reads as "nearby". */
   rolloffFactor?: number;
-  /** TURN servers. Without one, players behind symmetric NAT never connect (~10–20%). */
+  /** OVERRIDE the ICE servers. You do not need this — the SDK fetches relay (TURN)
+   *  credentials from the platform on join, which is what lets the ~15% of players behind
+   *  symmetric NAT or carrier CGNAT be heard at all. Set it only to run your own TURN. */
   iceServers?: RTCIceServer[];
   /** Push-to-talk key. Default "KeyV"; pass null for open-mic. */
   pushToTalkKey?: string | null;

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

@@ -46,8 +46,9 @@ npm i @genex-ai/multiplayer@^0.12.0
 > landed in 0.10; confirmed object controls, snaps, host-tick teardown, and reconnect rebasing
 > in 0.9. An older resolve does not have those.
 
-This skill targets `@genex-ai/multiplayer` **≥ 0.15.0** (`objects`/`host` since 0.4; verified per-player `avatarUrl` since 0.12;
+This skill targets `@genex-ai/multiplayer` **≥ 0.16.0** (`objects`/`host` since 0.4; verified per-player `avatarUrl` since 0.12;
 room text chat via `room.chat` since 0.14; mesh voice via `room.voice` since 0.15;
+automatic TURN (voice connects behind symmetric NAT with no configuration) since 0.16;
 `matchmake()` since 0.5; private lobbies since 0.7; auto-reconnect + `inputs`/`onHostTick`
 since 0.8; soft ownership handoff since 0.8.4; confirmed controls, snap epochs, and host-tick
 lifecycle guarantees since 0.9; regional relay selection via `getColyseusUrls()` since 0.10; host-only `setRoomOpen()` since 0.13;
@@ -673,9 +674,12 @@ fights (many writers). A ball on `objects` glides and has one owner. That's the
   prompt and audio playback on a user gesture — and it REJECTS when the player denies the
   mic, which is an ordinary outcome to show, not an error to swallow. For a 3D game use
   `npx genex controller voice` (proximity audio + push-to-talk); it joins with
-  `{ spatial: true }` and drives a `THREE.PositionalAudio` per speaker. **Configure TURN
-  for anything real**: ~10–20% of players are behind symmetric NAT and connect to nobody
-  without it, while everyone else works — a miserable bug to diagnose from a report.
+  `{ spatial: true }` and drives a `THREE.PositionalAudio` per speaker. **TURN is automatic
+  — do not pass `iceServers`**: `join()` fetches short-lived relay credentials from the
+  platform before opening any peer connection, which is what lets the ~15% of players behind
+  symmetric NAT or carrier CGNAT be heard at all (in a mesh they fail every leg, so they
+  connect to nobody while everyone else works — a miserable bug to diagnose from a report).
+  Passing `iceServers` overrides this and is only for running your own TURN.
 - `room.inputs.send(payload)` / `room.inputs.on((fromId, payload) => …)` — the host-routed
   input channel for host-authoritative physics: anyone sends, ONLY the current host receives.
   See [references/host-physics.md](references/host-physics.md).