castle-web-cli 0.4.232 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -7,14 +7,48 @@
7
7
  import * as castleSdk from 'castle-web-sdk';
8
8
  import * as Avatars from '@imports/castle.multiplayer-3d/code/client/avatars.js';
9
9
  import * as Avatar from './avatar.js';
10
+ import * as AvatarCap from './avatarCap.js';
11
+ import { mergeDictionary } from './interestCap.js';
10
12
  import * as Cabinets from './cabinets.js';
11
13
  import { firstJoinFor } from './firstJoin.js';
12
- import { deck, hub, wearingNow } from './state.js';
14
+ import { deck, earnedNow, hub, mergeHidden, wearingNow } from './state.js';
15
+ import { clearShot, receiveShot } from './shot.js';
16
+ import * as Ballot from './ballot.js';
17
+ import * as Rehello from './rehello.js';
18
+ import { sanitise, ownStamp } from './companion.js';
19
+ import { buildStamp } from './build.js';
13
20
 
14
21
  // Root-anchored: the deck's own castle.json once this kit is imported.
15
22
  const castleJson = Object.values(import.meta.glob('/castle.json', { eager: true, import: 'default' }))[0] ?? {};
23
+ // The assembly's build stamp beside it; an absent file matches nothing.
24
+ deck.build = buildStamp(Object.values(import.meta.glob('/build.json', { eager: true, import: 'default' }))[0]);
16
25
  deck.tiers = castleJson?.hub?.tiers === true;
26
+ if (castleJson?.hub?.lowActorDistance === true) { deck.lowActorDistance = true; }
27
+ else { delete deck.lowActorDistance; }
28
+ if (castleJson?.hub?.lowActorBudget === true) { deck.lowActorBudget = true; }
29
+ else { delete deck.lowActorBudget; }
30
+ if (castleJson?.hub?.companionIdle === true) { deck.companionIdle = true; }
31
+ else { delete deck.companionIdle; }
17
32
  deck.cues = castleJson?.hub?.cues === true;
33
+ deck.yourGames = castleJson?.hub?.yourGames === true;
34
+ if (castleJson?.hub?.avatarColors === true) {
35
+ deck.avatarColors = true;
36
+ }
37
+ deck.stuck = castleJson?.hub?.stuck === true;
38
+ deck.labels = castleJson?.hub?.labels === 'near';
39
+ // `hub.soundscape`: true, or an object with optional ground, ambience and UI.
40
+ const soundscape = castleJson?.hub?.soundscape;
41
+ deck.soundscape = soundscape === true || (soundscape && typeof soundscape === 'object' && !Array.isArray(soundscape)) ? {
42
+ babble: soundscape.babble !== false,
43
+ steps: soundscape.steps && typeof soundscape.steps === 'object' && !Array.isArray(soundscape.steps) ? soundscape.steps : soundscape.steps !== false,
44
+ ...(typeof soundscape.zones === 'string' ? { zones: soundscape.zones } : {}),
45
+ ...(soundscape.ambience && typeof soundscape.ambience === 'object' && !Array.isArray(soundscape.ambience) ? { ambience: soundscape.ambience } : {}),
46
+ ...(Object.hasOwn(soundscape, 'ui') && typeof soundscape.ui === 'boolean' ? { ui: soundscape.ui } : {}),
47
+ ...(Object.hasOwn(soundscape, 'cues') && typeof soundscape.cues === 'boolean' ? { cues: soundscape.cues } : {}),
48
+ } : null;
49
+ if (deck.soundscape?.cues === true) {
50
+ hub.cueEvents = [];
51
+ }
18
52
 
19
53
  let files = null;
20
54
  // The scene and multiplayer system of the newest snapshot, for a message that
@@ -25,22 +59,72 @@ let drawnStyle = null;
25
59
 
26
60
  // Everyone's avatars with this player's own over them. A player whose avatar
27
61
  // changed is dropped and respawns in the new one.
62
+ // A `hubAv2` block (v1.51) as a map, or an empty one for anything else.
63
+ function realAvatars(block) {
64
+ return new Map(Object.entries(block && typeof block === 'object' ? block : {}));
65
+ }
66
+
28
67
  function setAvatars(scene, system) {
29
68
  const next = new Map([...hub.avatarsAll, ...hub.avatarsMe]);
69
+ // v1.51: `hubAv` carries a stand-in from the first four for a player who
70
+ // wears a later avatar, for clients from before them; the one really worn
71
+ // is in `hubAv2`, and is the one drawn here. Only for a player `hubAv`
72
+ // lists, and only an avatar index.
73
+ // A viewer's block only names players omitted from the shared one. For a
74
+ // shared player, its real index (or its absence) wins over a stale message.
75
+ const own = [...hub.avatars2Me].filter(([playerId]) => !hub.avatarsAll.has(playerId));
76
+ for (const [playerId, avatar] of [...hub.avatars2All, ...own]) {
77
+ if (next.has(playerId) && Number.isInteger(avatar) && avatar >= 0) {
78
+ next.set(playerId, avatar);
79
+ }
80
+ }
81
+ const colors = new Map();
82
+ const ownColors = [...hub.avatarColorsMe].filter(([playerId]) => !hub.avatarsAll.has(playerId));
83
+ for (const [playerId, color] of [...hub.avatarColorsAll, ...ownColors]) {
84
+ if (next.has(playerId) && Number.isInteger(color) && color > 0 && color < 16) {
85
+ colors.set(playerId, color);
86
+ }
87
+ }
30
88
  if (system) {
31
- const keep = new Map(system.net?.others() ?? []);
32
- let changed = false;
89
+ const changed = [];
90
+ const later = new Set();
33
91
  for (const [playerId, avatar] of next) {
34
- if (hub.avatars.has(playerId) && hub.avatars.get(playerId) !== avatar) {
35
- keep.delete(playerId);
36
- changed = true;
92
+ const colorChanged = (hub.avatarColors.get(playerId) ?? 0) !== (colors.get(playerId) ?? 0);
93
+ if (hub.avatars.has(playerId) && (hub.avatars.get(playerId) !== avatar || colorChanged)) {
94
+ changed.push(playerId);
95
+ // Changes involving a later avatar must not restore its old fading
96
+ // actor. The first four keep their original fade behavior.
97
+ if (colorChanged || Avatar.known(hub.avatars.get(playerId)) >= Avatar.DEFAULT_AVATARS || Avatar.known(avatar) >= Avatar.DEFAULT_AVATARS) {
98
+ later.add(playerId);
99
+ }
37
100
  }
38
101
  }
39
- if (changed) {
40
- Avatars.dropMissing(system.avatars, scene, keep);
41
- }
102
+ redraw(scene, system, changed, later);
42
103
  }
43
104
  hub.avatars = next;
105
+ hub.avatarColors = colors;
106
+ }
107
+
108
+ // Drops `playerIds`' bodies so each respawns in the avatar it is drawn as
109
+ // now (`hooks.avatar`). One of them still fading out in `fading` is taken
110
+ // down too, so it cannot come back as it was.
111
+ function redraw(scene, system, playerIds, fading) {
112
+ if (playerIds.length === 0) {
113
+ return;
114
+ }
115
+ const keep = new Map(system.net?.others() ?? []);
116
+ for (const playerId of playerIds) {
117
+ keep.delete(playerId);
118
+ const leaving = system.avatars.leaving.get(playerId);
119
+ if (leaving && fading.has(playerId)) {
120
+ if (scene.getActor(leaving.actorId)) {
121
+ system.avatars.retired?.add(leaving.actorId);
122
+ scene.despawnActor(leaving.actorId);
123
+ }
124
+ system.avatars.leaving.delete(playerId);
125
+ }
126
+ }
127
+ Avatars.dropMissing(system.avatars, scene, keep);
44
128
  }
45
129
 
46
130
  // Everyone's wearables with this player's own over them (v1.4), and over
@@ -49,6 +133,11 @@ function setWearing() {
49
133
  hub.wearing = wearingNow();
50
134
  }
51
135
 
136
+ // `{ spot, to }` of a place's word on "Stuck?" (v1.39).
137
+ function stuckAnswer(msg) {
138
+ return { spot: msg.spot === true, to: typeof msg.to === 'string' && msg.to ? msg.to.slice(0, 40) : null };
139
+ }
140
+
52
141
  function wearMap(value) {
53
142
  return new Map(Object.entries(value && typeof value === 'object' ? value : {}));
54
143
  }
@@ -66,17 +155,67 @@ export default {
66
155
  return firstJoinFor(castleJson, castleSdk.Multiplayer);
67
156
  },
68
157
 
158
+ // Each deck message is marked with the player id it arrived under, so one
159
+ // from a session the connection has since left is dropped (`rehello.js`).
160
+ // Handles nothing: it goes on to the queue as before.
161
+ arrive(msg, system) {
162
+ Rehello.tag(msg, system?.net ?? null);
163
+ return false;
164
+ },
165
+
69
166
  message(scene, msg) {
70
167
  files = scene.files ?? files;
71
168
  switch (msg.k) {
169
+ case 'hub-companion':
170
+ // As actions: keep a private message before WORLD until its gate is known.
171
+ if ((!hub.place || hub.place.companion === true) && Number.isSafeInteger(msg.n) && msg.n >= 0) {
172
+ hub.companion = { c: sanitise(msg.c), n: msg.n, ...(hub.companion?.stamps !== undefined ? { stamps: hub.companion.stamps } : {}) };
173
+ }
174
+ break;
175
+ case 'hub-menu':
176
+ if ((!hub.place || hub.place.menu === true) && Number.isSafeInteger(msg.n) && msg.n >= 0 &&
177
+ (!hub.menu || msg.n > hub.menu.n)) {
178
+ hub.menu = { spec: msg.spec, n: msg.n };
179
+ }
180
+ break;
181
+ case 'hub-ask':
182
+ // Buffer before WORLD; a known keyless place keeps nothing.
183
+ if ((!hub.place || hub.place.ask === true) && Number.isSafeInteger(msg.n) &&
184
+ (!hub.ask || msg.n > hub.ask.n)) {
185
+ hub.ask = msg.id === null ? { id: null, n: msg.n } : { id: msg.id, title: msg.title, max: msg.max, n: msg.n };
186
+ }
187
+ break;
188
+ case 'hub-actions':
189
+ // Buffer before WORLD; nothing draws until the place is known to opt in.
190
+ // A WORLD naming a keyless place drops this private offer.
191
+ if (!hub.place || hub.place.actions === true) {
192
+ hub.actions = { items: msg.items ?? null, n: msg.n };
193
+ }
194
+ break;
195
+ case 'hub-decor':
196
+ hub.decor = { button: msg.button ?? null, spec: msg.spec ?? null, grid: msg.grid ?? null };
197
+ break;
198
+ case 'hub-shot':
199
+ // Accepted lease renewals refresh a held or resumable shot.
200
+ receiveShot(scene, msg.shot, msg.lease === true);
201
+ break;
202
+ case 'hub-home-unlock':
203
+ hub.commands.push(msg);
204
+ break;
72
205
  case 'hub-go':
73
206
  case 'hub-end':
74
207
  case 'hub-result':
208
+ if (msg.k !== 'hub-result') {
209
+ clearShot();
210
+ }
75
211
  hub.commands.push(msg);
76
212
  break;
77
213
  case 'hub-tune':
78
214
  hub.tune = msg.tune && typeof msg.tune === 'object' ? msg.tune : null;
79
215
  break;
216
+ case 'hub-leaving':
217
+ hub.leaving = typeof msg.text === 'string' ? msg.text.trim().slice(0, 120) || null : null;
218
+ break;
80
219
  case 'hub-hud':
81
220
  hub.hudMe = msg.hud ?? null;
82
221
  break;
@@ -96,6 +235,16 @@ export default {
96
235
  if (typeof msg.to === 'string') {
97
236
  hub.jumpedTo = msg.to;
98
237
  }
238
+ // v1.39, after "Stuck?" in a place with the `unstick` hook: where it put this player.
239
+ if (deck.stuck && msg.stuck && typeof msg.stuck === 'object') {
240
+ hub.unstuck = stuckAnswer(msg.stuck);
241
+ }
242
+ break;
243
+ case 'hub-unstick-to':
244
+ // v1.39: what a tap on the chip would do now. Only a deck with `hub.stuck` asks.
245
+ if (deck.stuck) {
246
+ hub.stuckTo = stuckAnswer(msg);
247
+ }
99
248
  break;
100
249
  case 'hub-where':
101
250
  // Laid over what is known: one answer covers at most twelve players.
@@ -112,6 +261,14 @@ export default {
112
261
  hub.saidEvents.push(msg);
113
262
  }
114
263
  break;
264
+ case 'hub-yours':
265
+ if (deck.yourGames) {
266
+ hub.yours = { rows: Array.isArray(msg.rows) ? msg.rows.slice(0, 5) : [], hearts: Array.isArray(msg.hearts) ? msg.hearts.slice(0, 8) : [] };
267
+ }
268
+ return;
269
+ case 'hub-friends-wanted':
270
+ hub.friendsWanted = true;
271
+ break;
115
272
  case 'hub-party':
116
273
  hub.party = {
117
274
  members: Array.isArray(msg.members) ? msg.members : null,
@@ -122,23 +279,43 @@ export default {
122
279
  break;
123
280
  case 'hub-av':
124
281
  hub.avatarsMe = new Map(Object.entries(msg.hubAv && typeof msg.hubAv === 'object' ? msg.hubAv : {}));
282
+ // The message is whole: without `hubAv2`, none of them wears a later avatar.
283
+ hub.avatars2Me = realAvatars(msg.hubAv2);
284
+ hub.avatarColorsMe = realAvatars(msg.hubAvC);
125
285
  setAvatars(netSystem?.scene ?? scene, netSystem?.system ?? null);
126
286
  break;
127
287
  case 'hub-wear':
128
288
  hub.wearMe = wearMap(msg.hubWear);
129
289
  setWearing();
130
290
  break;
291
+ case 'hub-earned':
292
+ // v1.53: earned items of players in a hidden pair this player may see.
293
+ hub.earnedMe = wearMap(msg.hubEarned);
294
+ hub.earned = earnedNow();
295
+ break;
131
296
  case 'hub-try':
132
297
  // v1.28: try-ons of players in a hidden pair this player may see.
133
298
  hub.tryMe = wearMap(msg.hubTry);
134
299
  setWearing();
135
300
  break;
301
+ case 'hub-ballot-card':
302
+ // v1.68: the one entry to the choice card (`ballot.js` `gate`).
303
+ Ballot.gate(hub.place, scene?.multiplayer?.net ?? null, msg.card);
304
+ break;
136
305
  case 'hub-labels':
137
306
  hub.labelsMe = msg.labels && typeof msg.labels === 'object' ? msg.labels : {};
138
307
  break;
308
+ case 'hub-vis':
309
+ hub.hiddenMe = new Set(Array.isArray(msg.hide) ? msg.hide : []);
310
+ hub.shownMe = new Set(Array.isArray(msg.show) ? msg.show : []);
311
+ mergeHidden();
312
+ break;
139
313
  case 'hub-npc':
140
314
  case 'hub-npc-line':
315
+ case 'hub-npc-opening':
141
316
  case 'hub-npc-notes':
317
+ case 'hub-npc-preferred':
318
+ case 'hub-npc-hooks':
142
319
  hub.npcEvents.push(msg);
143
320
  break;
144
321
  case 'hub-grab-deny':
@@ -151,10 +328,22 @@ export default {
151
328
  break;
152
329
  case 'hub-sound':
153
330
  // At most a few unplayed one-shots wait: a backgrounded tab plays none late.
154
- if (hub.soundEvents.length < 8) {
331
+ if (hub.soundEvents.length < 8 && (!hub.soundGate || hub.soundGate())) {
155
332
  hub.soundEvents.push(msg);
156
333
  }
157
334
  break;
335
+ case 'hub-cue':
336
+ // Independent of audio mute/gesture gates; private transport only.
337
+ if (hub.place?.companion === true && hub.companion?.c && ownStamp(msg)) {
338
+ hub.companion.stamps = (hub.companion.stamps ?? 0) + 1;
339
+ }
340
+ if (deck.soundscape?.cues === true && (!hub.soundGate || hub.soundGate())) {
341
+ const events = (hub.cueEvents ??= []);
342
+ if (events.length < 8) {
343
+ events.push(msg);
344
+ }
345
+ }
346
+ break;
158
347
  default:
159
348
  break;
160
349
  }
@@ -167,7 +356,45 @@ export default {
167
356
  hub.lastTAt = msg.localMs ?? performance.now();
168
357
  }
169
358
  if (msg.hubPlace) {
359
+ if (Object.hasOwn(hub, 'menu') && hub.place && hub.place.id !== msg.hubPlace.id) {
360
+ hub.menuClose?.();
361
+ delete hub.menu;
362
+ }
363
+ if (Object.hasOwn(hub, 'ask') && hub.place && hub.place.id !== msg.hubPlace.id) {
364
+ hub.askClose?.();
365
+ delete hub.ask;
366
+ }
170
367
  hub.place = msg.hubPlace;
368
+ if (hub.place.menu !== true) {
369
+ hub.menuClose?.();
370
+ delete hub.menuClose;
371
+ delete hub.menu;
372
+ }
373
+ if (hub.place.actions !== true && Object.hasOwn(hub, 'actions')) {
374
+ delete hub.actions;
375
+ }
376
+ if (hub.place.companion !== true) {
377
+ delete hub.companion;
378
+ delete hub.glow;
379
+ }
380
+ if (hub.place.ask !== true && Object.hasOwn(hub, 'ask')) {
381
+ hub.askClose?.();
382
+ delete hub.ask;
383
+ }
384
+ if (!hub.place.decor) {
385
+ delete hub.decor;
386
+ }
387
+ }
388
+ // v1.68: a card the gate held before the place was known is kept or
389
+ // dropped by it. Nothing unless the gate held one.
390
+ if (msg.hubPlace && Ballot.held) {
391
+ Ballot.settle(msg.hubPlace);
392
+ }
393
+ // v1.33: a snapshot (it carries `hubPlace`) says whether this place takes
394
+ // "Stuck?". Read only in a deck with `hub.stuck`.
395
+ if (deck.stuck && msg.hubPlace) {
396
+ const to = msg.hubStuck && typeof msg.hubStuck === 'object' ? msg.hubStuck.to : undefined;
397
+ hub.stuck = to === undefined ? null : { to: typeof to === 'string' && to ? to.slice(0, 40) : null, ...(msg.hubStuck.hook === true ? { hook: true } : {}) };
171
398
  }
172
399
  netSystem = { scene, system };
173
400
  // The viewer's set changed under a running page (the experiment answered
@@ -185,14 +412,49 @@ export default {
185
412
  system.avatars.leaving.clear();
186
413
  }
187
414
  drawnStyle = style;
415
+ // v1.51: `hubAv2` comes only from a place where someone wears a later
416
+ // avatar, `{}` once when the last is gone; a snapshot (it carries
417
+ // `hubPlace`) without it means nobody does.
418
+ const hadColors = hub.avatarColorsAll.size > 0;
419
+ if (msg.hubAvC && typeof msg.hubAvC === 'object') {
420
+ hub.avatarColorsAll = realAvatars(msg.hubAvC);
421
+ } else if (msg.hubPlace) {
422
+ hub.avatarColorsAll = new Map();
423
+ }
424
+ const hadReal = hub.avatars2All.size > 0;
425
+ if (msg.hubAv2 && typeof msg.hubAv2 === 'object') {
426
+ hub.avatars2All = realAvatars(msg.hubAv2);
427
+ } else if (msg.hubPlace && hadReal) {
428
+ hub.avatars2All = new Map();
429
+ }
188
430
  if (msg.hubAv) {
189
431
  hub.avatarsAll = new Map(Object.entries(msg.hubAv));
432
+ }
433
+ if (msg.hubAv || msg.hubAv2 || msg.hubAvC || (msg.hubPlace && (hadReal || hadColors))) {
190
434
  setAvatars(scene, system);
191
435
  }
436
+ // The farthest of too many different characters are drawn as their
437
+ // stand-ins (`avatarCap.js`); a change is a later avatar's either way.
438
+ if (system?.avatars) {
439
+ const swapped = AvatarCap.frame(scene, system);
440
+ redraw(scene, system, swapped, new Set(swapped));
441
+ }
442
+ if (hub.place?.companion === true) {
443
+ if (Array.isArray(msg.hubGlow)) {
444
+ hub.glow = new Set(msg.hubGlow.filter((id) => typeof id === 'string'));
445
+ } else if (msg.hubPlace) {
446
+ delete hub.glow;
447
+ }
448
+ }
192
449
  if (msg.hubWear) {
193
450
  hub.wearAll = wearMap(msg.hubWear);
194
451
  setWearing();
195
452
  }
453
+ // v1.53: only a place where someone shows an earned item sends this.
454
+ if (msg.hubEarned) {
455
+ hub.earnedAll = wearMap(msg.hubEarned);
456
+ hub.earned = earnedNow();
457
+ }
196
458
  // v1.28: only a place that shows a try-on sends this. A snapshot (it
197
459
  // carries `hubPlace`) without one means none is up. `tryMe` is not the
198
460
  // snapshot's to clear: the place sends `hub-try` on the tick before a
@@ -209,17 +471,24 @@ export default {
209
471
  hub.hud = msg.hud ?? null;
210
472
  }
211
473
  if (msg.hidden) {
212
- hub.hidden = new Set(msg.hidden);
474
+ hub.hiddenAll = new Set(msg.hidden);
475
+ mergeHidden();
213
476
  }
214
477
  if (msg.tints) {
215
478
  hub.tints = msg.tints;
216
479
  }
480
+ if (msg.tintsD) {
481
+ hub.tints = mergeDictionary(hub.tints, msg.tintsD);
482
+ }
217
483
  if (msg.hubDoors) {
218
484
  hub.doors = msg.hubDoors;
219
485
  }
220
486
  if (msg.marks) {
221
487
  hub.marks = msg.marks;
222
488
  }
489
+ if (msg.marksD) {
490
+ hub.marks = mergeDictionary(hub.marks, msg.marksD);
491
+ }
223
492
  if (msg.spawnTemplates) {
224
493
  hub.spawnTemplates = msg.spawnTemplates;
225
494
  }
@@ -232,6 +501,9 @@ export default {
232
501
  if (msg.labels) {
233
502
  hub.labels = msg.labels;
234
503
  }
504
+ if (msg.labelsD) {
505
+ hub.labels = mergeDictionary(hub.labels, msg.labelsD);
506
+ }
235
507
  // v1.27: only a place that keeps an object for a player sends this.
236
508
  if (msg.hubKept && typeof msg.hubKept === 'object') {
237
509
  hub.keptFor = new Map(Object.entries(msg.hubKept));
@@ -240,6 +512,10 @@ export default {
240
512
  if (msg.hubEmotes && typeof msg.hubEmotes === 'object') {
241
513
  hub.emotes = msg.hubEmotes;
242
514
  }
515
+ // v1.47: only a place where an NPC has emoted sends this.
516
+ if (msg.hubNpcEmotes && typeof msg.hubNpcEmotes === 'object') {
517
+ hub.npcEmotes = msg.hubNpcEmotes;
518
+ }
243
519
  if (msg.hubSeated && typeof msg.hubSeated === 'object') {
244
520
  hub.seated = msg.hubSeated;
245
521
  }
@@ -252,12 +528,22 @@ export default {
252
528
  // place they are not drawn, so nobody flashes in a default body. The set
253
529
  // is this viewer's own (`Avatar.style`).
254
530
  avatar(playerId, username) {
255
- const index = hub.avatars.has(playerId) ? hub.avatars.get(playerId) : null;
256
- const blueprint = index === null ? null : Avatar.blueprint(files, index);
531
+ // An index past this kit's own (a later kit's character) is drawn as one
532
+ // of the first four (`Avatar.known`), never left out.
533
+ // Or its stand-in while the cap has this player as one (`avatarCap.js`).
534
+ const index = AvatarCap.shown(playerId);
535
+ const blueprint = index === null ? null : Avatar.blueprint(files, index, Avatar.style(), AvatarCap.shownColor(playerId));
257
536
  return blueprint ? { blueprint, username } : null;
258
537
  },
259
538
 
260
539
  presence(status) {
261
540
  return status.solo ? 'solo' : `${status.others + 1} here`;
262
541
  },
542
+
543
+ reset() {
544
+ clearShot();
545
+ },
546
+ dispose() {
547
+ clearShot();
548
+ },
263
549
  };