@genex-ai/multiplayer 0.12.0 → 0.13.0

package/README.md

@@ -65,7 +65,7 @@ for (const [id, p] of room.players) {
 
 Remote players glide instead of teleporting between network updates — see **[Smoothing remote players](#smoothing-remote-players)**.
 
-Each player also carries `p.avatarUrl` — the VRM avatar that player picked on their genex profile (guests get a per-session pick), verified server-side from their identity token so it can't be spoofed. Render each player's own look with it (e.g. `loadVrm(p.avatarUrl || "./assets/avatar.vrm")` in a VRM-lane game); it's `''` when unknown (older relay/API), so always keep a bundled fallback. Don't put an avatar URL in your `me.set` state — this field replaces that.
+Each player also carries `p.avatarUrl` — the VRM avatar that player picked on their genex profile (guests get a per-session pick), verified server-side from their identity token so it can't be spoofed. It's the **fallback** body, not the default one: in a game that generated its own character, every player wears that character, and `p.avatarUrl` renders each player's own look only when the game has none. The genex controller kit's `loadRemotePlayerCharacter({ avatarUrl: p.avatarUrl })` makes that decision for you and shares one parsed base across remotes. The field is `''` when unknown (older relay/API), so always keep a bundled fallback. Don't put an avatar URL in your `me.set` state — this field replaces that.
 
 ## `shared` — shared room state
 

package/dist/index.d.ts

@@ -204,6 +204,19 @@ type Session<TState extends Record<string, unknown>> = {
      * by the relay itself (`state`, `shared`, `claim`, `obj`, `release`, `destroy`, and the
      * `match:`/`__` prefixes) are refused with a console warning — pick another name. */
     send(type: string, payload?: unknown): void;
+    /**
+     * HOST ONLY. Stop (or resume) the matchmaker placing NEW players into THIS room.
+     *
+     * For a lobby game: call `setRoomOpen(false)` when your match starts, so arrivals
+     * form the NEXT room instead of dropping into a fight already in progress, and
+     * `setRoomOpen(true)` when you return to the lobby. Everyone already in the room
+     * keeps playing, and a reconnecting player still gets back in (reconnection uses a
+     * reserved seat, not matchmaking).
+     *
+     * Ignored (with no error) when called by a non-host — read `isHost` first. All
+     * clients are told either way, so you can render "closed" from the `room:open` event.
+     */
+    setRoomOpen(open: boolean): void;
     /** Leave the room (deliberate — no auto-reconnect, no `disconnect` event). */
     leave(): void;
 };

package/dist/index.js

@@ -25,6 +25,7 @@ var CAPABILITIES_REQUEST_MSG = "__capabilities:request";
 var OBJECT_CONTROL_RESULT_MSG = "__object:result";
 var OBJECT_CONTROL_VERSION = 2;
 var STATE_SNAP_MSG = "__state:snap";
+var ROOM_OPEN_MSG = "__room:open";
 var OBJECT_SNAP_MSG = "__object:snap";
 var MP_PROTOCOL = 2;
 async function relayClient(opts) {
@@ -913,6 +914,9 @@ function attachSession(client, initialRoom) {
       }
       send0(type, payload, true);
     },
+    setRoomOpen(open) {
+      room.send(ROOM_OPEN_MSG, { open });
+    },
     leave() {
       intentionalLeave = true;
       connected = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/multiplayer",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "The multiplayer client wrapper + shared room schema for genex.",
   "type": "module",
   "main": "./dist/index.js",