94-int: Share a Game (follow the game from your page, Topple tower, the Publish-sheet note), Public rooms + Connect chip, phone Play HUD, What's new 1.57

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: AlexZ005

docs/connection.md

@@ -22,7 +22,8 @@ chip — tap it for your ID, the join field, Info and Toasts. The signaling link
 
 Since 1.32 the connection status is a **coloured dot**. On a computer the full bar keeps your invite ID and the peer-ID
 field, with the dot at its left end. On a phone the chip at the top of the screen says the state beside the dot —
-**Connected**, **Connecting…** or **Offline** — whenever the top bar has room. When the bar is crowded (people are
+**Connect** (not connected yet, the same word as on a computer), **Connecting…**, **Connected** or **Offline** (the peer
+server cannot be reached) — whenever the top bar has room. When the bar is crowded (people are
 connected and you are in a call, so the peers button and the microphone take the space) it shrinks back to the dot and
 a ▾ (and the microphone while you are in a call).
 
@@ -68,6 +69,15 @@ Right-click a person (long-press on touch, <kbd>Shift</kbd>+<kbd>F10</kbd> from
 their profile, Go to, Watch, Mute, Hide — and, for the host or an admin, **Remove from session** and **Remove and
 block**. See [Users and moderation](people.md). An AI agent shows a robot and "AI" instead of a character.
 
+**Public rooms in the panel** (*since 1.57*). On theprototype.app the panel also lists the live [public rooms](#public-rooms-theprototypeapp)
+and who is in them, under their own **Public rooms** heading below your session — *live rooms anyone can join, not part
+of your session*. The people listed there are not connected to you; **Watch** beside them is greyed with the reason.
+
+![The Connected panel on a folded phone: Peer (you) in an Untitled scene, then the Public rooms heading with the line Live rooms anyone can join — not part of your session, a room called Atrium and Someone Else in it, Playing, with Watch.](img/connection/public-rooms-phone.webp){ .shot width="390" height="206" loading=lazy }
+/// caption
+Public rooms under their own heading, apart from your session.
+///
+
 ### Inviting someone
 
 1. **Copy your invite link** (the 📋 button) and send it to a friend.

docs/img/connection/public-rooms-phone.webp

@@ -52,6 +52,14 @@ with a contributing guide and an `llms.txt` for coding agents.
 
 ## What's new
 
+**1.57 — shared games start fast.** Play links, embeds and pasted links now open the [play view](share-a-game.md): the
+game, its HUD and touch controls and none of the editor — about a third less to load, so a shared game's first picture
+comes several seconds sooner on a phone. **Invite ▸ Person** has a [Play link](share-a-game.md#play-together-from-a-link)
+that brings friends into your session straight into the game. On a narrow phone the game's HUD now sits below the Play
+buttons ([touch controls](touch-controls.md)), the connection chip says **Connect** before you connect, and live public
+rooms have their own heading in the [Connected panel](connection.md#who-is-here-the-peers-panel). To try it, open
+**Templates ▸ Topple tower**, a tiny game set up for sharing.
+
 **1.56 — agents build the whole shape and the whole look.** An agent, the in-app Assistant and Claude on claude.ai can
 now [make shapes](ai/agent-geometry.md) the basic objects cannot (a vase on a lathe, a rail along a path, an extruded
 sign, a mesh from its own points), reshape and model them, and [dress them](ai/agent-look.md): materials and textures —

docs/index.md

@@ -5,7 +5,10 @@ a game, an invite to play together — opens the **play view**: a small player m
 the game's rules, HUD and touch controls, and none of the editor, so a shared game starts noticeably faster, most of all
 on a phone.
 
-<!-- 94-routes: screenshots img/share-a-game/ come from the 94 proof run (client-plugin smoke:play) — re-shoot from the 1.57 preview -->
+!!! tip "Start from Topple tower"
+    **Templates ▸ Topple tower** is a tiny game set up for sharing: no modules or packs to download, so its play link
+    starts fast on a phone, and nothing on top of the screen for the play view's buttons to cover. Change it, publish it,
+    send the play link.
 
 | You want… | Share | Who can open it |
 |---|---|---|
@@ -18,7 +21,8 @@ on a phone.
 
 Publish a scene (**Menu ▸ Publish / Export ▸ Publish**, see [Publish & Export](publish-export.md#publish-the-play-link))
 and you get its play link, `https://theprototype.app/p/‹id›`, with a **QR code** for a phone or a headset. The
-community page's **▶ Play** button and its **3D preview** open the same play view.
+community page's **▶ Play** button and its **3D preview** open the same play view. The first time, a note under the link
+says what it opens and where the link for playing together is; it goes once you copy or open the link.
 
 The play view shows a start card with **▶ Play** (and **Enter VR** in a headset's browser), a fullscreen button, the
 *Made with ThePrototype* badge and two links into the full app:
@@ -51,6 +55,22 @@ https://theprototype.app/oembed?url=https://theprototype.app/s/‹id›&maxwidth
 
 Details (sizes, what is accepted) are in [Community ▸ oEmbed](community.md#paste-a-link-get-a-game-oembed).
 
+## Follow the game from your page
+
+For site builders: the play view tells the page that frames it what it is doing, with `postMessage`:
+
+```js
+window.addEventListener('message', (e) => {
+  if (e.data?.type !== 'tp-play') return;
+  // e.data.event: 'first-frame' | 'loaded' | 'playing' | 'stopped' | 'error'
+  console.log(e.data.event, e.data.detail);
+});
+```
+
+Inside the play view, `window.tpPlay` gives a script the same information: `version` (1), `state` (`booting`,
+`loading`, `ready`, `playing` or `error`, mirrored on `<html data-tp-play="…">` for CSS), `ready` and `loaded`
+(promises), `sceneId`, `openInEditorUrl()`, `remixUrl()` and `timings`.
+
 ## Play together from a link
 
 You can invite people straight into the play view of the session you are in — they play with you, without seeing the

docs/share-a-game.md

@@ -4,11 +4,15 @@ On a phone or tablet, Play shows a **move stick** on the left, a **look drag** o
 buttons** — Jump, Throw, Grab, Use… — exactly the actions the game needs. Every control can be moved, resized and faded,
 and any button can wear your own pressed and released images.
 
-![Sky Run in Play on a folded phone: the stage name, the timer and the coins at the top, the move stick in the lower left and the Jump button in the lower right, over the first platform of the level.](img/touch-controls/sky-run-phone.webp){ .shot width="390" height="896" loading=lazy }
+![Sky Run in Play on a folded phone: the ✕, the Playing chip and the Menu pill along the top, the game's bar with the stage name, the timer and the coins below them, the move stick in the lower left and the Jump button in the lower right, over the first platform of the level.](img/touch-controls/sky-run-phone.webp){ .shot width="390" height="896" loading=lazy }
 /// caption
 Sky Run on a folded phone.
 ///
 
+On a narrow phone the game's own bar (stage, timer, score) sits **below** the ✕, the **Playing** chip and the **Menu**
+pill, and anything the game puts at the very bottom moves up above the play view's links, so nothing the game shows is
+hidden behind the app's buttons (*since 1.57*).
+
 ![The touch controls layout editor on a folded phone, with the Jump button selected: This game or All games, Hide, Size and Opacity sliders, Default place, Reset, Cancel and Save at the top, the move stick and the Jump button below with their names. 1: save for this game or all games. 2: the selected Jump button.](img/touch-controls/layout-editor.webp){ .shot width="390" height="896" loading=lazy }
 /// caption
 The touch controls layout editor, Jump selected.

docs/touch-controls.md

@@ -20,8 +20,9 @@ shots:
   - id: sky-run-phone
     replaces: img/touch-controls/sky-run-phone.webp
     alt: >-
-      Sky Run in Play on a folded phone: the stage name, the timer and the coins at the top, the move stick in the
-      lower left and the Jump button in the lower right, over the first platform of the level.
+      Sky Run in Play on a folded phone: the ✕, the Playing chip and the Menu pill along the top, the game's bar with
+      the stage name, the timer and the coins below them, the move stick in the lower left and the Jump button in the
+      lower right, over the first platform of the level.
     caption: Sky Run on a folded phone.
     crop: {rect: [0, 0, 390, 896]}
     fade: []