@genex-ai/multiplayer 0.17.0 → 0.17.1

package/PROTOCOL.md

@@ -33,10 +33,11 @@ The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY are used as in RFC 2119
 
 The embed layer supplies a list of regional relay URLs (`getColyseusUrls()` from `@genex-ai/embed-sdk`; the API returns it as `colyseus.urls` with the embed session).
 - With one URL, the client uses it.
-- With several, it SHOULD measure latency to each (Colyseus `getLatency` / `Client.selectByLatency`) and use the lowest.
-- An explicit invite URL (a friend's region) MUST override selection. Rooms exist per relay, so two players share a room only if they share a URL.
+- With several, it SHOULD measure latency to each (Colyseus `getLatency`) and use the lowest. A probe is a preference, never a gate: when a relay does not answer in time, the client MUST still join — the lowest-latency relay that did answer, else the first URL. (Colyseus `Client.selectByLatency` throws instead; the TS SDK does not use it.)
+- An explicit invite URL (a friend's region) MUST override selection.
+- Regional relays MAY share presence (one room registry). Then every relay serves every room: two players meet whichever relay each enters through, and a seat reservation's `publicAddress` names the relay process that owns the room. Without shared presence, rooms exist per relay, so two players share a room only if they share a URL.
 
-A client MUST keep using the chosen URL for the life of a session, across reconnects and seat reservations.
+A client MUST keep using the chosen URL for the life of a session, across reconnects and seat reservations — as its matchmaking and reconnect entry. The room socket itself goes where the reservation says: `<publicAddress>/<processId>/<roomId>` when `publicAddress` is present (every official Colyseus SDK does this), else the chosen URL.
 
 ### 3.2 Embed token
 

package/README.md

@@ -581,7 +581,8 @@ not the page a friend should land on. Any parameter name works except the platfo
 (`embed`, `ref`, `s`, `from`, `remix`, `slug`, and everything starting `genex_`).
 
 `joinPrivate` rejects when the code does not lead to a lobby this player can reach: it has
-closed, or its host is on another region's relay than this player's nearest one. Catch it
+closed, or (only where the regional relays do not share presence) its host is on another
+region's relay than this player's nearest one. Catch it
 and show the menu. Keep the typed code as the second way in: a shell that does not pass the
 link's parameter on yet opens the game without it.