@indiegems/gem-web-sdk 11.0.0 → 11.1.0

package/docs/rooms-and-matches.md

@@ -872,11 +872,54 @@ seat stands, so `myRooms()` shows the room and `join(id)` enters it.
 | `matchmaking_not_enabled` (400) | A named template has no enabled `matchmaking` block. A config fault, not a player one. |
 | `matchmaking_unavailable` (503) | Matchmaking is turned off for the whole platform, or its store is not answering. |
 
+**A party leader can meet three more.** The platform checks that a party can be seated together
+before it queues it, so a party that could not play is told at once rather than matched and then
+dropped. Only the leader queues, so only the leader's game sees these. No ticket was made, and the
+button can be pressed again.
+
+| Code | Meaning | What to show the leader |
+| --- | --- | --- |
+| `version_data_required` (400) | The party has not launched this game together, so the platform has no record of what each member is running. | "Start the game with your party from the Arcade to queue together." Pressing again will not help until they do. |
+| `party_versions_incomplete` (409) | A member's game has not finished starting, so their version has not arrived yet. | "Waiting for your party to finish loading." This one clears by itself: queue again after a few seconds, on the player's press or on a short timer. |
+| `party_version_mismatch` (409) | A member is running a build that cannot play with the leader's. | "Someone in your party is on a different version. Everyone reload the game." |
+
+A party's `quickJoin()` and `create()` are refused the same way, with the same codes.
+
 ⚠️ **Nothing falls back to quick-join, and a game should not either.** Not on
 `matchmaking_unavailable`, not on `expired`. Quick-join puts the player in a different kind of room —
 alone, in a mode that was queued for precisely because it needs a lobby. Tell the player matchmaking is
 unavailable and leave the button where it is.
 
+## 5d. Quick-joining any of several modes
+
+A drop-in game with more than one mode can ask for whichever has players, in one call:
+
+```js
+const room = await gem.rooms.quickJoin({ templateSlugs: ['duel', 'brawl'] });
+startMode(room.templateSlug); // which one the player landed in
+```
+
+- **Open rooms of every listed template are candidates together**, ranked as a single-template
+  quick-join ranks them: the fullest first, then the closest cluster.
+- **The order matters only when no room is open.** The room that gets created is made from the
+  **first** slug listed, so put the mode an empty lobby should start in first.
+- **One to eight slugs, in place of `templateSlug`, never beside it.** A list together with
+  `templateSlug` or `templateId`, an empty list, or more than eight is refused locally, before
+  the platform is asked.
+- **Every listed template must be one players can quick-join.** One that is not refuses the whole
+  call; it is not skipped.
+- **`room.templateSlug` says which template the room is from.** It is on every room, however it was
+  entered.
+
+A call that passes `templateSlug` behaves exactly as it always has.
+
+Under a developer's tool that runs the game's server on the developer's own machine, only the first
+slug is sent. Such a room is always created rather than joined, so it would be made from the first
+template either way.
+
+This is still quick-join: the player is in a room at once, possibly alone. For "any of these modes,
+but never start short", name the same slugs on `queueForMatch()` instead.
+
 ## 6. Scope
 
 **In:** rooms, membership, host, ready state, the match lifecycle, and the dedicated-server connect

package/docs/server-bundles.md

@@ -80,8 +80,8 @@ To check the download yourself: the package npm serves is, byte for byte, the fi
 also publishes on its download host, with the hash beside it:
 
 ```bash
-curl -fsSL -O https://downloads.gemarcade.com/sdk/v11.0.0/gem-web-sdk.tgz
-curl -fsSL https://downloads.gemarcade.com/sdk/v11.0.0/gem-web-sdk.tgz.sri
+curl -fsSL -O https://downloads.gemarcade.com/sdk/v11.1.0/gem-web-sdk.tgz
+curl -fsSL https://downloads.gemarcade.com/sdk/v11.1.0/gem-web-sdk.tgz.sri
 openssl dgst -sha384 -binary gem-web-sdk.tgz | openssl base64 -A
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indiegems/gem-web-sdk",
-  "version": "11.0.0",
+  "version": "11.1.0",
   "description": "postMessage bridge contract between gem-web and browser-playable games",
   "license": "UNLICENSED",
   "type": "module",