castle-web-cli 0.4.232 → 0.4.234

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 (587) 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/api.d.ts +11 -0
  8. package/dist/api.js +43 -0
  9. package/dist/bundle.d.ts +64 -0
  10. package/dist/bundle.js +558 -2
  11. package/dist/castle-host/host.d.ts +18 -2
  12. package/dist/castle-host/host.js +844 -39
  13. package/dist/castleJson.d.ts +23 -2
  14. package/dist/castleJson.js +46 -2
  15. package/dist/check.d.ts +3 -1
  16. package/dist/check.js +20 -3
  17. package/dist/chunkLoader.d.ts +3 -0
  18. package/dist/chunkLoader.js +111 -0
  19. package/dist/devParty.d.ts +26 -0
  20. package/dist/devParty.js +231 -0
  21. package/dist/devSaveStorage.js +4 -0
  22. package/dist/devSessionStorage.js +50 -2
  23. package/dist/devSocial.d.ts +24 -0
  24. package/dist/devSocial.js +70 -0
  25. package/dist/ide.d.ts +2 -0
  26. package/dist/ide.js +119 -15
  27. package/dist/importPinMismatch.d.ts +22 -0
  28. package/dist/importPinMismatch.js +77 -0
  29. package/dist/importRegression.js +3 -15
  30. package/dist/imports.d.ts +10 -3
  31. package/dist/imports.js +88 -20
  32. package/dist/index.js +11 -4
  33. package/dist/init.js +1 -1
  34. package/dist/platformDoc.js +22 -0
  35. package/dist/routerFences.d.ts +5 -0
  36. package/dist/routerFences.js +12 -2
  37. package/dist/save-deck.d.ts +25 -1
  38. package/dist/save-deck.js +178 -9
  39. package/dist/serve.js +32 -11
  40. package/dist/shell/assets/{index-D2tWM896.js → index-DulbYIJm.js} +97 -97
  41. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  42. package/dist/shell/index.html +2 -2
  43. package/dist/taskSteer.d.ts +13 -0
  44. package/dist/taskSteer.js +22 -2
  45. package/dist/vitePlugins.d.ts +2 -1
  46. package/dist/vitePlugins.js +13 -0
  47. package/kits/base/castle.json +1 -1
  48. package/kits/base/package-lock.json +1 -1
  49. package/kits/base/sdk/README.md +339 -5
  50. package/kits/base/sdk/avatar.d.ts +6 -2
  51. package/kits/base/sdk/avatar.js +12 -4
  52. package/kits/base/sdk/castle.d.ts +7 -3
  53. package/kits/base/sdk/castle.js +2 -0
  54. package/kits/base/sdk/commands.d.ts +176 -1
  55. package/kits/base/sdk/commands.js +3 -0
  56. package/kits/base/sdk/display.d.ts +3 -0
  57. package/kits/base/sdk/display.js +9 -3
  58. package/kits/base/sdk/hub.d.ts +37 -6
  59. package/kits/base/sdk/hub.js +63 -4
  60. package/kits/base/sdk/multiplayer.d.ts +7 -1
  61. package/kits/base/sdk/multiplayer.js +148 -32
  62. package/kits/base/sdk/multiplayerProtocol.d.ts +2 -0
  63. package/kits/base/sdk/party.d.ts +23 -0
  64. package/kits/base/sdk/party.js +91 -0
  65. package/kits/base/sdk/reconnectBudget.d.ts +23 -0
  66. package/kits/base/sdk/reconnectBudget.js +96 -0
  67. package/kits/base/sdk/save.d.ts +38 -1
  68. package/kits/base/sdk/save.js +81 -7
  69. package/kits/base/sdk/server/hub.d.ts +117 -0
  70. package/kits/base/sdk/server/hub.js +119 -2
  71. package/kits/base/sdk/server/platformHandle.d.ts +43 -1
  72. package/kits/base/sdk/server/storage.d.ts +17 -0
  73. package/kits/base/sdk/server/storage.js +65 -3
  74. package/kits/base/sdk/server/wrapper.d.ts +43 -6
  75. package/kits/base/sdk/server/wrapper.js +93 -9
  76. package/kits/base/sdk/social.d.ts +9 -0
  77. package/kits/base/sdk/social.js +5 -0
  78. package/kits/hub-game/CLAUDE.md +451 -13
  79. package/kits/hub-game/README.md +63 -0
  80. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  81. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  82. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  83. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  84. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  85. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  86. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  87. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  88. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  89. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  90. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  91. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  92. package/kits/hub-game/castle.json +5 -5
  93. package/kits/hub-game/code/client/act.js +312 -0
  94. package/kits/hub-game/code/client/actionLayout.js +147 -0
  95. package/kits/hub-game/code/client/actionOverflow.js +556 -0
  96. package/kits/hub-game/code/client/actorBudget.js +47 -0
  97. package/kits/hub-game/code/client/arrivalCamera.js +50 -0
  98. package/kits/hub-game/code/client/askSlot.js +117 -0
  99. package/kits/hub-game/code/client/attention.js +11 -2
  100. package/kits/hub-game/code/client/avatar.js +311 -35
  101. package/kits/hub-game/code/client/avatarCap.js +228 -0
  102. package/kits/hub-game/code/client/avatarColors.js +70 -0
  103. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  104. package/kits/hub-game/code/client/avatarShare.js +253 -0
  105. package/kits/hub-game/code/client/backVisibility.js +13 -0
  106. package/kits/hub-game/code/client/ballot.js +472 -0
  107. package/kits/hub-game/code/client/build.js +38 -0
  108. package/kits/hub-game/code/client/chat.js +41 -5
  109. package/kits/hub-game/code/client/chatModeration.js +5 -0
  110. package/kits/hub-game/code/client/chrome.js +2144 -160
  111. package/kits/hub-game/code/client/companion.js +716 -0
  112. package/kits/hub-game/code/client/companionDress.js +99 -0
  113. package/kits/hub-game/code/client/crowdNames.js +241 -0
  114. package/kits/hub-game/code/client/decor.js +515 -0
  115. package/kits/hub-game/code/client/defaultEnvironment.js +194 -0
  116. package/kits/hub-game/code/client/doorErrors.js +39 -0
  117. package/kits/hub-game/code/client/earned.js +131 -0
  118. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  119. package/kits/hub-game/code/client/fall.js +18 -0
  120. package/kits/hub-game/code/client/farAvatars.js +233 -0
  121. package/kits/hub-game/code/client/firstJoin.js +9 -2
  122. package/kits/hub-game/code/client/fpsTelemetry.js +50 -0
  123. package/kits/hub-game/code/client/frameBatch.js +5 -0
  124. package/kits/hub-game/code/client/grab.js +368 -29
  125. package/kits/hub-game/code/client/hookLayer.js +385 -20
  126. package/kits/hub-game/code/client/hudCopy.js +51 -0
  127. package/kits/hub-game/code/client/hudRate.js +20 -0
  128. package/kits/hub-game/code/client/idle.js +177 -24
  129. package/kits/hub-game/code/client/interestCap.js +81 -0
  130. package/kits/hub-game/code/client/invites.js +231 -0
  131. package/kits/hub-game/code/client/joinError.js +9 -0
  132. package/kits/hub-game/code/client/keys.js +36 -0
  133. package/kits/hub-game/code/client/labelsNear.js +234 -0
  134. package/kits/hub-game/code/client/landscapeLayout.js +17 -0
  135. package/kits/hub-game/code/client/layoutCache.js +264 -0
  136. package/kits/hub-game/code/client/loadTelemetry.js +20 -0
  137. package/kits/hub-game/code/client/loadingCover.js +148 -0
  138. package/kits/hub-game/code/client/loadingEntry.js +8 -0
  139. package/kits/hub-game/code/client/menuIcons.js +34 -0
  140. package/kits/hub-game/code/client/menuRows.js +43 -0
  141. package/kits/hub-game/code/client/modelReady.js +7 -0
  142. package/kits/hub-game/code/client/pack.js +6 -2
  143. package/kits/hub-game/code/client/packFormat.js +3 -3
  144. package/kits/hub-game/code/client/padCueArrival.js +23 -0
  145. package/kits/hub-game/code/client/padCues.js +112 -0
  146. package/kits/hub-game/code/client/padOccupancy.js +88 -0
  147. package/kits/hub-game/code/client/padReadability.js +26 -0
  148. package/kits/hub-game/code/client/padRings.js +69 -0
  149. package/kits/hub-game/code/client/pushVisit.js +14 -0
  150. package/kits/hub-game/code/client/quality.js +205 -0
  151. package/kits/hub-game/code/client/qualityEntry.js +55 -0
  152. package/kits/hub-game/code/client/rehello.js +167 -0
  153. package/kits/hub-game/code/client/safeLayout.js +338 -0
  154. package/kits/hub-game/code/client/safeStyle.js +42 -0
  155. package/kits/hub-game/code/client/say.js +12 -3
  156. package/kits/hub-game/code/client/shot.js +146 -0
  157. package/kits/hub-game/code/client/shotFit.js +56 -0
  158. package/kits/hub-game/code/client/signIn.js +28 -0
  159. package/kits/hub-game/code/client/sound.js +63 -8
  160. package/kits/hub-game/code/client/soundscape.js +1151 -0
  161. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  162. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  163. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  164. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  165. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  166. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  167. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  168. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  169. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  170. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  171. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  172. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  173. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  174. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  175. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  176. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  177. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  178. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  179. package/kits/hub-game/code/client/spin.js +101 -0
  180. package/kits/hub-game/code/client/state.js +162 -1
  181. package/kits/hub-game/code/client/stuck.js +259 -0
  182. package/kits/hub-game/code/client/talk.js +714 -59
  183. package/kits/hub-game/code/client/tiers.js +543 -52
  184. package/kits/hub-game/code/client/toastBand.js +37 -0
  185. package/kits/hub-game/code/client/together.js +39 -2
  186. package/kits/hub-game/code/client/visibility.js +43 -0
  187. package/kits/hub-game/code/client/weakestLookBake.js +92 -0
  188. package/kits/hub-game/code/client/weakestTier.js +295 -0
  189. package/kits/hub-game/code/client/wear.js +461 -170
  190. package/kits/hub-game/code/client/worldLabels.js +241 -0
  191. package/kits/hub-game/code/client/yours.js +200 -0
  192. package/kits/hub-game/code/companionSpec.js +45 -0
  193. package/kits/hub-game/code/npcDisplayText.js +55 -0
  194. package/kits/hub-game/code/privateText.js +7 -0
  195. package/kits/hub-game/code/server/act.js +124 -0
  196. package/kits/hub-game/code/server/actions.js +138 -0
  197. package/kits/hub-game/code/server/actors.js +11 -2
  198. package/kits/hub-game/code/server/analytics.js +83 -0
  199. package/kits/hub-game/code/server/anonymousEntry.js +49 -0
  200. package/kits/hub-game/code/server/arrivalPose.js +36 -0
  201. package/kits/hub-game/code/server/ask.js +155 -0
  202. package/kits/hub-game/code/server/ballot.js +539 -0
  203. package/kits/hub-game/code/server/cells.js +100 -0
  204. package/kits/hub-game/code/server/companion.js +107 -0
  205. package/kits/hub-game/code/server/cues.js +70 -0
  206. package/kits/hub-game/code/server/decor.js +269 -0
  207. package/kits/hub-game/code/server/doorAnalytics.js +52 -0
  208. package/kits/hub-game/code/server/earned.js +478 -0
  209. package/kits/hub-game/code/server/frameBatch.js +183 -0
  210. package/kits/hub-game/code/server/friendBests.js +166 -0
  211. package/kits/hub-game/code/server/friendsAmong.js +272 -0
  212. package/kits/hub-game/code/server/history.js +7 -0
  213. package/kits/hub-game/code/server/hub.js +2510 -95
  214. package/kits/hub-game/code/server/idle.js +60 -12
  215. package/kits/hub-game/code/server/index.js +28 -6
  216. package/kits/hub-game/code/server/invites.js +19 -0
  217. package/kits/hub-game/code/server/labels.js +36 -2
  218. package/kits/hub-game/code/server/loadAbandon.js +106 -0
  219. package/kits/hub-game/code/server/manifest.js +586 -7
  220. package/kits/hub-game/code/server/menu.js +161 -0
  221. package/kits/hub-game/code/server/npcs.js +1025 -113
  222. package/kits/hub-game/code/server/observe.js +408 -0
  223. package/kits/hub-game/code/server/padOccupancy.js +85 -0
  224. package/kits/hub-game/code/server/party.js +2 -2
  225. package/kits/hub-game/code/server/players.js +30 -0
  226. package/kits/hub-game/code/server/resumePose.js +152 -0
  227. package/kits/hub-game/code/server/say.js +1 -1
  228. package/kits/hub-game/code/server/shot.js +110 -0
  229. package/kits/hub-game/code/server/standing.js +123 -0
  230. package/kits/hub-game/code/server/storageLimit.js +187 -0
  231. package/kits/hub-game/code/server/vis.js +175 -0
  232. package/kits/hub-game/code/server/wear.js +12 -0
  233. package/kits/hub-game/code/server/yours.js +59 -0
  234. package/kits/hub-game/code/shared/act.js +35 -0
  235. package/kits/hub-game/code/shared/cues.js +9 -0
  236. package/kits/hub-game/code/shared/danceIdle.js +28 -0
  237. package/kits/hub-game/code/shared/decor.js +41 -0
  238. package/kits/hub-game/code/shared/loadStages.js +12 -0
  239. package/kits/hub-game/code/shared/quality.js +74 -0
  240. package/kits/hub-game/code/shared/say.js +2 -0
  241. package/kits/hub-game/code/shared/shot.js +53 -0
  242. package/kits/hub-game/code/shared/spin.js +57 -0
  243. package/kits/hub-game/code/systems/hub.js +1753 -202
  244. package/kits/hub-game/docs/analytics.md +279 -0
  245. package/kits/hub-game/docs/content-pack.md +1 -1
  246. package/kits/hub-game/docs/contract.md +3475 -77
  247. package/kits/hub-game/docs/home-pieces.md +71 -0
  248. package/kits/hub-game/docs/observed-progress.md +252 -0
  249. package/kits/hub-game/main.jsx +2 -0
  250. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  251. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  252. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  253. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  254. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  255. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  256. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  257. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  258. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  259. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  260. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  261. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  262. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  263. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  264. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  265. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  266. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  267. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  268. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  269. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  270. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  271. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  272. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  273. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  274. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  275. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  276. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  277. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  278. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  279. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  280. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  281. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  282. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  283. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  284. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  285. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  286. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  287. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  288. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  289. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  290. package/kits/hub-game/package-lock.json +10 -1
  291. package/kits/hub-game/package.json +6 -2
  292. package/kits/hub-game/play/player.js +142 -0
  293. package/kits/hub-game/play/registry.js +47 -0
  294. package/kits/hub-game/play.jsx +37 -0
  295. package/kits/hub-game/scripts/check.mjs +117 -16
  296. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  297. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +132 -0
  298. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  299. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +26 -0
  300. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +123 -0
  301. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  302. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  303. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  304. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  305. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  306. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  307. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  308. package/kits/hub-game/scripts/pose-storage-fixture.mjs +46 -0
  309. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  310. package/kits/hub-game/scripts/test-act-client.mjs +186 -0
  311. package/kits/hub-game/scripts/test-act.mjs +171 -0
  312. package/kits/hub-game/scripts/test-action-layout.mjs +80 -0
  313. package/kits/hub-game/scripts/test-action-observers.mjs +46 -0
  314. package/kits/hub-game/scripts/test-actions-client.mjs +853 -0
  315. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  316. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  317. package/kits/hub-game/scripts/test-actors.mjs +38 -23
  318. package/kits/hub-game/scripts/test-analytics.mjs +76 -0
  319. package/kits/hub-game/scripts/test-anonymous-entry.mjs +28 -0
  320. package/kits/hub-game/scripts/test-arrival-pose-server.mjs +196 -0
  321. package/kits/hub-game/scripts/test-arrival-pose.mjs +24 -0
  322. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  323. package/kits/hub-game/scripts/test-ask-slot.mjs +85 -0
  324. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  325. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  326. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  327. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  328. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  329. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  330. package/kits/hub-game/scripts/test-avatar-wire.mjs +792 -0
  331. package/kits/hub-game/scripts/test-avatar.mjs +584 -7
  332. package/kits/hub-game/scripts/test-back-visibility.mjs +82 -0
  333. package/kits/hub-game/scripts/test-ballot.mjs +1008 -0
  334. package/kits/hub-game/scripts/test-ban-join.mjs +121 -13
  335. package/kits/hub-game/scripts/test-build.mjs +49 -0
  336. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  337. package/kits/hub-game/scripts/test-chat.mjs +863 -0
  338. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  339. package/kits/hub-game/scripts/test-companion-chat.mjs +216 -0
  340. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  341. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  342. package/kits/hub-game/scripts/test-control-layout-dom.mjs +120 -0
  343. package/kits/hub-game/scripts/test-crowd-names.mjs +205 -0
  344. package/kits/hub-game/scripts/test-decor-client.mjs +344 -0
  345. package/kits/hub-game/scripts/test-decor.mjs +464 -0
  346. package/kits/hub-game/scripts/test-default-environment-root.mjs +95 -0
  347. package/kits/hub-game/scripts/test-default-environment.mjs +267 -0
  348. package/kits/hub-game/scripts/test-door-analytics.mjs +58 -0
  349. package/kits/hub-game/scripts/test-door-jump.mjs +100 -0
  350. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  351. package/kits/hub-game/scripts/test-earned.mjs +1224 -0
  352. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  353. package/kits/hub-game/scripts/test-far-avatars.mjs +340 -0
  354. package/kits/hub-game/scripts/test-fps-telemetry.mjs +112 -0
  355. package/kits/hub-game/scripts/test-frame-batch.mjs +252 -0
  356. package/kits/hub-game/scripts/test-fresh-friends.mjs +118 -0
  357. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  358. package/kits/hub-game/scripts/test-grab-orbit.mjs +961 -0
  359. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  360. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  361. package/kits/hub-game/scripts/test-high-only.mjs +170 -0
  362. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  363. package/kits/hub-game/scripts/test-hub-ops.mjs +758 -2
  364. package/kits/hub-game/scripts/test-hub-trip.mjs +1594 -12
  365. package/kits/hub-game/scripts/test-hud-clear.mjs +484 -57
  366. package/kits/hub-game/scripts/test-hud-defects-dom.mjs +100 -0
  367. package/kits/hub-game/scripts/test-hud-rate.mjs +224 -0
  368. package/kits/hub-game/scripts/test-hud-safe-visibility-dom.mjs +83 -0
  369. package/kits/hub-game/scripts/test-idle.mjs +427 -1
  370. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  371. package/kits/hub-game/scripts/test-interest-cells.mjs +513 -0
  372. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  373. package/kits/hub-game/scripts/test-interest.mjs +15 -0
  374. package/kits/hub-game/scripts/test-invites-client.mjs +430 -0
  375. package/kits/hub-game/scripts/test-invites.mjs +109 -0
  376. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  377. package/kits/hub-game/scripts/test-labels.mjs +664 -0
  378. package/kits/hub-game/scripts/test-landscape-layout.mjs +194 -0
  379. package/kits/hub-game/scripts/test-list-scroll-dom.mjs +49 -0
  380. package/kits/hub-game/scripts/test-load-abandon.mjs +246 -0
  381. package/kits/hub-game/scripts/test-loading-cover.mjs +162 -0
  382. package/kits/hub-game/scripts/test-manifest.mjs +472 -0
  383. package/kits/hub-game/scripts/test-menu-client.mjs +585 -0
  384. package/kits/hub-game/scripts/test-menu.mjs +319 -0
  385. package/kits/hub-game/scripts/test-npcs.mjs +2528 -13
  386. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  387. package/kits/hub-game/scripts/test-observed.mjs +745 -0
  388. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  389. package/kits/hub-game/scripts/test-pad-cues.mjs +304 -0
  390. package/kits/hub-game/scripts/test-pad-occupancy.mjs +177 -0
  391. package/kits/hub-game/scripts/test-picker.mjs +541 -0
  392. package/kits/hub-game/scripts/test-placement-cache.mjs +690 -0
  393. package/kits/hub-game/scripts/test-progress-reset.mjs +559 -0
  394. package/kits/hub-game/scripts/test-push-visit.mjs +26 -0
  395. package/kits/hub-game/scripts/test-quality.mjs +385 -0
  396. package/kits/hub-game/scripts/test-rehello.mjs +1733 -0
  397. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  398. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  399. package/kits/hub-game/scripts/test-resume-action-order.mjs +598 -0
  400. package/kits/hub-game/scripts/test-resume-held.mjs +239 -0
  401. package/kits/hub-game/scripts/test-resume-pose.mjs +142 -0
  402. package/kits/hub-game/scripts/test-safe-events-dom.mjs +116 -0
  403. package/kits/hub-game/scripts/test-safe-layout.mjs +330 -0
  404. package/kits/hub-game/scripts/test-say.mjs +1 -1
  405. package/kits/hub-game/scripts/test-shot.mjs +901 -0
  406. package/kits/hub-game/scripts/test-signin-client.mjs +45 -0
  407. package/kits/hub-game/scripts/test-soundscape.mjs +5437 -0
  408. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  409. package/kits/hub-game/scripts/test-standing.mjs +449 -0
  410. package/kits/hub-game/scripts/test-storage-limit.mjs +333 -0
  411. package/kits/hub-game/scripts/test-stuck.mjs +1904 -0
  412. package/kits/hub-game/scripts/test-talk-overlay-dom.mjs +130 -0
  413. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  414. package/kits/hub-game/scripts/test-tiers-render.mjs +412 -0
  415. package/kits/hub-game/scripts/test-tiers.mjs +476 -2
  416. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  417. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  418. package/kits/hub-game/scripts/test-vis.mjs +770 -0
  419. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  420. package/kits/hub-game/scripts/test-weakest-tier.mjs +924 -0
  421. package/kits/hub-game/scripts/test-world-labels.mjs +367 -0
  422. package/kits/hub-game/scripts/test-yours-chrome.mjs +210 -0
  423. package/kits/hub-game/scripts/test-yours.mjs +403 -0
  424. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  425. package/kits/multiplayer-3d/castle.json +5 -5
  426. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  427. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  428. package/kits/multiplayer-3d/code/client/joinFailure.js +27 -0
  429. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  430. package/kits/multiplayer-3d/code/client/resumeGate.js +139 -0
  431. package/kits/multiplayer-3d/code/options.js +5 -0
  432. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  433. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  434. package/kits/multiplayer-3d/code/server/world.js +7 -0
  435. package/kits/multiplayer-3d/code/systems/multiplayer.js +443 -34
  436. package/kits/multiplayer-3d/package-lock.json +8 -1
  437. package/kits/multiplayer-3d/package.json +3 -1
  438. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  439. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  440. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  441. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  442. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  443. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  444. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  445. package/kits/multiplayer-3d/scripts/test-join-watchdog.mjs +436 -0
  446. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  447. package/kits/multiplayer-3d/scripts/test-resume-gate.mjs +624 -0
  448. package/kits/physics-2d/CLAUDE.md +19 -1
  449. package/kits/physics-2d/castle.json +2 -2
  450. package/kits/physics-2d/engine/frozenActors.js +233 -0
  451. package/kits/physics-2d/engine/scene.js +337 -3
  452. package/kits/physics-2d/engine/skyKey.js +129 -0
  453. package/kits/physics-2d/engine/stillClock.js +106 -0
  454. package/kits/physics-2d/engine/updateBudget.js +21 -0
  455. package/kits/physics-2d/eslint.config.js +1 -1
  456. package/kits/physics-2d/play/behaviors/AnalogStick.js +198 -0
  457. package/kits/physics-2d/play/behaviors/Camera.js +40 -0
  458. package/kits/physics-2d/play/behaviors/Collider.js +122 -0
  459. package/kits/physics-2d/play/behaviors/Draggable.js +115 -0
  460. package/kits/physics-2d/play/behaviors/Goal.js +46 -0
  461. package/kits/physics-2d/play/behaviors/Joints.js +126 -0
  462. package/kits/physics-2d/play/behaviors/Layout.js +71 -0
  463. package/kits/physics-2d/play/behaviors/RigidBody.js +57 -0
  464. package/kits/physics-2d/play/behaviors/Slingshot.js +142 -0
  465. package/kits/physics-2d/play/behaviors/SoundPlayer.js +263 -0
  466. package/kits/physics-2d/play/behaviors/Sprite.js +406 -0
  467. package/kits/physics-2d/play/behaviors/Style.js +209 -0
  468. package/kits/physics-2d/play/behaviors/Text.js +85 -0
  469. package/kits/physics-2d/play/behaviors/Video.js +93 -0
  470. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  471. package/kits/physics-3d/CLAUDE.md +42 -529
  472. package/kits/physics-3d/behaviors/Body.jsx +3 -0
  473. package/kits/physics-3d/behaviors/Model.jsx +3 -0
  474. package/kits/physics-3d/behaviors/Player.jsx +661 -87
  475. package/kits/physics-3d/behaviors/Shape.jsx +3 -0
  476. package/kits/physics-3d/behaviors/Solid.jsx +3 -0
  477. package/kits/physics-3d/behaviors/Transform.jsx +3 -0
  478. package/kits/physics-3d/castle.json +3 -3
  479. package/kits/physics-3d/docs/engine-camera.md +542 -0
  480. package/kits/physics-3d/docs/engine-frame-cap.md +136 -0
  481. package/kits/physics-3d/docs/engine-load.md +149 -0
  482. package/kits/physics-3d/docs/engine-look.md +114 -0
  483. package/kits/physics-3d/docs/engine-shadows.md +372 -0
  484. package/kits/physics-3d/docs/engine-skip-work.md +187 -0
  485. package/kits/physics-3d/docs/engine-sky.md +198 -0
  486. package/kits/physics-3d/docs/engine-static-actors.md +226 -0
  487. package/kits/physics-3d/docs/engine-view.md +37 -0
  488. package/kits/physics-3d/docs/pxmodel-format.md +9 -1
  489. package/kits/physics-3d/engine3d/PlayOnly3D.jsx +5 -1
  490. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +19 -277
  491. package/kits/physics-3d/engine3d/actornode.js +87 -0
  492. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  493. package/kits/physics-3d/engine3d/branches.js +3 -13
  494. package/kits/physics-3d/engine3d/cage.js +2 -7
  495. package/kits/physics-3d/engine3d/cageops.js +2 -17
  496. package/kits/physics-3d/engine3d/dataBehaviors.js +12 -0
  497. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  498. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  499. package/kits/physics-3d/engine3d/framecap.js +99 -0
  500. package/kits/physics-3d/engine3d/frozenphysics.js +140 -0
  501. package/kits/physics-3d/engine3d/frozenstatics.js +273 -0
  502. package/kits/physics-3d/engine3d/gait.js +126 -0
  503. package/kits/physics-3d/engine3d/initialModelFiles.js +18 -0
  504. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  505. package/kits/physics-3d/engine3d/look.js +514 -48
  506. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  507. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  508. package/kits/physics-3d/engine3d/modelFiles.js +3 -17
  509. package/kits/physics-3d/engine3d/modelMath.js +49 -0
  510. package/kits/physics-3d/engine3d/modelready.js +16 -0
  511. package/kits/physics-3d/engine3d/motion.js +39 -10
  512. package/kits/physics-3d/engine3d/nearshadows.js +106 -21
  513. package/kits/physics-3d/engine3d/optimize.js +9 -5
  514. package/kits/physics-3d/engine3d/orbitinput.js +522 -10
  515. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  516. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  517. package/kits/physics-3d/engine3d/partgeometry.js +1 -16
  518. package/kits/physics-3d/engine3d/paths.js +1 -9
  519. package/kits/physics-3d/engine3d/playTimings.js +50 -0
  520. package/kits/physics-3d/engine3d/playerRun.js +372 -0
  521. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  522. package/kits/physics-3d/engine3d/rapier.js +27 -0
  523. package/kits/physics-3d/engine3d/scatter.js +1 -11
  524. package/kits/physics-3d/engine3d/shadowfade.js +890 -0
  525. package/kits/physics-3d/engine3d/sky.js +547 -0
  526. package/kits/physics-3d/engine3d/skylife.js +306 -0
  527. package/kits/physics-3d/engine3d/squarefirst.js +177 -0
  528. package/kits/physics-3d/engine3d/stillshadows.js +399 -0
  529. package/kits/physics-3d/engine3d/sweep.js +1 -25
  530. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  531. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  532. package/kits/physics-3d/engine3d/world3d.js +1253 -76
  533. package/kits/physics-3d/eslint.config.js +2 -1
  534. package/kits/physics-3d/main.jsx +10 -2
  535. package/kits/physics-3d/package-lock.json +7 -0
  536. package/kits/physics-3d/package.json +5 -1
  537. package/kits/physics-3d/play/behaviors/Body.js +31 -0
  538. package/kits/physics-3d/play/behaviors/Door.js +37 -0
  539. package/kits/physics-3d/play/behaviors/Lookable.js +16 -0
  540. package/kits/physics-3d/play/behaviors/Model.js +23 -0
  541. package/kits/physics-3d/play/behaviors/Pickup.js +46 -0
  542. package/kits/physics-3d/play/behaviors/Player.js +1204 -0
  543. package/kits/physics-3d/play/behaviors/Shape.js +47 -0
  544. package/kits/physics-3d/play/behaviors/Solid.js +16 -0
  545. package/kits/physics-3d/play/behaviors/Transform.js +29 -0
  546. package/kits/physics-3d/pnpm-lock.yaml +8 -0
  547. package/kits/physics-3d/scripts/bench-shadow-fade.mjs +37 -0
  548. package/kits/physics-3d/scripts/build-rapier-gz.mjs +56 -0
  549. package/kits/physics-3d/scripts/frozen-statics-fixture.mjs +141 -0
  550. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  551. package/kits/physics-3d/scripts/test-camera-follow.mjs +5 -1
  552. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2613 -82
  553. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +2 -2
  554. package/kits/physics-3d/scripts/test-empty-gait-hints.mjs +89 -0
  555. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +438 -0
  556. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  557. package/kits/physics-3d/scripts/test-frozen-nested.mjs +49 -0
  558. package/kits/physics-3d/scripts/test-frozen-statics-legacy-physics2d.mjs +123 -0
  559. package/kits/physics-3d/scripts/test-frozen-statics.mjs +434 -0
  560. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  561. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  562. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  563. package/kits/physics-3d/scripts/test-near-shadows.mjs +5 -2
  564. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +2001 -0
  565. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +582 -0
  566. package/kits/physics-3d/scripts/test-orbit-shot.mjs +657 -0
  567. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  568. package/kits/physics-3d/scripts/test-rapier-gz.mjs +106 -0
  569. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  570. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  571. package/kits/physics-3d/scripts/test-square-first.mjs +921 -0
  572. package/kits/physics-3d/scripts/test-static-actors.mjs +10 -1
  573. package/kits/physics-3d/scripts/test-static-physics.mjs +4 -1
  574. package/kits/physics-3d/scripts/test-static-scenery.mjs +2174 -0
  575. package/kits/physics-3d/scripts/test-steady-hover.mjs +7 -2
  576. package/kits/physics-3d/scripts/test-still-shadows.mjs +477 -0
  577. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  578. package/kits/physics-3d/systems/physics3d.js +419 -9
  579. package/kits/real-time/castle.json +2 -2
  580. package/kits/real-time/code/client/connection.js +33 -10
  581. package/kits/real-time/code/client/gameHooks.js +2 -0
  582. package/kits/real-time/code/client/joinOverlay.js +9 -4
  583. package/kits/real-time/code/server/gameHooks.js +7 -0
  584. package/kits/real-time/code/server/session.js +102 -22
  585. package/kits/real-time/package-lock.json +1 -1
  586. package/package.json +2 -2
  587. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -1,230 +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. A `hat-<id>` kind is a hat
5
- // from `hats.js`: a few matte Shapes on the avatar's head, turning with it.
6
- // Kinds this kit does not draw are not drawn. A piece is `wear:<playerId>:<n>`; it is despawned when the
7
- // wearable changes or goes, or the avatar does, and retired with the
8
- // multiplayer kit so it is never reported to the session as gone.
9
-
10
- // Heights from the avatar's origin, the capsule's centre. A halo sits just
11
- // over the avatar's own top and an orbit circles it (`top`, metres above its
12
- // model's feet), so a short avatar wears them as close as a tall one, under
13
- // its name tag.
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';
14
31
  import { hatId } from './hats.js';
32
+ import { earnedLook, tinted } from './earned.js';
15
33
 
16
- const FEET_Y = -0.85;
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.
17
36
  const MODEL_FEET_Y = -0.7;
18
- 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;
19
39
  export const DEFAULT_TOP = 1.65;
20
- const ORBIT_RADIUS = 0.5;
21
40
  const COLOR = /^#[0-9a-f]{6}$/i;
22
41
  const MAX_RARITY = 9;
23
42
 
24
- const DEG = Math.PI / 180;
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;
63
+
64
+ const mm = (n) => Math.round(n * 1000) / 1000;
25
65
 
26
- // A piece's Shape: glowing in the wearable's colour, or `matte` (a hat), which
27
- // has no glow at all.
28
- function shape(kind, color, rarity, size, { matte = false } = {}) {
29
- if (matte) {
30
- return { kind, ...size, color, roughness: 0.9, metalness: 0, solid: false };
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;
82
+ if (!color) {
83
+ return null;
31
84
  }
32
- return {
33
- kind,
34
- ...size,
85
+ const grow = 1 + rarity * 0.05;
86
+ const glow = mm(0.6 + rarity * 0.15);
87
+ switch (wearable.kind) {
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
+ }
100
+ case 'aura':
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 };
127
+ }
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({
35
136
  color,
36
137
  emissive: color,
37
- emissiveIntensity: 0.6 + rarity * 0.15,
138
+ emissiveIntensity: glow,
38
139
  roughness: 0.4,
39
140
  metalness: 0.1,
40
- solid: false,
41
- };
141
+ ...(opacity < 1 ? { transparent: true, opacity, depthWrite: false } : {}),
142
+ });
42
143
  }
43
144
 
44
- // The hats (`hats.js` has the ids). Each is at most three pieces, in metres
45
- // from the hat's seat -- the ring of the head a 0.2 m rim rests on -- with +z
46
- // the way the wearer faces: `disc` a cylinder and `slab` a box, centred `y`
47
- // over the seat, leaning `tilt` degrees to the side. A piece with no colour
48
- // takes the wearable's; the others are the hat's own. A `perch` hat is
49
- // narrower than the rim and stands on the crown of the head instead. None is
50
- // taller than 0.36 m before an avatar's fit scales it, which keeps every
51
- // avatar's under its name tag.
52
- const disc = (color, radius, height, y, { x = 0, z = 0, tilt = 0 } = {}) => ({ kind: 'cylinder', color, size: { radius, height }, x, y, z, tilt });
53
- const slab = (color, width, height, depth, y, { x = 0, z = 0, tilt = 0 } = {}) => ({ kind: 'box', color, size: { width, height, depth }, x, y, z, tilt });
54
- const INK = '#2b2b33';
55
- const HAT_DESIGNS = new Map([
56
- // stadium
57
- ['sweatband', { pieces: [disc(null, 0.23, 0.07, 0.02), disc('#ffffff', 0.235, 0.025, 0.02)] }],
58
- ['cap', { pieces: [disc(null, 0.21, 0.15, 0.075), slab(INK, 0.26, 0.025, 0.2, 0.02, { z: 0.27 })] }],
59
- ['foam-crown', { pieces: [disc(null, 0.22, 0.12, 0.06), slab(null, 0.44, 0.1, 0.09, 0.16), slab(null, 0.09, 0.1, 0.44, 0.16)] }],
60
- ['laurel', { pieces: [disc(null, 0.24, 0.05, 0.02), slab('#f2d57a', 0.08, 0.09, 0.04, 0.05, { z: 0.23 })] }],
61
- // hollow
62
- ['bat-clip', { pieces: [slab(INK, 0.07, 0.1, 0.06, 0.08, { x: 0.13, z: 0.04 }), slab(null, 0.32, 0.07, 0.02, 0.11, { x: 0.13, z: 0.04, tilt: -12 })] }],
63
- ['witch', { pieces: [disc(null, 0.34, 0.025, 0.015), disc(null, 0.19, 0.17, 0.1), disc(null, 0.09, 0.15, 0.255, { x: -0.03, tilt: 14 })] }],
64
- ['lantern', { perch: true, pieces: [disc(INK, 0.13, 0.04, 0.02), disc(null, 0.11, 0.17, 0.12), disc(INK, 0.14, 0.04, 0.22)] }],
65
- ['crooked-top', { pieces: [disc(null, 0.3, 0.025, 0.015), disc('#d9c27a', 0.18, 0.13, 0.08), disc(null, 0.2, 0.16, 0.22, { x: -0.035, tilt: 12 })] }],
66
- // sunny
67
- ['straw', { pieces: [disc(null, 0.36, 0.025, 0.015), disc(null, 0.2, 0.15, 0.075)] }],
68
- ['flower-crown', { pieces: [disc('#5fa55a', 0.24, 0.06, 0.03), slab(null, 0.6, 0.05, 0.12, 0.026), slab(null, 0.12, 0.05, 0.6, 0.026)] }],
69
- ['beekeeper', { pieces: [disc(null, 0.19, 0.14, 0.09), disc(null, 0.34, 0.025, 0.03), disc('#e9e4cf', 0.31, 0.07, -0.02)] }],
70
- ['sunflower', { pieces: [disc(null, 0.3, 0.03, 0.05), disc('#5a3a1e', 0.16, 0.15, 0.075)] }],
71
- // harbour
72
- ['sailor', { pieces: [disc('#1f3a6b', 0.2, 0.08, 0.04), disc(null, 0.25, 0.07, 0.105)] }],
73
- ['souwester', { pieces: [disc(null, 0.2, 0.15, 0.075), disc(null, 0.33, 0.025, 0.015, { z: -0.09 })] }],
74
- ['captain', { pieces: [disc('#1c2740', 0.2, 0.08, 0.04), disc(null, 0.26, 0.07, 0.105), slab('#15151a', 0.26, 0.02, 0.12, 0.02, { z: 0.24 })] }],
75
- ['lighthouse', { perch: true, pieces: [disc(null, 0.13, 0.17, 0.085), disc('#ffe9a3', 0.1, 0.1, 0.215), disc('#c0392b', 0.13, 0.04, 0.28)] }],
76
- ]);
77
- export const HAT_IDS = [...HAT_DESIGNS.keys()];
78
- // Where a hat sits on an avatar this kit has no fit for: just under its top.
79
- const HAT_DROP = 0.1;
80
- const mm = (n) => Math.round(n * 1000) / 1000;
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) {
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
+ }
81
199
 
82
- // A hat's pieces on an avatar whose `fit` is `[seat, scale, rise]` (`avatar.js`
83
- // `hatFit`): the seat's height over the model's feet, how big the hat is
84
- // drawn for that head, and how far the crown of the head stands over the seat.
85
- function hatPieces(id, color, top, fit) {
86
- const design = HAT_DESIGNS.get(id);
87
- if (!design) {
88
- return null;
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
+ });
89
222
  }
90
- const [seat, scale, rise] = fit ?? [top - HAT_DROP, 1, 0];
91
- const base = MODEL_FEET_Y + seat + (design.perch ? rise : 0);
92
- return design.pieces.map((piece) => {
93
- const size = Object.fromEntries(Object.entries(piece.size).map(([key, value]) => [key, mm(value * scale)]));
94
- const at = { x: mm(piece.x * scale), y: mm(base + piece.y * scale), z: mm(piece.z * scale) };
95
- return { shape: shape(piece.kind, piece.color ?? color, 0, size, { matte: true }), at: () => at, turns: true, tilt: piece.tilt };
223
+ }
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
+ }
96
236
  });
97
237
  }
98
238
 
99
- // The pieces of a wearable, each a Shape and where it sits relative to the
100
- // avatar at time `t` (seconds). Null for a kind this kit does not draw. A
101
- // hat's pieces also say `turns` (they face the way the avatar does) and their
102
- // `tilt`; `fit` is the avatar's, for a hat alone.
103
- export function pieces(wearable, top = DEFAULT_TOP, fit = null) {
104
- const color = typeof wearable?.color === 'string' && COLOR.test(wearable.color) ? wearable.color.toLowerCase() : null;
105
- const rarity = Number.isInteger(wearable?.rarity) ? Math.min(MAX_RARITY, Math.max(0, wearable.rarity)) : 0;
106
- if (!color) {
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) {
107
275
  return null;
108
276
  }
109
- const grow = 1 + rarity * 0.05;
110
- switch (wearable.kind) {
111
- case 'halo':
112
- return [
113
- {
114
- shape: shape('cylinder', color, rarity, { radius: 0.35 * grow, height: 0.04 }),
115
- at: (t) => ({ x: 0, y: MODEL_FEET_Y + top + HALO_GAP + Math.sin(t * 2) * 0.03, z: 0 }),
116
- },
117
- ];
118
- case 'aura':
119
- return [
120
- {
121
- shape: shape('cylinder', color, rarity, { radius: 0.6 * grow, height: 0.02 }),
122
- at: () => ({ x: 0, y: FEET_Y + 0.02, z: 0 }),
123
- },
124
- ];
125
- case 'orbit': {
126
- const n = 1 + Math.floor(rarity / 3);
127
- const speed = 1.6 + rarity * 0.1;
128
- return Array.from({ length: n }, (_, i) => ({
129
- shape: shape('sphere', color, rarity, { radius: 0.07 * grow }),
130
- at: (t) => {
131
- const a = t * speed + (i * 2 * Math.PI) / n;
132
- return { x: Math.cos(a) * ORBIT_RADIUS, y: MODEL_FEET_Y + top + Math.sin(a * 2) * 0.05, z: Math.sin(a) * ORBIT_RADIUS };
133
- },
134
- }));
135
- }
136
- default: {
137
- const hat = hatId(wearable.kind);
138
- return hat ? hatPieces(hat, color, top, fit) : null;
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
+ }
139
353
  }
354
+ glowMap = new THREE.DataTexture(data, n, n);
355
+ glowMap.magFilter = THREE.LinearFilter;
356
+ glowMap.minFilter = THREE.LinearFilter;
357
+ glowMap.needsUpdate = true;
140
358
  }
359
+ return glowMap;
141
360
  }
142
361
 
143
362
  export function makeWear() {
144
- // playerId -> { json, ids, pieces }
363
+ // playerId -> { json, spec, group, node, world }
145
364
  const drawn = new Map();
146
-
147
- function remove(scene, playerId) {
365
+ function remove(playerId) {
148
366
  const entry = drawn.get(playerId);
149
367
  drawn.delete(playerId);
150
- for (const id of entry?.ids ?? []) {
151
- if (scene.getActor(id)) {
152
- scene.multiplayer?.avatars?.retired?.add(id);
153
- scene.despawnActor(id);
154
- }
368
+ if (entry?.group) {
369
+ dispose(entry.group, entry.spec);
155
370
  }
156
371
  }
157
372
 
158
373
  return {
159
- // Spawn, move and remove pieces to match `wearing` (playerId -> wearable).
160
- // `topOf(playerId)` is how tall that player's avatar stands, and
161
- // `fitOf(playerId)` how a hat sits on it (asked only for a hat).
162
- frame(scene, local, wearing, topOf = () => DEFAULT_TOP, now = performance.now(), fitOf = () => null) {
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
+ ) {
163
385
  const mp = scene.multiplayer;
386
+ const nodes = scene.three?.nodes;
387
+ const camera = scene.three?.camera?.position ?? null;
164
388
  const self = mp?.net?.selfId?.() ?? null;
165
389
  const t = now / 1000;
166
390
  for (const playerId of [...drawn.keys()]) {
167
391
  if (!wearing.has(playerId)) {
168
- remove(scene, playerId);
392
+ remove(playerId);
169
393
  }
170
394
  }
171
395
  for (const [playerId, wearable] of wearing) {
172
396
  const actorId = playerId === self ? local?.id : mp?.avatars?.actors?.get(playerId);
173
- const at = actorId ? scene.getActor(actorId)?.components.Transform : null;
397
+ const node = actorId ? (nodes?.get(actorId)?.node ?? null) : null;
174
398
  const top = topOf(playerId);
175
- const fit = hatId(wearable?.kind) ? fitOf(playerId) : null;
176
- const json = fit ? `${top}:${fit}:${JSON.stringify(wearable)}` : `${top}:${JSON.stringify(wearable)}`;
177
- if (!at || drawn.get(playerId)?.json !== json) {
178
- 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;
405
+ }
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);
179
416
  }
180
- if (!at) {
417
+ if (!entry.group) {
181
418
  continue;
182
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}`;
183
493
  let entry = drawn.get(playerId);
184
- if (!entry) {
185
- const parts = pieces(wearable, top, fit) ?? [];
186
- 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 };
187
501
  drawn.set(playerId, entry);
188
- entry.pieces.forEach((piece, n) => {
189
- const p = piece.at(t);
190
- scene.spawnActor({
191
- id: entry.ids[n],
192
- components: { Transform: { x: at.x + p.x, y: at.y + p.y, z: at.z + p.z, ...(piece.tilt ? { rotationZ: piece.tilt } : {}) }, Shape: { ...piece.shape } },
193
- });
194
- });
195
502
  }
196
- entry.pieces.forEach((piece, n) => {
197
- const pt = scene.getActor(entry.ids[n])?.components.Transform;
198
- if (pt) {
199
- const p = piece.at(t);
200
- pt.y = at.y + p.y;
201
- if (piece.turns) {
202
- // A hat faces the way its wearer does: the engine turns local +x
203
- // onto (cos, -sin) and +z onto (sin, cos).
204
- const turn = at.rotationY ?? 0;
205
- const cos = Math.cos(turn * DEG);
206
- const sin = Math.sin(turn * DEG);
207
- pt.x = at.x + cos * p.x + sin * p.z;
208
- pt.z = at.z - sin * p.x + cos * p.z;
209
- pt.rotationY = turn;
210
- } else {
211
- pt.x = at.x + p.x;
212
- pt.z = at.z + p.z;
213
- }
214
- }
215
- });
503
+ if (entry.group && (entry.node !== node || entry.group.parent !== node)) {
504
+ node.add(entry.group);
505
+ entry.node = node;
506
+ }
216
507
  }
217
508
  },
218
509
 
219
- // A scene load took every piece with it: forget them.
220
510
  forget() {
221
- drawn.clear();
511
+ for (const playerId of [...drawn.keys()]) {
512
+ remove(playerId);
513
+ }
222
514
  },
223
515
 
224
- // A session switch that kept the scene: take every piece down.
225
- clear(scene) {
516
+ clear() {
226
517
  for (const playerId of [...drawn.keys()]) {
227
- remove(scene, playerId);
518
+ remove(playerId);
228
519
  }
229
520
  },
230
521
  };