castle-web-cli 0.4.231 → 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 (368) 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/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -1,148 +1,521 @@
1
- // What players wear on their avatars (contract §11, v1.4): the place sends
2
- // playerId -> { kind, color, rarity } (`hubWear`), and this draws each one as a
3
- // few glowing, non-solid Shape actors that follow the avatar's Transform every
4
- // frame -- this player's own body included. Kinds this kit does not draw are
5
- // not drawn. A piece is `wear:<playerId>:<n>`; it is despawned when the
6
- // wearable changes or goes, or the avatar does, and retired with the
7
- // multiplayer kit so it is never reported to the session as gone.
8
-
9
- // Heights from the avatar's origin, the capsule's centre. A halo sits just
10
- // over the avatar's own top and an orbit circles it (`top`, metres above its
11
- // model's feet), so a short avatar wears them as close as a tall one, under
12
- // its name tag.
13
- const FEET_Y = -0.85;
1
+ // What players wear on their avatars (contract §11, v1.4; drawn this way since
2
+ // v1.41): the place sends playerId -> { kind, color, rarity } (`hubWear`), and
3
+ // this draws each one on that player's avatar -- this player's own body
4
+ // included -- as three.js objects added under the avatar's own node
5
+ // (`scene.three.nodes`), not as actors. So a piece moves and turns with its
6
+ // avatar in the same frame, and is hidden whenever the avatar's node is: the
7
+ // orbit camera's hide of this player's own body (physics-3d ownmodel.js sets
8
+ // the node's `visible` false for that frame's render) takes what is worn with
9
+ // it. Nothing is sent and no actor is made.
10
+ //
11
+ // a hat `hat-<id>`, an id in `hats.js`: the kit's model of it,
12
+ // `models/hats/<id>.pxmodel` (scripts/gen-hats.mjs), built by
13
+ // physics-3d with the avatars' look and fitted to the head
14
+ // (`avatar.js` `hatFit`). Its colours are the model's.
15
+ // a halo a glowing ring with an open middle, over the head and sized to
16
+ // it, bobbing a little.
17
+ // an aura a glowing ring round the feet, a faint disc inside it.
18
+ // an orbit glowing beads circling the head, more as rarity grows.
19
+ //
20
+ // A halo, aura and orbit glow in the wearable's colour and grow a little with
21
+ // its rarity. Kinds this kit does not draw are not drawn. An avatar the world
22
+ // has no node for yet (its model still coming) wears nothing until it has one,
23
+ // and a node rebuilt (another avatar chosen) is worn on again.
24
+
25
+ import * as THREE from 'three';
26
+ // A namespace, not a named import: `bakingLater` is in a physics-3d from
27
+ // 2026-10-04 on, and a deck pinned to one before it bundles and bakes now.
28
+ import * as Look from '@imports/castle.physics-3d/engine3d/look';
29
+ import { buildModelNode, parseModelCached } from '@imports/castle.physics-3d/engine3d/pxmodel';
30
+ import { copyModel, releaseModel, takeModel } from '@imports/castle.physics-3d/engine3d/optimize';
31
+ import { hatId } from './hats.js';
32
+ import { earnedLook, tinted } from './earned.js';
33
+
34
+ // Heights from the avatar's origin, the capsule's centre: the model's feet,
35
+ // which stand on the ground, are this far under it.
14
36
  const MODEL_FEET_Y = -0.7;
15
- const HALO_GAP = 0.15;
37
+ // An aura lies just over the ground (its faint disc a little under it).
38
+ const AURA_LIFT = 0.04;
16
39
  export const DEFAULT_TOP = 1.65;
17
- const ORBIT_RADIUS = 0.5;
18
40
  const COLOR = /^#[0-9a-f]{6}$/i;
19
41
  const MAX_RARITY = 9;
20
42
 
21
- function shape(kind, color, rarity, size) {
22
- return {
23
- kind,
24
- ...size,
25
- color,
26
- emissive: color,
27
- emissiveIntensity: 0.6 + rarity * 0.15,
28
- roughness: 0.4,
29
- metalness: 0.1,
30
- solid: false,
31
- };
32
- }
43
+ // A halo floats this far over the avatar's top, as wide as the head it is
44
+ // over (the seat of its hat fit) times HALO_WIDE, or HALO_R where there is no fit.
45
+ const HALO_GAP = 0.16;
46
+ const HALO_WIDE = 1.15;
47
+ const HALO_R = 0.24;
48
+ const HALO_TUBE = 0.042;
49
+ // A halo leans this far (radians) toward the camera that draws it, each
50
+ // client's own, so its open middle is seen from the orbit camera's low angle
51
+ // rather than a flat ring seen edge on, which reads as a disc.
52
+ const HALO_LEAN = 0.6;
53
+ const AURA_R = 0.55;
54
+ const ORBIT_R = 0.5;
55
+ const SEAT_R = 0.2;
56
+
57
+ // Where the kit keeps the hat models, inside the import in a deck and at the
58
+ // root while this kit is served as itself (as `avatar.js` finds avatars).
59
+ const ROOTS = ['imports/castle.hub-game/', ''];
60
+ export const hatFile = (id) => `models/hats/${id}.pxmodel`;
61
+ // Where a hat sits on an avatar this kit has no fit for: just under its top.
62
+ const HAT_DROP = 0.1;
33
63
 
34
- // The pieces of a wearable, each a Shape and where it sits relative to the
35
- // avatar at time `t` (seconds). Null for a kind this kit does not draw.
36
- export function pieces(wearable, top = DEFAULT_TOP) {
37
- const color = typeof wearable?.color === 'string' && COLOR.test(wearable.color) ? wearable.color.toLowerCase() : null;
38
- const rarity = Number.isInteger(wearable?.rarity) ? Math.min(MAX_RARITY, Math.max(0, wearable.rarity)) : 0;
64
+ const mm = (n) => Math.round(n * 1000) / 1000;
65
+
66
+ // What to draw for a wearable on an avatar standing `top` tall, with its hat
67
+ // fit `[seat, scale, rise]` (`avatar.js`) or null: a plain description, the
68
+ // same every time for the same arguments, or null for nothing.
69
+ // { kind: 'hat', id, y, scale }
70
+ // { kind: 'halo', color, glow, radius, tube, y, bob }
71
+ // { kind: 'aura', color, glow, radius, tube, y }
72
+ // { kind: 'orbit', color, glow, n, radius, bead, y, speed }
73
+ // `y` is metres over the avatar's origin.
74
+ export function look(wearable, top = DEFAULT_TOP, fit = null) {
75
+ const color =
76
+ typeof wearable?.color === 'string' && COLOR.test(wearable.color)
77
+ ? wearable.color.toLowerCase()
78
+ : null;
79
+ const rarity = Number.isInteger(wearable?.rarity)
80
+ ? Math.min(MAX_RARITY, Math.max(0, wearable.rarity))
81
+ : 0;
39
82
  if (!color) {
40
83
  return null;
41
84
  }
42
85
  const grow = 1 + rarity * 0.05;
86
+ const glow = mm(0.6 + rarity * 0.15);
43
87
  switch (wearable.kind) {
44
- case 'halo':
45
- return [
46
- {
47
- shape: shape('cylinder', color, rarity, { radius: 0.35 * grow, height: 0.04 }),
48
- at: (t) => ({ x: 0, y: MODEL_FEET_Y + top + HALO_GAP + Math.sin(t * 2) * 0.03, z: 0 }),
49
- },
50
- ];
88
+ case 'halo': {
89
+ const head = fit ? SEAT_R * fit[1] * HALO_WIDE : HALO_R;
90
+ return {
91
+ kind: 'halo',
92
+ color,
93
+ glow,
94
+ radius: mm(head * grow),
95
+ tube: mm(HALO_TUBE * grow),
96
+ y: mm(MODEL_FEET_Y + top + HALO_GAP),
97
+ bob: 0.03,
98
+ };
99
+ }
51
100
  case 'aura':
52
- return [
53
- {
54
- shape: shape('cylinder', color, rarity, { radius: 0.6 * grow, height: 0.02 }),
55
- at: () => ({ x: 0, y: FEET_Y + 0.02, z: 0 }),
56
- },
57
- ];
58
- case 'orbit': {
59
- const n = 1 + Math.floor(rarity / 3);
60
- const speed = 1.6 + rarity * 0.1;
61
- return Array.from({ length: n }, (_, i) => ({
62
- shape: shape('sphere', color, rarity, { radius: 0.07 * grow }),
63
- at: (t) => {
64
- const a = t * speed + (i * 2 * Math.PI) / n;
65
- return { x: Math.cos(a) * ORBIT_RADIUS, y: MODEL_FEET_Y + top + Math.sin(a * 2) * 0.05, z: Math.sin(a) * ORBIT_RADIUS };
66
- },
67
- }));
101
+ return {
102
+ kind: 'aura',
103
+ color,
104
+ glow,
105
+ radius: mm(AURA_R * grow),
106
+ tube: mm(0.035 * grow),
107
+ y: mm(MODEL_FEET_Y + AURA_LIFT),
108
+ };
109
+ case 'orbit':
110
+ return {
111
+ kind: 'orbit',
112
+ color,
113
+ glow,
114
+ n: 1 + Math.floor(rarity / 3),
115
+ radius: ORBIT_R,
116
+ bead: mm(0.07 * grow),
117
+ y: mm(MODEL_FEET_Y + top),
118
+ speed: mm(1.6 + rarity * 0.1),
119
+ };
120
+ default: {
121
+ const id = hatId(wearable.kind);
122
+ if (!id) {
123
+ return null;
124
+ }
125
+ const [seat, scale, rise] = fit ?? [top - HAT_DROP, 1, 0];
126
+ return { kind: 'hat', id, y: mm(MODEL_FEET_Y + seat + (PERCHED.has(id) ? rise : 0)), scale };
68
127
  }
69
- default:
128
+ }
129
+ }
130
+
131
+ // Hats that stand on the crown of the head rather than round it.
132
+ const PERCHED = new Set(['lantern', 'lighthouse']);
133
+
134
+ function glowing(color, glow, { opacity = 1 } = {}) {
135
+ return new THREE.MeshStandardMaterial({
136
+ color,
137
+ emissive: color,
138
+ emissiveIntensity: glow,
139
+ roughness: 0.4,
140
+ metalness: 0.1,
141
+ ...(opacity < 1 ? { transparent: true, opacity, depthWrite: false } : {}),
142
+ });
143
+ }
144
+
145
+ // The object for a description: a Group whose children are drawn. `hat(id)`
146
+ // takes the shared build of that hat's model, `{ template, key, builds }`, or
147
+ // gives null when the files lack it; the group keeps where it came from, to
148
+ // give it back.
149
+ function build(spec, hat) {
150
+ const group = new THREE.Group();
151
+ group.name = `wear:${spec.kind}`;
152
+ if (spec.kind === 'hat') {
153
+ const taken = hat(spec.id);
154
+ if (!taken) {
70
155
  return null;
156
+ }
157
+ group.userData.hatKey = taken.key;
158
+ group.userData.hatBuilds = taken.builds;
159
+ const copy = copyModel(taken.template);
160
+ copy.scale.setScalar(spec.scale);
161
+ copy.position.y = spec.y;
162
+ group.add(copy);
163
+ return group;
164
+ }
165
+ if (spec.kind === 'halo') {
166
+ // `turn` faces the camera (animate), and the ring leans back toward it.
167
+ const turn = new THREE.Group();
168
+ turn.position.y = spec.y;
169
+ const ring = new THREE.Mesh(new THREE.TorusGeometry(spec.radius, spec.tube, 10, 40), glowing(spec.color, spec.glow * 1.4));
170
+ ring.rotation.x = -(Math.PI / 2 - HALO_LEAN);
171
+ turn.add(ring);
172
+ group.add(turn);
173
+ return group;
174
+ }
175
+ if (spec.kind === 'aura') {
176
+ const ring = new THREE.Mesh(
177
+ new THREE.TorusGeometry(spec.radius, spec.tube, 8, 40),
178
+ glowing(spec.color, spec.glow),
179
+ );
180
+ ring.rotation.x = Math.PI / 2;
181
+ ring.position.y = spec.y;
182
+ group.add(ring);
183
+ const disc = new THREE.Mesh(new THREE.CircleGeometry(spec.radius, 32), glowing(spec.color, spec.glow, { opacity: 0.22 }));
184
+ disc.rotation.x = -Math.PI / 2;
185
+ disc.position.y = spec.y - 0.02;
186
+ group.add(disc);
187
+ return group;
188
+ }
189
+ if (spec.kind === 'orbit') {
190
+ const geometry = new THREE.SphereGeometry(spec.bead, 12, 8);
191
+ const material = glowing(spec.color, spec.glow);
192
+ for (let i = 0; i < spec.n; i += 1) {
193
+ group.add(new THREE.Mesh(geometry, material));
194
+ }
195
+ return group;
196
+ }
197
+ return null;
198
+ }
199
+
200
+ // Moves what moves (a halo's bob, an orbit's beads) to time `t` seconds. A
201
+ // halo turns to face `camera` (world position, or null) from its avatar,
202
+ // whose pose is read from `at` (its Transform: what the engine will put the
203
+ // node at this frame, which may not have reached the node yet).
204
+ const DEG = Math.PI / 180;
205
+ function animate(group, spec, t, camera, at) {
206
+ if (spec.kind === 'halo') {
207
+ group.position.y = Math.sin(t * 2) * spec.bob;
208
+ const turn = group.children[0];
209
+ if (camera && turn && at) {
210
+ const facing = Math.atan2(camera.x - (at.x ?? 0), camera.z - (at.z ?? 0));
211
+ turn.rotation.y = facing - (at.rotationY ?? 0) * DEG;
212
+ }
213
+ } else if (spec.kind === 'orbit') {
214
+ group.children.forEach((bead, i) => {
215
+ const a = t * spec.speed + (i * 2 * Math.PI) / spec.n;
216
+ bead.position.set(
217
+ Math.cos(a) * spec.radius,
218
+ spec.y + Math.sin(a * 2) * 0.05,
219
+ Math.sin(a) * spec.radius,
220
+ );
221
+ });
71
222
  }
72
223
  }
73
224
 
225
+ // Frees every geometry and material under `root`, once each.
226
+ function disposeTree(root) {
227
+ const done = new Set();
228
+ root.traverse((object) => {
229
+ const materials = Array.isArray(object.material) ? object.material : [object.material];
230
+ for (const thing of [object.geometry, ...materials]) {
231
+ if (thing && !done.has(thing)) {
232
+ done.add(thing);
233
+ thing.dispose();
234
+ }
235
+ }
236
+ });
237
+ }
238
+
239
+ // The hats' shared builds, per world (a disposed world's queued look bakes
240
+ // are dropped with it, so a build is never carried into another), one per
241
+ // model text there (so a pack mounted with the engine's same hat files builds
242
+ // nothing again), each with its count of wearers: the last one out disposes
243
+ // it (optimize.js takeModel/releaseModel, as the engine shares its placed
244
+ // models).
245
+ const hatBuildsOf = new WeakMap();
246
+ const NO_WORLD = {};
247
+
248
+ // Takes down what an object made: a hat gives back its share of the build,
249
+ // anything else frees its own geometry and materials.
250
+ function dispose(group, spec) {
251
+ group.parent?.remove(group);
252
+ if (spec.kind === 'hat') {
253
+ if (group.userData.hatKey) {
254
+ releaseModel(group.userData.hatBuilds, group.userData.hatKey, disposeTree);
255
+ }
256
+ return;
257
+ }
258
+ disposeTree(group);
259
+ }
260
+
261
+ // The shared build of hat `id` from `files`, taken for one wearer, or null.
262
+ // Its look is baked as the world's placed models' are: later, a little a
263
+ // frame, where the world does that (physics-3d `bakesLookLater`) and has its
264
+ // queue up.
265
+ function takeHat(world, files, id) {
266
+ const file = ROOTS.map((root) => `${root}${hatFile(id)}`).find((f) => typeof files?.[f] === 'string');
267
+ return file ? takeShared(world, files, file, files[file], 'hat') : null;
268
+ }
269
+
270
+ // The shared build of model `file` from its text `text` (an earned item's is
271
+ // its model tinted), taken for one wearer, or null.
272
+ function takeShared(world, files, file, text, label) {
273
+ const model = parseModelCached(text);
274
+ if (!model) {
275
+ return null;
276
+ }
277
+ const key = `${file}\n${text}`;
278
+ const make = () => buildModelNode(model, null, files, file, [file], { optimize: true });
279
+ // Only into a queue the world already has (its first deferred model made
280
+ // it); a world without one, or an engine without deferred baking, bakes now.
281
+ const later = world?.bakesLookLater === true && world.disposed !== true && Boolean(world.lookBake) && typeof Look.bakingLater === 'function';
282
+ const owner = world ?? NO_WORLD;
283
+ if (!hatBuildsOf.has(owner)) {
284
+ hatBuildsOf.set(owner, new Map());
285
+ }
286
+ const builds = hatBuildsOf.get(owner);
287
+ const template = takeModel(builds, key, later ? () => Look.bakingLater(world.lookBake, `${label}:${key}`, make) : make);
288
+ return { template, key, builds };
289
+ }
290
+
291
+ // An earned item's object (v1.53, `earned.js`): its shape's model in its
292
+ // colour, where its fit puts it, or null when these files lack the model.
293
+ function buildEarned(spec, world, files) {
294
+ const file = ROOTS.map((root) => `${root}${spec.file}`).find((f) => typeof files?.[f] === 'string');
295
+ const taken = file ? takeShared(world, files, file, tinted(files[file], spec.color), 'earned') : null;
296
+ if (!taken) {
297
+ return null;
298
+ }
299
+ const group = new THREE.Group();
300
+ group.name = `earned:${spec.shape}`;
301
+ group.userData.hatKey = taken.key;
302
+ group.userData.hatBuilds = taken.builds;
303
+ // Scaled, then tilted about z and turned about y (Euler XYZ applies z
304
+ // first), then placed.
305
+ const placed = new THREE.Group();
306
+ placed.position.set(...spec.position);
307
+ placed.rotation.set(0, spec.yaw * DEG, spec.tilt * DEG);
308
+ const copy = copyModel(taken.template);
309
+ copy.scale.set(...spec.scale);
310
+ placed.add(copy);
311
+ if (spec.glow) {
312
+ // A badge's soft glow: a flat disc of light in its colour, full under
313
+ // the badge and fading out past its edge, just off the body; added to
314
+ // what is behind it and never written to depth.
315
+ const glow = new THREE.Mesh(
316
+ new THREE.PlaneGeometry(spec.glow * 2, spec.glow * 2),
317
+ new THREE.MeshBasicMaterial({
318
+ color: spec.color,
319
+ map: glowTexture(),
320
+ transparent: true,
321
+ opacity: 0.85,
322
+ blending: THREE.AdditiveBlending,
323
+ depthWrite: false,
324
+ toneMapped: false,
325
+ }),
326
+ );
327
+ glow.name = 'earned:glow';
328
+ glow.position.z = 0.004;
329
+ glow.renderOrder = 1;
330
+ placed.add(glow);
331
+ group.userData.glow = glow;
332
+ }
333
+ group.add(placed);
334
+ return group;
335
+ }
336
+
337
+ // The soft glow's fall-off, made once: white, full to 0.35 of the radius (under
338
+ // the badge), then its alpha falling as (1 - t)^2 to nothing at the edge, so it
339
+ // has no edge to see.
340
+ let glowMap = null;
341
+ function glowTexture() {
342
+ if (!glowMap) {
343
+ const n = 64;
344
+ const data = new Uint8Array(n * n * 4);
345
+ for (let j = 0; j < n; j += 1) {
346
+ for (let i = 0; i < n; i += 1) {
347
+ const r = Math.min(1, Math.hypot(i + 0.5 - n / 2, j + 0.5 - n / 2) / (n / 2));
348
+ const t = Math.min(1, Math.max(0, (r - 0.35) / 0.65));
349
+ const at = (j * n + i) * 4;
350
+ data.fill(255, at, at + 3);
351
+ data[at + 3] = Math.round(255 * (1 - t) ** 2);
352
+ }
353
+ }
354
+ glowMap = new THREE.DataTexture(data, n, n);
355
+ glowMap.magFilter = THREE.LinearFilter;
356
+ glowMap.minFilter = THREE.LinearFilter;
357
+ glowMap.needsUpdate = true;
358
+ }
359
+ return glowMap;
360
+ }
361
+
74
362
  export function makeWear() {
75
- // playerId -> { json, ids, pieces }
363
+ // playerId -> { json, spec, group, node, world }
76
364
  const drawn = new Map();
77
-
78
- function remove(scene, playerId) {
365
+ function remove(playerId) {
79
366
  const entry = drawn.get(playerId);
80
367
  drawn.delete(playerId);
81
- for (const id of entry?.ids ?? []) {
82
- if (scene.getActor(id)) {
83
- scene.multiplayer?.avatars?.retired?.add(id);
84
- scene.despawnActor(id);
85
- }
368
+ if (entry?.group) {
369
+ dispose(entry.group, entry.spec);
86
370
  }
87
371
  }
88
372
 
89
373
  return {
90
- // Spawn, move and remove pieces to match `wearing` (playerId -> wearable).
91
- // `topOf(playerId)` is how tall that player's avatar stands.
92
- frame(scene, local, wearing, topOf = () => DEFAULT_TOP, now = performance.now()) {
374
+ // Make, move and take down what is worn to match `wearing` (playerId ->
375
+ // wearable). `topOf(playerId)` is how tall that player's avatar stands,
376
+ // and `fitOf(playerId)` how a hat sits on it.
377
+ frame(
378
+ scene,
379
+ local,
380
+ wearing,
381
+ topOf = () => DEFAULT_TOP,
382
+ now = performance.now(),
383
+ fitOf = () => null,
384
+ ) {
93
385
  const mp = scene.multiplayer;
386
+ const nodes = scene.three?.nodes;
387
+ const camera = scene.three?.camera?.position ?? null;
94
388
  const self = mp?.net?.selfId?.() ?? null;
95
389
  const t = now / 1000;
96
390
  for (const playerId of [...drawn.keys()]) {
97
391
  if (!wearing.has(playerId)) {
98
- remove(scene, playerId);
392
+ remove(playerId);
99
393
  }
100
394
  }
101
395
  for (const [playerId, wearable] of wearing) {
102
396
  const actorId = playerId === self ? local?.id : mp?.avatars?.actors?.get(playerId);
103
- const at = actorId ? scene.getActor(actorId)?.components.Transform : null;
397
+ const node = actorId ? (nodes?.get(actorId)?.node ?? null) : null;
104
398
  const top = topOf(playerId);
105
- const json = `${top}:${JSON.stringify(wearable)}`;
106
- if (!at || drawn.get(playerId)?.json !== json) {
107
- remove(scene, playerId);
399
+ const fit = hatId(wearable?.kind) || wearable?.kind === 'halo' ? fitOf(playerId) : null;
400
+ const json = `${top}:${fit}:${JSON.stringify(wearable)}`;
401
+ let entry = drawn.get(playerId);
402
+ if (!node) {
403
+ remove(playerId);
404
+ continue;
108
405
  }
109
- if (!at) {
406
+ // Another world (a runtime made again over a new one) builds its own:
407
+ // a share of the old world's build would never finish its bake there.
408
+ if (entry?.json !== json || entry.world !== scene.three) {
409
+ // The new one is made before the old is taken down, so a hat
410
+ // refitted keeps its share of the build rather than freeing it.
411
+ const spec = look(wearable, top, fit);
412
+ const group = spec ? build(spec, (id) => takeHat(scene.three, scene.files, id)) : null;
413
+ remove(playerId);
414
+ entry = { json, spec, group, node: null, world: scene.three };
415
+ drawn.set(playerId, entry);
416
+ }
417
+ if (!entry.group) {
110
418
  continue;
111
419
  }
420
+ // A node rebuilt since (another avatar, a scene's nodes put back) is
421
+ // worn on again.
422
+ if (entry.node !== node || entry.group.parent !== node) {
423
+ node.add(entry.group);
424
+ entry.node = node;
425
+ }
426
+ const at = (playerId === self ? local : scene.getActor?.(actorId))?.components?.Transform ?? null;
427
+ animate(entry.group, entry.spec, t, camera, at);
428
+ }
429
+ },
430
+
431
+ // A scene load took every node with it: let go of what was on them.
432
+ forget() {
433
+ for (const playerId of [...drawn.keys()]) {
434
+ remove(playerId);
435
+ }
436
+ },
437
+
438
+ // A session switch that kept the scene: take everything down.
439
+ clear() {
440
+ for (const playerId of [...drawn.keys()]) {
441
+ remove(playerId);
442
+ }
443
+ },
444
+ };
445
+ }
446
+
447
+ // Earned items (v1.53, `earned.js`): drawn as a hat is, on the same node, by
448
+ // `frame(scene, local, earned, fitOf)` with `earned` playerId -> `{ class,
449
+ // shape, color }` and `fitOf(playerId)` that player's avatar's earned fit
450
+ // (`avatar.js`). Nothing at all is done while nobody shows one.
451
+ export function makeEarned() {
452
+ // playerId -> { json, group, node, world }
453
+ const drawn = new Map();
454
+ function remove(playerId) {
455
+ const entry = drawn.get(playerId);
456
+ drawn.delete(playerId);
457
+ if (entry?.group) {
458
+ entry.group.parent?.remove(entry.group);
459
+ releaseModel(entry.group.userData.hatBuilds, entry.group.userData.hatKey, disposeTree);
460
+ // The glow's own disc and material; its fall-off texture is shared.
461
+ const glow = entry.group.userData.glow;
462
+ glow?.geometry.dispose();
463
+ glow?.material.dispose();
464
+ }
465
+ }
466
+
467
+ return {
468
+ // How many players something is drawn for (tests).
469
+ get size() {
470
+ return drawn.size;
471
+ },
472
+ frame(scene, local, earned, fitOf = () => null) {
473
+ if (earned.size === 0 && drawn.size === 0) {
474
+ return;
475
+ }
476
+ const mp = scene.multiplayer;
477
+ const nodes = scene.three?.nodes;
478
+ const self = mp?.net?.selfId?.() ?? null;
479
+ for (const playerId of [...drawn.keys()]) {
480
+ if (!earned.has(playerId)) {
481
+ remove(playerId);
482
+ }
483
+ }
484
+ for (const [playerId, item] of earned) {
485
+ const actorId = playerId === self ? local?.id : mp?.avatars?.actors?.get(playerId);
486
+ const node = actorId ? (nodes?.get(actorId)?.node ?? null) : null;
487
+ if (!node) {
488
+ remove(playerId);
489
+ continue;
490
+ }
491
+ const fit = fitOf(playerId);
492
+ const json = `${JSON.stringify(fit)}:${item?.class}:${item?.shape}:${item?.color}`;
112
493
  let entry = drawn.get(playerId);
113
- if (!entry) {
114
- const parts = pieces(wearable, top) ?? [];
115
- entry = { json, pieces: parts, ids: parts.map((_, n) => `wear:${playerId}:${n}`) };
494
+ if (entry?.json !== json || entry.world !== scene.three) {
495
+ // The new one is made before the old is taken down, so the same
496
+ // item refitted keeps its share of the build.
497
+ const spec = earnedLook(item, fit);
498
+ const group = spec ? buildEarned(spec, scene.three, scene.files) : null;
499
+ remove(playerId);
500
+ entry = { json, group, node: null, world: scene.three };
116
501
  drawn.set(playerId, entry);
117
- entry.pieces.forEach((piece, n) => {
118
- const p = piece.at(t);
119
- scene.spawnActor({
120
- id: entry.ids[n],
121
- components: { Transform: { x: at.x + p.x, y: at.y + p.y, z: at.z + p.z }, Shape: { ...piece.shape } },
122
- });
123
- });
124
502
  }
125
- entry.pieces.forEach((piece, n) => {
126
- const pt = scene.getActor(entry.ids[n])?.components.Transform;
127
- if (pt) {
128
- const p = piece.at(t);
129
- pt.x = at.x + p.x;
130
- pt.y = at.y + p.y;
131
- pt.z = at.z + p.z;
132
- }
133
- });
503
+ if (entry.group && (entry.node !== node || entry.group.parent !== node)) {
504
+ node.add(entry.group);
505
+ entry.node = node;
506
+ }
134
507
  }
135
508
  },
136
509
 
137
- // A scene load took every piece with it: forget them.
138
510
  forget() {
139
- drawn.clear();
511
+ for (const playerId of [...drawn.keys()]) {
512
+ remove(playerId);
513
+ }
140
514
  },
141
515
 
142
- // A session switch that kept the scene: take every piece down.
143
- clear(scene) {
516
+ clear() {
144
517
  for (const playerId of [...drawn.keys()]) {
145
- remove(scene, playerId);
518
+ remove(playerId);
146
519
  }
147
520
  },
148
521
  };