castle-web-cli 0.4.169 → 0.4.171

package/kits/physics-2d/engine/ui.module.css

@@ -823,10 +823,10 @@
   margin-top: 14px;
 }
 
-/* The blueprint's thumbnail, doubling as the way into the sprite editor. The
-   pencil sits in the corner rather than replacing the art on hover: on touch
-   there is no hover, and the affordance has to be visible before it is
-   touched. */
+/* Thumbnail that opens the sprite editor (blueprint header + actor instance
+   header). The pencil sits in the corner rather than replacing the art on
+   hover: on touch there is no hover, and the affordance has to be visible
+   before it is touched. */
 .editSpriteButton {
   position: relative;
   display: inline-flex;
@@ -1161,9 +1161,9 @@
   height: 300%;
 }
 
-/* Game-time UI overlay -- sits exactly over the canvas and clips to the card.
-   Behavior `ui` output lands in `.sceneUiLayer`, which is sized in card units
-   and scaled onto the canvas box. */
+/* Deprecated React `ui` overlay -- prefer behavior `drawUi`. Sits over the
+   canvas and clips to the card. Behavior `ui` output lands in `.sceneUiLayer`,
+   sized in card units and scaled onto the canvas box. */
 .sceneUiRoot {
   position: absolute;
   inset: 0;
@@ -1477,9 +1477,10 @@
      row, expanded leaves a smaller gap before the body. */
   padding: 10px 16px 6px;
   border-bottom: 0;
-  /* The row owns the hold-then-drag gesture; without this the browser claims
-     the press for scrolling before the hold completes. */
-  touch-action: none;
+  /* pan-y: a vertical flick on the title / summary scrolls the inspector.
+     Reorder lives on the grip (touch-action: none), not the whole row — that
+     split is what lets scroll and reorder both work on phones. */
+  touch-action: pan-y;
   color: var(--castle-inspector-text);
   font-size: 14px;
   font-weight: 650;
@@ -1539,9 +1540,6 @@
   font-weight: 400;
 }
 
-/* Grab handle, left of the disclosure. `touch-action: none` is what makes the
-   hold-then-drag possible on touch: without it the browser claims the gesture
-   for scrolling before the hold completes and the drag never starts. */
 /* The behavior's source file. Sits at the right end of the header row, inset
    far enough to clear the remove button the inspector positions absolutely over
    the panel's top-right corner. */
@@ -1640,28 +1638,37 @@
   flex: 0 0 auto;
 }
 
-/* Affordance only: the whole header row carries the drag listeners, so this is
-   a hint rather than a target and can be small. */
+/* Drag handle for panel reorder. Owns the gesture (`touch-action: none`) so
+   the browser does not steal it for scroll; the rest of the header stays
+   pan-y. Hit target is larger than the glyph for fingers. */
 .panelGrip {
   display: inline-flex;
   align-items: center;
   justify-content: center;
   flex: 0 0 auto;
-  margin-left: -2px;
-  font-size: 7px;
+  box-sizing: content-box;
+  margin: -6px 0 -6px -6px;
+  padding: 10px 8px;
+  border: 0;
+  background: none;
+  /* Icon sizes itself in `em` via an inline style. */
+  font-size: 11px;
   color: var(--castle-inspector-muted);
-  opacity: 0.4;
+  opacity: 0.55;
+  cursor: grab;
+  touch-action: none;
+  -webkit-user-select: none;
+  user-select: none;
 }
 
-.panelGrip:hover {
+.panelGrip:hover,
+.panelGrip:focus-visible {
   opacity: 1;
+  color: var(--castle-text);
 }
 
-/* `Icon` sizes itself in `em` via an inline style, which no class rule can
-   beat -- so every one of these is sized by the button's font-size, not by a
-   width on the svg. */
-.panelGrip {
-  font-size: 9px;
+.panelGrip:active {
+  cursor: grabbing;
 }
 
 /* Every behavior row. Positioned so the lifted one can be raised above its
@@ -2786,12 +2793,17 @@
     linear-gradient(45deg, transparent 75%, #1a1a1a 75%),
     linear-gradient(-45deg, transparent 75%, #1a1a1a 75%);
   background-color: #121212;
-  background-size: 16px 16px;
+  /* The check travels with the artboard: PxArtEditor overrides --checker-size
+     with the fit size times the current zoom, so a pinch scales the
+     transparency pattern along with the art instead of re-tiling a fixed 16px
+     grid underneath it. */
+  --checker-size: 16px;
+  background-size: var(--checker-size) var(--checker-size);
   background-position:
     0 0,
-    0 8px,
-    8px -8px,
-    -8px 0;
+    0 calc(var(--checker-size) / 2),
+    calc(var(--checker-size) / 2) calc(var(--checker-size) / -2),
+    calc(var(--checker-size) / -2) 0;
   border: 1px solid var(--castle-inspector-border);
 }
 
@@ -2803,6 +2815,19 @@
   pointer-events: none;
 }
 
+/* Behind the smooth canvas, so the path-layer snap lattice paints directly on
+   the frame's own background and under everything drawn. Negative z-index
+   children paint in z order after the element's background and before in-flow
+   content, so -2 lands between the frame background and .drawingSmooth. */
+.drawingLattice {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: -2;
+}
+
 /* Behind the main canvas (negative z-index paints before static content in
    the same containing block) — holds the corner-rounded render for "smooth"
    sprites while the main canvas above it stays transparent except for tool

package/kits/physics-2d/package-lock.json

@@ -15,7 +15,6 @@
         "@dnd-kit/modifiers": "^9.0.0",
         "@dnd-kit/sortable": "^10.0.0",
         "@dnd-kit/utilities": "^3.2.2",
-        "@fortawesome/free-solid-svg-icons": "^5.15.4",
         "@lezer/highlight": "^1.2.3",
         "castle-web-fonts": "^1.0.0",
         "codemirror": "^6.0.2",
@@ -216,7 +215,6 @@
       "resolved": "https://registry.npmjs.org/@dnd-kit/core/-/core-6.3.1.tgz",
       "integrity": "sha512-xkGBRQQab4RLwgXxoqETICr6S5JlogafbhNsidmrkVv2YRs5MLwpjoF2qpiGjQt8S9AoxtIV603s0GIUpY5eYQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@dnd-kit/accessibility": "^3.1.1",
         "@dnd-kit/utilities": "^3.2.2",
@@ -411,29 +409,6 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
-    "node_modules/@fortawesome/fontawesome-common-types": {
-      "version": "0.2.36",
-      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-common-types/-/fontawesome-common-types-0.2.36.tgz",
-      "integrity": "sha512-a/7BiSgobHAgBWeN7N0w+lAhInrGxksn13uK7231n2m8EDPE3BMCl9NZLTGrj9ZXfCmC6LM0QLqXidIizVQ6yg==",
-      "hasInstallScript": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/@fortawesome/free-solid-svg-icons": {
-      "version": "5.15.4",
-      "resolved": "https://registry.npmjs.org/@fortawesome/free-solid-svg-icons/-/free-solid-svg-icons-5.15.4.tgz",
-      "integrity": "sha512-JLmQfz6tdtwxoihXLg6lT78BorrFyCf59SAwBM6qV/0zXyVeDygJVb3fk+j5Qat+Yvcxp1buLTY5iDh1ZSAQ8w==",
-      "hasInstallScript": true,
-      "license": "(CC-BY-4.0 AND MIT)",
-      "dependencies": {
-        "@fortawesome/fontawesome-common-types": "^0.2.36"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
     "node_modules/@humanfs/core": {
       "version": "0.19.2",
       "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz",
@@ -670,7 +645,6 @@
       "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -1131,7 +1105,6 @@
       "integrity": "sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
@@ -2441,7 +2414,6 @@
       "resolved": "https://registry.npmjs.org/react/-/react-19.2.7.tgz",
       "integrity": "sha512-HNe9WslTbXmFK8o8cmwgAeJFSBvt1bPdHCVKtaaV+WlAN36mpT4hcRpwbf3fY56ar2oIXzsBpOAiIRHAdY0OlQ==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -2451,7 +2423,6 @@
       "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.7.tgz",
       "integrity": "sha512-t0BRVXvbiE/o20Hfw669rLbMCDWtYZLvmJigy2f0MxsXF+71pxhR3xOkspmsO8h3ZlNzyibAmtCa3l4lYKk6gQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "scheduler": "^0.27.0"
       },

package/kits/physics-2d/package.json

@@ -16,6 +16,9 @@
       "behaviors"
     ],
     "threshold": 0,
+    "ignore": [
+      "engine/icons.js"
+    ],
     "reporters": [
       "consoleFull"
     ]
@@ -30,7 +33,6 @@
     "@dnd-kit/modifiers": "^9.0.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
-    "@fortawesome/free-solid-svg-icons": "^5.15.4",
     "@lezer/highlight": "^1.2.3",
     "castle-web-fonts": "^1.0.0",
     "codemirror": "^6.0.2",

package/kits/physics-2d/pnpm-lock.yaml

@@ -35,9 +35,6 @@ importers:
       '@dnd-kit/utilities':
         specifier: ^3.2.2
         version: 3.2.2(react@19.2.7)
-      '@fortawesome/free-solid-svg-icons':
-        specifier: ^5.15.4
-        version: 5.15.4
       '@lezer/highlight':
         specifier: ^1.2.3
         version: 1.2.3
@@ -186,14 +183,6 @@ packages:
     resolution: {integrity: sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
-  '@fortawesome/fontawesome-common-types@0.2.36':
-    resolution: {integrity: sha512-a/7BiSgobHAgBWeN7N0w+lAhInrGxksn13uK7231n2m8EDPE3BMCl9NZLTGrj9ZXfCmC6LM0QLqXidIizVQ6yg==}
-    engines: {node: '>=6'}
-
-  '@fortawesome/free-solid-svg-icons@5.15.4':
-    resolution: {integrity: sha512-JLmQfz6tdtwxoihXLg6lT78BorrFyCf59SAwBM6qV/0zXyVeDygJVb3fk+j5Qat+Yvcxp1buLTY5iDh1ZSAQ8w==}
-    engines: {node: '>=6'}
-
   '@humanfs/core@0.19.2':
     resolution: {integrity: sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==}
     engines: {node: '>=18.18.0'}
@@ -447,6 +436,7 @@ packages:
   eslint@9.39.4:
     resolution: {integrity: sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+    deprecated: This version is no longer supported. Please see https://eslint.org/version-support for other options.
     hasBin: true
     peerDependencies:
       jiti: '*'
@@ -1081,12 +1071,6 @@ snapshots:
       '@eslint/core': 0.17.0
       levn: 0.4.1
 
-  '@fortawesome/fontawesome-common-types@0.2.36': {}
-
-  '@fortawesome/free-solid-svg-icons@5.15.4':
-    dependencies:
-      '@fortawesome/fontawesome-common-types': 0.2.36
-
   '@humanfs/core@0.19.2':
     dependencies:
       '@humanfs/types': 0.15.0

package/kits/physics-3d/behaviors/Pickup.jsx

@@ -4,7 +4,9 @@
 //
 // Collection is remembered in the persistent store keyed by scene + actor id,
 // so re-entering a scene doesn't respawn (and double-count) shards
-// -- scene loads otherwise reset the world to its authored state.
+// -- scene loads otherwise reset the world to its authored state. The store is
+// a plain object, not a Set: `scene.persistent` has to survive JSON, since a
+// multiplayer kit saves it per player.
 function pickupKey(scene, actor) {
   return `${scene.currentScenePath ?? ''}:${actor.id}`;
 }
@@ -18,7 +20,7 @@ export class Pickup {
   }
 
   update(actor, scene, dt) {
-    if (scene.persistent?.collected?.has(pickupKey(scene, actor))) {
+    if (scene.persistent?.collected?.[pickupKey(scene, actor)]) {
       scene.despawnActor(actor.id);
       return;
     }
@@ -33,7 +35,7 @@ export class Pickup {
     if (!other.components.Player) return;
     const per = (scene.persistent ??= {});
     per.score = (per.score ?? 0) + 1;
-    (per.collected ??= new Set()).add(pickupKey(scene, actor));
+    (per.collected ??= {})[pickupKey(scene, actor)] = true;
     scene.despawnActor(actor.id);
   }
 }

package/kits/physics-3d/castle.json

@@ -42,7 +42,7 @@
         "ext": ".pxmodel",
         "label": "Model",
         "new": "New model",
-        "icon": "clone",
+        "icon": "cube-transparent",
         "editor": "kit",
         "data": true
       },
@@ -50,7 +50,7 @@
         "ext": ".jsx",
         "label": "Behavior",
         "new": "New behavior",
-        "icon": "code"
+        "icon": "file-code"
       }
     ],
     "defaultPlayFile": "scenes/main.scene"
@@ -58,16 +58,16 @@
   "imports": {
     "castle.physics-2d": {
       "deckId": "ckRZGFW4iPrx",
-      "version": "2026-08-31T02:59:16.016Z"
+      "version": "2026-09-10T00:57:31.408Z"
     },
     "castle.base": {
       "deckId": "yRcmH4_aYllE",
-      "version": "2026-09-01T01:02:34.326Z"
+      "version": "2026-09-10T00:56:59.388Z"
     }
   },
   "main": "main.jsx",
   "autoUpdateWhenImported": true,
   "deckId": "JH0SclbPVP0y",
   "cardId": "eXfAaUdbSU5A",
-  "publishedVersion": "2026-09-05T00:07:37.655Z"
+  "publishedVersion": "2026-09-10T20:10:28.916Z"
 }

package/kits/physics-3d/package-lock.json

@@ -16,7 +16,6 @@
         "@dnd-kit/modifiers": "^9.0.0",
         "@dnd-kit/sortable": "^10.0.0",
         "@dnd-kit/utilities": "^3.2.2",
-        "@fortawesome/free-solid-svg-icons": "^5.15.4",
         "@lezer/highlight": "^1.2.3",
         "castle-web-fonts": "^1.0.0",
         "codemirror": "^6.0.2",
@@ -224,7 +223,6 @@
       "resolved": "https://registry.npmjs.org/@dnd-kit/core/-/core-6.3.1.tgz",
       "integrity": "sha512-xkGBRQQab4RLwgXxoqETICr6S5JlogafbhNsidmrkVv2YRs5MLwpjoF2qpiGjQt8S9AoxtIV603s0GIUpY5eYQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@dnd-kit/accessibility": "^3.1.1",
         "@dnd-kit/utilities": "^3.2.2",
@@ -419,29 +417,6 @@
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
       }
     },
-    "node_modules/@fortawesome/fontawesome-common-types": {
-      "version": "0.2.36",
-      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-common-types/-/fontawesome-common-types-0.2.36.tgz",
-      "integrity": "sha512-a/7BiSgobHAgBWeN7N0w+lAhInrGxksn13uK7231n2m8EDPE3BMCl9NZLTGrj9ZXfCmC6LM0QLqXidIizVQ6yg==",
-      "hasInstallScript": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/@fortawesome/free-solid-svg-icons": {
-      "version": "5.15.4",
-      "resolved": "https://registry.npmjs.org/@fortawesome/free-solid-svg-icons/-/free-solid-svg-icons-5.15.4.tgz",
-      "integrity": "sha512-JLmQfz6tdtwxoihXLg6lT78BorrFyCf59SAwBM6qV/0zXyVeDygJVb3fk+j5Qat+Yvcxp1buLTY5iDh1ZSAQ8w==",
-      "hasInstallScript": true,
-      "license": "(CC-BY-4.0 AND MIT)",
-      "dependencies": {
-        "@fortawesome/fontawesome-common-types": "^0.2.36"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
     "node_modules/@humanfs/core": {
       "version": "0.19.2",
       "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz",
@@ -678,7 +653,6 @@
       "integrity": "sha512-lGq+9yr1/GuAWaVYIHRjvvySG5/4VfKIvC8EWxStPdcDh/Ka7FG3twP6v4d5BkravUilhIAsG4Qj83t02LWUPQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -1139,7 +1113,6 @@
       "integrity": "sha512-DgZS62aPLXKlnxILS/AYCoRvHaZeXceIzlXPkkGGzJWSow1aEk0lbTlxUSlyjC8jcaKxAdOnTDz+o1JFSBsyjw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
@@ -2449,7 +2422,6 @@
       "resolved": "https://registry.npmjs.org/react/-/react-19.2.8.tgz",
       "integrity": "sha512-PWaYA1L/q9u2u7xYQi+Y3L3Yfnie7XyLeaJICV1MGD6LprsBxcAqGjYyr0eY3p+QdsA+x/Irkt4Qif8D63+Sbw==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -2459,7 +2431,6 @@
       "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.8.tgz",
       "integrity": "sha512-rVprimfGBG3DR+Tq0IQG2DT5PxKth1WIGDmj5yPmlzr4YBe7uyE+Du4oVqTDXZSHGGGXRtTJEGSSePyQCMBglQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "scheduler": "^0.27.0"
       },

package/kits/physics-3d/package.json

@@ -29,7 +29,6 @@
     "@dnd-kit/modifiers": "^9.0.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
-    "@fortawesome/free-solid-svg-icons": "^5.15.4",
     "@lezer/highlight": "^1.2.3",
     "castle-web-fonts": "^1.0.0",
     "codemirror": "^6.0.2",

package/kits/physics-3d/pnpm-lock.yaml

@@ -38,9 +38,6 @@ importers:
       '@dnd-kit/utilities':
         specifier: ^3.2.2
         version: 3.2.2(react@19.2.8)
-      '@fortawesome/free-solid-svg-icons':
-        specifier: ^5.15.4
-        version: 5.15.4
       '@lezer/highlight':
         specifier: ^1.2.3
         version: 1.2.3
@@ -195,14 +192,6 @@ packages:
     resolution: {integrity: sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
-  '@fortawesome/fontawesome-common-types@0.2.36':
-    resolution: {integrity: sha512-a/7BiSgobHAgBWeN7N0w+lAhInrGxksn13uK7231n2m8EDPE3BMCl9NZLTGrj9ZXfCmC6LM0QLqXidIizVQ6yg==}
-    engines: {node: '>=6'}
-
-  '@fortawesome/free-solid-svg-icons@5.15.4':
-    resolution: {integrity: sha512-JLmQfz6tdtwxoihXLg6lT78BorrFyCf59SAwBM6qV/0zXyVeDygJVb3fk+j5Qat+Yvcxp1buLTY5iDh1ZSAQ8w==}
-    engines: {node: '>=6'}
-
   '@humanfs/core@0.19.2':
     resolution: {integrity: sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==}
     engines: {node: '>=18.18.0'}
@@ -1096,12 +1085,6 @@ snapshots:
       '@eslint/core': 0.17.0
       levn: 0.4.1
 
-  '@fortawesome/fontawesome-common-types@0.2.36': {}
-
-  '@fortawesome/free-solid-svg-icons@5.15.4':
-    dependencies:
-      '@fortawesome/fontawesome-common-types': 0.2.36
-
   '@humanfs/core@0.19.2':
     dependencies:
       '@humanfs/types': 0.15.0

package/kits/real-time/CLAUDE.md

@@ -20,6 +20,16 @@ imports these modules from here directly.
 - **A deck normally writes nothing against it.** The multiplayer kit it came with
   already drives all of this; a deck's own code goes in `code/server/game.js` and
   `code/client/game.js`, which that kit documents.
+- **What persists.** Object poses, the ids of scene actors a client despawned,
+  each player's last pose and state block by account, and whatever the optional
+  `save(sim)` hook returns. Written every ten seconds when something moved and
+  at a clean shutdown. Nothing to configure.
+- **A returning player starts where they left off.** A second connection from
+  the same account while the first is still playing gets a new character at the
+  spawn. The room is `session.sessionId`; every `public` shard shares one.
+- `restore(sim, saved)` receives the last `save` result before `ready`. Storage
+  is keyed by deck, so the deck must be published; `castle-web serve` brokers it
+  as the deck's creator.
 - A pose is an opaque array of numbers here, so anything reading inside one takes
   the kit's `code/client/poses.js` as an argument. That is the seam to use when
   something genuinely needs a lower level.
@@ -59,10 +69,19 @@ never learns the format.
 values of a player pose are geometry before the `clamped` flag, and `epsilonAt`,
 which a kit whose pose values are all one unit leaves undefined.
 
-`soloBadge.js` is the one file here that touches the DOM: a fixed badge that
-names why a session fell back to solo (`status().soloReason` from
-`connection.js`), drawn by both kits each frame through `updateSoloBadge`. It
-stays dependency-free and hides itself when a deck's `soloBadge` hook says so.
+Persistence adds to that contract: `world.restorePoses(sim, poses)` puts saved
+poses back on the bodies the scene still has, and `players.addPlayer` takes the
+saved pose a returning player starts from. Optional beside those:
+`world.removeActor(sim, id)` drops a despawned actor's body, and
+`players.setState` / `players.stateOf` keep the block a client reports.
+
+Two files here touch the DOM, both dependency-free. `soloBadge.js` is a fixed
+badge that names why a session fell back to solo (`status().soloReason` from
+`connection.js`), drawn by both kits each frame through `updateSoloBadge`; a
+deck's `soloBadge` hook hides it. `joinOverlay.js` covers the card with
+"Joining…" from the first frame until the session's first snapshot places the
+player, so nobody plays from the scene's spawn before the saved spot arrives;
+it gives up after ten seconds with a console warning.
 
 ## Rules for editing this kit
 

package/kits/real-time/castle.json

@@ -15,5 +15,5 @@
   "autoUpdateWhenImported": true,
   "deckId": "xFVr-afOLuUQ",
   "cardId": "w6G45sy3_P_m",
-  "publishedVersion": "2026-09-05T01:31:28.578Z"
+  "publishedVersion": "2026-09-10T20:10:30.302Z"
 }

package/kits/real-time/code/client/connection.js

@@ -81,7 +81,8 @@ export async function connectSession({ onLog = () => {} } = {}) {
     // the transport handles every dimensional format in the same way.
     // The client system calls this every frame; most calls only accumulate the
     // ownership requests, which are held until the next rate-limited send.
-    sendMove: (pose, owned, claims, releases) => sendMove(net, pose, owned, claims, releases),
+    sendMove: (pose, owned, claims, releases, state) =>
+      sendMove(net, pose, owned, claims, releases, state),
 
     // Send deck-specific data. The server routes these to `code/server/game.js`.
     send: (data) => net.connection.send(data),
@@ -106,8 +107,10 @@ export async function connectSession({ onLog = () => {} } = {}) {
   };
 }
 
-// Collect ownership requests from every frame and send at `MOVE_HZ`.
-function sendMove(net, pose, owned, claims, releases) {
+// Collect ownership requests from every frame and send at `MOVE_HZ`. `state` is
+// the player's own block, sent along when the caller has one to send. Returns
+// whether a packet went out.
+function sendMove(net, pose, owned, claims, releases, state) {
   // Gathered on every frame, including the ones that send nothing, so a claim
   // made in between is still in the next message. The sets also collapse
   // repeated requests for the same object over that interval.
@@ -119,7 +122,7 @@ function sendMove(net, pose, owned, claims, releases) {
   }
   const now = performance.now();
   if (now - net.sentAt < SEND_MS) {
-    return;
+    return false;
   }
   net.sentAt = now;
 
@@ -130,9 +133,11 @@ function sendMove(net, pose, owned, claims, releases) {
     c: [...net.claims],
     r: [...net.releases],
     o: owned,
+    ...(state === undefined ? {} : { s: state }),
   });
 
   // Clear only after a packet; rate-limited returns above retain the requests.
   net.claims.clear();
   net.releases.clear();
+  return true;
 }

package/kits/real-time/code/client/joinOverlay.js

@@ -0,0 +1,46 @@
+// A full-card overlay shown from connecting until the server's first snapshot
+// places this player. Under it the local character may still be standing at the
+// scene's spawn; the overlay hides that and takes the pointer, so nothing is
+// played until the session says where things are.
+//
+// It mounts inside the card when the sdk has marked one, so a capture of the
+// card (a cover, a playtest frame) includes it; otherwise it covers the page.
+//
+// Dependency-free DOM, like the solo badge: the kits draw their scenes
+// differently and share no HUD.
+
+let element = null;
+
+// Show or hide the overlay. Idempotent; cheap enough to call every frame.
+export function showJoinOverlay(visible) {
+  if (typeof document === 'undefined') {
+    return;
+  }
+  if (!visible) {
+    element?.remove();
+    element = null;
+    return;
+  }
+  if (element) {
+    return;
+  }
+  const card = document.querySelector('#castle-card, [data-castle-card]');
+  if (card && getComputedStyle(card).position === 'static') {
+    card.style.position = 'relative';
+  }
+  element = document.createElement('div');
+  element.setAttribute('data-castle-join-overlay', '');
+  element.style.cssText = [
+    card ? 'position:absolute' : 'position:fixed',
+    'inset:0',
+    'display:flex',
+    'align-items:center',
+    'justify-content:center',
+    'background:#0a0a0a',
+    'color:#fff',
+    'font:500 15px/1.4 system-ui,sans-serif',
+    'z-index:2147483646',
+  ].join(';');
+  element.textContent = 'Joining…';
+  (card ?? document.body).appendChild(element);
+}

package/kits/real-time/code/client/messages.js

@@ -15,6 +15,10 @@ export const MOVE = 'i';
 export const WORLD = 'w';
 export const STATE = 's';
 
+// A client reports that it removed a scene actor: `{ k: GONE, id }`. The
+// session removes it for everyone, for good.
+export const GONE = 'g';
+
 // Movement reports run below the render rate and below the platform's roughly
 // 30-message-per-second client cap. A second report inside one server tick would
 // be overwritten before the simulation read it.

package/kits/real-time/code/server/gameHooks.js

@@ -21,8 +21,12 @@ const bodyModules = {
 // `session.js` receives this value from the dimensional kit's server entry and
 // calls the hooks at the stages listed below.
 //
+//   restore(sim, saved)           the value the last `save` returned for this
+//                                 room, or null. Runs before `ready`
 //   ready(sim)                    after the world and its scene bodies exist,
 //                                 before the first server tick
+//   save(sim)                     JSON kept for this room, written with the
+//                                 world every ten seconds and at shutdown
 //   message(session, player, d)   client data that is not a pose report. It
 //                                 receives no handover list, so a world change
 //                                 is kept and applied later by `place` or `step`