@genex-ai/multiplayer 0.8.7 → 0.8.8

package/README.md

@@ -250,7 +250,8 @@ else renderSearchingHud(mm.matchmaking);
 mm.on("matched", () => {/* session is live */});
 mm.on("matchStart", ({ roundId }) => {/* round began */});
 mm.on("matchEnded", ({ winnerId, scores, draw }) => {/* result screen */});
-mm.on("spectate", () => {/* seated as a spectator (overflow) — read-only */});
+mm.on("spectate", () => {/* DEPRECATED — never fires: there are no server-side spectators anymore.
+                            An overflow searcher now waits in the queue instead of watching. */});
 mm.on("error", (e) => {/* queue join failed even after the SDK's automatic retries — persistent
                           (broken auth / server unreachable); fix the cause, then mm.retry() */});
 
@@ -267,7 +268,7 @@ A failed queue join is **retried automatically** with backoff (~10s total), so t
 (a token mid-rotation, identity still settling on page load) never surface. Only a persistent
 failure emits `error`; the handle then idles until you call `mm.retry()`.
 
-**`mm.matchmaking`** (read every frame for your HUD): `status` (`searching` | `waiting` | `countdown` | `playing` | `ended` | `spectating`), `queue` (`{ position, size }`), `players`, `opponents`, `teams`, `myTeam`, `scores`, `winCondition`, `config` (numeric knobs), `roundId`, `winnerId`, `message`. `championId`/`challengerId` are 1v1 aliases.
+**`mm.matchmaking`** (read every frame for your HUD): `status` (`searching` | `waiting` | `countdown` | `playing` | `ended`; the legacy `spectating` is never emitted — server-side spectators were removed), `queue` (`{ position, size }`), `players`, `opponents`, `teams`, `myTeam`, `scores`, `winCondition`, `config` (numeric knobs), `roundId`, `winnerId`, `message`. `championId`/`challengerId` are 1v1 aliases.
 
 Configure once in the game's `package.json` (reported at `genex preview` AND `genex publish`;
 removing it clears the stored config on the next preview/publish — never sent from the client):
@@ -275,14 +276,16 @@ removing it clears the stored config on the next preview/publish — never sent
 ```jsonc
 "genex": {
   "matchmaking": {
-    "preset": "arena",                 // duel | arena | teams | private
+    "preset": "arena",                 // open | 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**, **firstToScore**, **highScoreInTime**, **firstToFinish**; a round that hits the time cap undecided is a draw.
+Presets: **open** (a room of N players, your rules — see below), **duel** (1v1 winner-stays), **arena** (N-player FFA, join-anytime), **teams** (balanced N-v-N), **private** (invite-code lobby). Win conditions (for the batteries-included presets): **lastStanding**, **firstToScore**, **highScoreInTime**, **firstToFinish**; a round that hits the time cap undecided is a draw.
+
+**`open` — bring your own rules.** The minimal preset: the server owns only seating, capacity, and refill; you build teams, rounds, scoring, and win logic yourself on `session.shared` + host election. It runs no match loop, so `status` only goes `waiting`→`playing` (never `ended`), `scores`/`winnerId` stay empty, and **nobody is ever evicted** (no `matchEnded`, no requeue). Config knobs: `minPlayers` (quorum to flip to `playing`; default 1), `maxPlayers` (seat cap, clamped 2–64), `fill` (`1` = keep the room full — grow to max and refill a seat a leaver frees, the default; `0` = lock the room for good once it is simultaneously full (max players at once) — a match with no substitutes; a freed seat stays closed). Pick `open` when you want your own rules; pick duel/arena/teams for a ready-made match loop.
 
 ### Private lobbies — `createPrivate` / `joinPrivate`
 

package/package.json

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