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
@@ -9,8 +9,16 @@
9
9
  // else in the kit or any game reads where it comes from.
10
10
 
11
11
  import * as castleSdk from 'castle-web-sdk';
12
+ import * as Colors from './avatarColors.js';
13
+ import { deck } from './state.js';
12
14
 
13
- export const AVATARS = 4;
15
+ export const AVATARS = 16;
16
+ // The first four are the compatibility defaults every client can draw, not
17
+ // the range for a new local pick. Unknown indexes fold into these, and the
18
+ // fade-cleanup guard keeps their original behavior. 4-15 (v1.51) are toon's
19
+ // alone; another set draws them from toon's blueprint, at toon's height and
20
+ // hat fit (`drawn`, `top`, `hatFit`).
21
+ export const DEFAULT_AVATARS = 4;
14
22
 
15
23
  // The avatar sets. Each draws the same four avatar indexes in its own look:
16
24
  // `toon` is the kit's first set and the default (`blueprints/avatar-<n>.scene`),
@@ -26,13 +34,126 @@ const STYLE_PARAM = 'hubStyle';
26
34
  // it, in metres (`models/avatar-<n>.pxmodel`, `models/<style>/avatar-<n>.pxmodel`):
27
35
  // what a player wears over one (`wear.js`) sits by it.
28
36
  const TOPS = {
29
- toon: [1.38, 1.5, 1.42, 1.56],
37
+ toon: [1.38, 1.5, 1.42, 1.56, 1.31, 1.39, 1.59, 1.29, 1.24, 1.37, 1.38, 1.51, 1.44, 1.38, 1.37, 1.37],
30
38
  blocky: [1.45, 1.66, 1.6, 1.51],
31
39
  bean: [1.37, 1.41, 1.7, 1.31],
32
40
  pixel: [1.37, 1.44, 1.35, 1.54],
33
41
  };
34
42
  const DEFAULT_TOP = 1.65;
35
43
 
44
+ // How a hat sits on each avatar (`wear.js`), `[seat, scale, rise]`: how big the
45
+ // hat is drawn for the size of the head (toon's Star wears a small one on its
46
+ // top point); the height over its feet of the ring of its head that the hat's
47
+ // rim, 0.2 m times the scale, rests on, measured down onto each model, not
48
+ // its top, which is often an ear, a bow or a leaf; and how far the crown of
49
+ // the head stands over the seat, for a hat narrower than the rim.
50
+ const HAT_FITS = {
51
+ toon: [
52
+ [1.27, 1.3, 0.08],
53
+ [1.21, 1.1, 0.07],
54
+ [1.21, 1.1, 0.08],
55
+ [1.38, 1, 0.14],
56
+ [1.21, 1.1, 0.09],
57
+ [1.22, 1, 0.07],
58
+ [1.21, 1.05, 0.09],
59
+ [1.2, 1.05, 0.09],
60
+ [1.21, 0.8, 0.03],
61
+ [1.22, 1, 0.08],
62
+ [1.24, 1.1, 0.01],
63
+ [1.3, 0.8, 0.06],
64
+ [1.37, 1.1, 0.06],
65
+ [1.37, 0.9, 0.01],
66
+ [1.27, 1.1, 0.08],
67
+ [1.23, 1.1, 0.08],
68
+ ],
69
+ blocky: [
70
+ [1.39, 1.1, 0.04],
71
+ [1.48, 1.1, 0],
72
+ [1.47, 1.1, 0],
73
+ [1.48, 1.1, 0],
74
+ ],
75
+ bean: [
76
+ [1.27, 1.3, 0.08],
77
+ [1.16, 1.3, 0.11],
78
+ [1.22, 1, 0.1],
79
+ [1.18, 1.3, 0.06],
80
+ ],
81
+ pixel: [
82
+ [1.33, 1.2, 0.04],
83
+ [1.33, 1.15, 0.07],
84
+ [1.27, 1.15, 0.06],
85
+ [1.33, 1.15, 0.01],
86
+ ],
87
+ };
88
+
89
+ // Where an earned item (`earned.js`, v1.53) sits on each avatar, measured
90
+ // against the models (`scripts/test-earned-client.mjs` holds each against
91
+ // them), in metres over the feet with +z the way the avatar faces and +x its
92
+ // left:
93
+ // chest [x, y, z, yaw, size?] a badge or pin: the front of the body, left
94
+ // of its middle, a badge (drawn 2.6 times its model,
95
+ // 0.19 m from its middle) clear under the lowest of
96
+ // the face (an eye, a mouth, a cheek) and of a head
97
+ // over the body, turned `yaw` degrees with a round
98
+ // body and out far enough that no part of the body
99
+ // under it stands through it; `size` draws it
100
+ // smaller where there is no room (Castle's eye)
101
+ // waist [y, rx, rz] a belt: round the outside of the body there, rx and
102
+ // rz its half width and depth plus 2 cm
103
+ // sash [y, a, rz, tilt] a sash: a ring round the body at its middle `y`,
104
+ // `a` its half length in its own plane (the body's
105
+ // half width plus 2 cm over cos tilt) and `rz` the
106
+ // body's depth plus 2 cm, tilted `tilt` degrees to
107
+ // the right shoulder: 45 on a body with a head over
108
+ // it, less on a one-piece body where a steeper one
109
+ // would cross the face or drop below the body
110
+ // hand [x, y, z] a held thing: the middle of the right hand (the
111
+ // end of the arm where it has no hand)
112
+ // square a boxy body (blocky, pixel): rings are square
113
+ // A one-piece body (toon's Blob, blocky's, the beans, pixel's Castle) has its
114
+ // face on it: the chest item goes under the face, and Castle's, smaller, under
115
+ // its eye.
116
+ // scripts/test-earned-client.mjs measures each against the models.
117
+ const EARNED_FITS = {
118
+ toon: [
119
+ { chest: [0.19, 0.52, 0.35, 15], waist: [0.41, 0.41, 0.41], sash: [0.46, 0.51, 0.41, 36], hand: [-0.47, 0.38, 0.01] },
120
+ { chest: [0.06, 0.52, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.51, 0.35, 0.26, 45], hand: [-0.33, 0.34, 0.01] },
121
+ { chest: [0.06, 0.51, 0.21, 22], waist: [0.36, 0.23, 0.23], sash: [0.51, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
122
+ { chest: [0.06, 0.45, 0.21, 23], waist: [0.35, 0.21, 0.21], sash: [0.5, 0.32, 0.24, 45], hand: [-0.33, 0.3, 0.01] },
123
+ // 4-15 (v1.51), fitted by the same measurements, as 1-3 were.
124
+ { chest: [0.06, 0.53, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.5, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
125
+ { chest: [0.06, 0.54, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.51, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
126
+ { chest: [0.06, 0.54, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.5, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
127
+ { chest: [0.06, 0.55, 0.26, 22], waist: [0.36, 0.26, 0.26], sash: [0.51, 0.41, 0.29, 45], hand: [-0.33, 0.34, 0.01] },
128
+ { chest: [0.06, 0.56, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.51, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
129
+ { chest: [0.06, 0.54, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.51, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
130
+ { chest: [0.06, 0.61, 0.15, 6], waist: [0.4, 0.21, 0.16], sash: [0.56, 0.3, 0.16, 45], hand: [-0.33, 0.34, 0.01] },
131
+ { chest: [0.06, 0.53, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.5, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
132
+ { chest: [0.06, 0.45, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.46, 0.37, 0.26, 45], hand: [-0.33, 0.34, 0.01] },
133
+ { chest: [0.06, 0.53, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.5, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
134
+ { chest: [0.06, 0.56, 0.21, 22], waist: [0.36, 0.15, 0.15], sash: [0.51, 0.27, 0.19, 45], hand: [-0.33, 0.34, 0.01] },
135
+ { chest: [0.06, 0.53, 0.22, 22], waist: [0.36, 0.22, 0.22], sash: [0.5, 0.35, 0.25, 45], hand: [-0.33, 0.34, 0.01] },
136
+ ],
137
+ blocky: [
138
+ { chest: [0.17, 0.56, 0.23, 0], waist: [0.48, 0.37, 0.24], sash: [0.6, 0.47, 0.24, 40], hand: [-0.47, 0.26, 0], square: true },
139
+ { chest: [0.09, 0.73, 0.15, 0], waist: [0.6, 0.27, 0.16], sash: [0.73, 0.38, 0.16, 45], hand: [-0.37, 0.56, 0], square: true },
140
+ { chest: [0.09, 0.73, 0.15, 0], waist: [0.6, 0.27, 0.16], sash: [0.73, 0.38, 0.16, 45], hand: [-0.37, 0.56, 0], square: true },
141
+ { chest: [0.09, 0.73, 0.15, 0], waist: [0.6, 0.27, 0.16], sash: [0.73, 0.38, 0.16, 45], hand: [-0.37, 0.56, 0], square: true },
142
+ ],
143
+ bean: [
144
+ { chest: [0.2, 0.49, 0.35, 27], waist: [0.34, 0.42, 0.42], sash: [0.42, 0.52, 0.42, 36], hand: [-0.49, 0.48, 0.03] },
145
+ { chest: [0.19, 0.55, 0.33, 34], waist: [0.33, 0.35, 0.35], sash: [0.48, 0.53, 0.4, 40], hand: [-0.47, 0.49, 0.03] },
146
+ { chest: [0.17, 0.57, 0.31, 27], waist: [0.34, 0.31, 0.31], sash: [0.54, 0.47, 0.37, 40], hand: [-0.43, 0.5, 0.03] },
147
+ { chest: [0.19, 0.39, 0.38, 34], waist: [0.32, 0.35, 0.35], sash: [0.28, 0.36, 0.41, 36], hand: [-0.51, 0.43, 0.03] },
148
+ ],
149
+ pixel: [
150
+ { chest: [0.1, 0.4, 0.39, 0, 0.75], waist: [0.4, 0.4, 0.4], sash: [0.42, 0.5, 0.4, 36], hand: [-0.49, 0.47, 0] },
151
+ { chest: [0.05, 0.56, 0.15, 0], waist: [0.43, 0.23, 0.16], sash: [0.56, 0.33, 0.16, 45], hand: [-0.28, 0.47, 0], square: true },
152
+ { chest: [0.05, 0.56, 0.22, 0], waist: [0.43, 0.23, 0.23], sash: [0.56, 0.33, 0.23, 45], hand: [-0.28, 0.47, 0], square: true },
153
+ { chest: [0.05, 0.56, 0.15, 0], waist: [0.43, 0.23, 0.16], sash: [0.56, 0.33, 0.16, 45], hand: [-0.28, 0.47, 0], square: true },
154
+ ],
155
+ };
156
+
36
157
  // Where the kit's blueprints are: inside the import in a deck, at the root
37
158
  // while this kit is served as itself.
38
159
  const ROOTS = ['imports/castle.hub-game/', ''];
@@ -44,10 +165,16 @@ const platform = {
44
165
  state: 'idle',
45
166
  // The avatar ghost last confirmed.
46
167
  confirmed: null,
168
+ // Colour support requires both the initial get answer and the SDK marker.
169
+ color: 0,
170
+ colors: false,
171
+ desiredColor: null,
47
172
  // The player's latest pick, until ghost has it or refused it; worn meanwhile.
48
173
  desired: null,
49
174
  // The pick being written; one write at a time, so answers cannot cross.
50
175
  writing: null,
176
+ retries: 0,
177
+ lastError: null,
51
178
  };
52
179
 
53
180
  // The SDK's Avatar, or null on an SDK from before it. Tests swap it.
@@ -56,6 +183,86 @@ function api() {
56
183
  return apiOverride !== undefined ? apiOverride : (castleSdk.Avatar ?? null);
57
184
  }
58
185
 
186
+ const RETRY_DELAYS = [2000, 4000, 8000, 16000, 30000];
187
+ // Only a failure to reach the host is worth another try: the SDK reports a
188
+ // timeout or an unreachable host as CASTLE_HOST_UNAVAILABLE, and an older one
189
+ // throws a plain Error with no code. Any other code is the host's answer.
190
+ function transportFailure(error) {
191
+ const code = error?.code;
192
+ return typeof code !== 'string' || code === 'CASTLE_HOST_UNAVAILABLE';
193
+ }
194
+ const RETRY_BUDGET = 180000;
195
+ let retryClock = { now: () => Date.now(), setTimeout, clearTimeout };
196
+ const retryChains = new Set();
197
+
198
+ // A chain holds its read/write slot during backoff as well as during requests.
199
+ // An answered refusal is final; only a thrown failure can be retried.
200
+ function requestWithRetry(operation, request, done, giveUp, retryable = () => true) {
201
+ const clock = retryClock;
202
+ const started = clock.now();
203
+ let failures = 0;
204
+ let timer = null;
205
+ let active = true;
206
+ const cancel = () => {
207
+ active = false;
208
+ if (timer !== null) { clock.clearTimeout(timer); }
209
+ retryChains.delete(cancel);
210
+ };
211
+ retryChains.add(cancel);
212
+ const failed = (error) => {
213
+ if (!active) { return; }
214
+ // Codes/names only: diagnostics must not expose payloads or credentials.
215
+ platform.lastError = typeof error?.code === 'string' ? error.code :
216
+ typeof error?.name === 'string' ? error.name : 'Error';
217
+ if (!retryable(error)) {
218
+ cancel();
219
+ done(null);
220
+ return;
221
+ }
222
+ if (failures === 0) {
223
+ console.warn(`[hub] platform avatar ${operation} failed; retrying:`, platform.lastError);
224
+ }
225
+ const delay = RETRY_DELAYS[Math.min(failures++, RETRY_DELAYS.length - 1)];
226
+ const remaining = RETRY_BUDGET - (clock.now() - started);
227
+ const exhausted = () => {
228
+ cancel();
229
+ console.warn(`[hub] platform avatar ${operation} gave up:`, platform.lastError);
230
+ giveUp();
231
+ };
232
+ if (remaining <= 0) {
233
+ exhausted();
234
+ return;
235
+ }
236
+ timer = clock.setTimeout(() => {
237
+ timer = null;
238
+ if (clock.now() - started >= RETRY_BUDGET) {
239
+ exhausted();
240
+ } else {
241
+ platform.retries += 1;
242
+ attempt();
243
+ }
244
+ }, Math.min(delay, remaining));
245
+ };
246
+ const attempt = () => {
247
+ let result;
248
+ try { result = request(); } catch (error) { failed(error); return; }
249
+ Promise.resolve(result).then((answer) => {
250
+ if (!active) { return; }
251
+ cancel();
252
+ done(answer);
253
+ }, failed);
254
+ };
255
+ attempt();
256
+ }
257
+
258
+ export function diagnostics() {
259
+ return Object.freeze({
260
+ state: platform.state, colors: platform.colors, confirmed: platform.confirmed,
261
+ color: platform.color, desired: platform.desired, retries: platform.retries,
262
+ lastError: platform.lastError,
263
+ });
264
+ }
265
+
59
266
  function usable(avatar) {
60
267
  return Number.isInteger(avatar) && avatar >= 0 && avatar < AVATARS;
61
268
  }
@@ -65,9 +272,14 @@ function usable(avatar) {
65
272
  function standIn(scene) {
66
273
  platform.state = 'none';
67
274
  if (platform.desired !== null && scene) {
68
- (scene.persistent ??= {}).hubAvatar = platform.desired;
275
+ const per = (scene.persistent ??= {});
276
+ per.hubAvatar = platform.desired;
277
+ if (colorsAvailable()) {
278
+ per.hubAvatarColor = platform.desiredColor ?? 0;
279
+ }
69
280
  }
70
281
  platform.desired = null;
282
+ platform.desiredColor = null;
71
283
  }
72
284
 
73
285
  // Starts reading the platform avatar, once per runtime.
@@ -81,20 +293,20 @@ export function load(scene) {
81
293
  return;
82
294
  }
83
295
  platform.state = 'loading';
84
- Avatar.get().then(
296
+ requestWithRetry('read', () => Avatar.get(),
85
297
  (result) => {
86
298
  if (result?.status === 'ok' && usable(result.avatar)) {
87
299
  platform.state = 'ready';
88
300
  platform.confirmed = result.avatar;
301
+ platform.colors = Object.hasOwn(result, 'color') && Avatar.colors === true;
302
+ platform.color = cleanColor(result.color);
89
303
  write(scene);
90
304
  } else {
91
305
  standIn(scene);
92
306
  }
93
307
  },
94
- (error) => {
95
- console.warn('[hub] platform avatar unavailable:', error?.code ?? error);
96
- standIn(scene);
97
- },
308
+ () => standIn(scene),
309
+ transportFailure,
98
310
  );
99
311
  }
100
312
 
@@ -121,10 +333,53 @@ export function choose(scene, index) {
121
333
  return;
122
334
  }
123
335
  if (platform.state === 'none' || !api()) {
124
- (scene.persistent ??= {}).hubAvatar = index;
336
+ const per = (scene.persistent ??= {});
337
+ if (colorsAvailable() && per.hubAvatar !== index) {
338
+ per.hubAvatarColor = 0;
339
+ }
340
+ per.hubAvatar = index;
341
+ return;
342
+ }
343
+ platform.desired = index;
344
+ platform.desiredColor = null;
345
+ write(scene);
346
+ }
347
+
348
+ function cleanColor(color) {
349
+ return Number.isInteger(color) && color >= 0 && color < 16 ? color : 0;
350
+ }
351
+
352
+ export function colorsAvailable() {
353
+ return platform.colors || ((platform.state === 'none' || !api()) && deck.avatarColors === true);
354
+ }
355
+
356
+ export function currentColor(scene) {
357
+ if (!colorsAvailable()) {
358
+ return 0;
359
+ }
360
+ if (platform.desired !== null) {
361
+ return platform.desiredColor ?? 0;
362
+ }
363
+ if (platform.state === 'ready') {
364
+ return platform.color;
365
+ }
366
+ return platform.state === 'none' || !api() ? cleanColor(scene.persistent?.hubAvatarColor) : 0;
367
+ }
368
+
369
+ export function chooseColor(scene, color) {
370
+ if (!colorsAvailable()) {
371
+ return;
372
+ }
373
+ const index = current(scene);
374
+ if (!Number.isInteger(color) || color < 0 || color >= Colors.COLORS || !Colors.AVATAR_COLORS[index]) {
375
+ return;
376
+ }
377
+ if (platform.state === 'none' || !api()) {
378
+ (scene.persistent ??= {}).hubAvatarColor = color;
125
379
  return;
126
380
  }
127
381
  platform.desired = index;
382
+ platform.desiredColor = color;
128
383
  write(scene);
129
384
  }
130
385
 
@@ -139,32 +394,40 @@ function write(scene) {
139
394
  return;
140
395
  }
141
396
  const want = platform.desired;
397
+ const color = platform.desiredColor;
142
398
  platform.writing = want;
143
399
  const done = (result) => {
144
400
  platform.writing = null;
145
401
  if (result?.status === 'ok' && usable(result.avatar)) {
146
402
  platform.confirmed = result.avatar;
403
+ platform.color = cleanColor(result.color);
147
404
  } else if (result?.status === 'unavailable') {
148
405
  // This place may not change it (or the account is gone): the pick stays
149
406
  // this runtime's own.
150
407
  standIn(scene);
151
408
  return;
152
409
  }
153
- if (platform.desired === want) {
410
+ if (platform.desired === want && platform.desiredColor === color) {
154
411
  platform.desired = null;
412
+ platform.desiredColor = null;
155
413
  }
156
414
  write(scene);
157
415
  };
158
- Avatar.set(want).then(done, (error) => {
159
- console.warn('[hub] avatar not saved:', error?.code ?? error);
160
- done(null);
161
- });
416
+ requestWithRetry('write',
417
+ () => color === null ? Avatar.set(want) : Avatar.set(want, { color }),
418
+ done, () => done(null),
419
+ // Host refusals still undo the pick. Transport failures (including plain
420
+ // timeout Errors) leave this exact request queued for another attempt.
421
+ transportFailure,
422
+ );
162
423
  }
163
424
 
164
425
  // Tests only.
165
- export function resetPlatformForTests(api) {
426
+ export function resetPlatformForTests(api, clock) {
427
+ for (const cancel of retryChains) { cancel(); }
428
+ retryClock = clock ?? { now: () => Date.now(), setTimeout, clearTimeout };
166
429
  apiOverride = api;
167
- Object.assign(platform, { state: 'idle', confirmed: null, desired: null, writing: null });
430
+ Object.assign(platform, { state: 'idle', confirmed: null, color: 0, colors: false, desiredColor: null, desired: null, writing: null, retries: 0, lastError: null });
168
431
  }
169
432
 
170
433
  // Tests only: `{ location, experiment, experimentsReady }` in place of the
@@ -254,35 +517,85 @@ export function drawn(files, index, which = style()) {
254
517
  // How tall the avatar stands in a set, or a usual height for one this kit
255
518
  // does not have.
256
519
  export function top(index, which = style()) {
257
- return usable(index) ? TOPS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] : DEFAULT_TOP;
520
+ return usable(index) ? (TOPS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] ?? TOPS[DEFAULT_STYLE][index]) : DEFAULT_TOP;
521
+ }
522
+
523
+ // How a hat sits on the avatar in a set (`HAT_FITS`), or null for one this kit
524
+ // does not have. The same array every time: nothing is made per frame.
525
+ export function hatFit(index, which = style()) {
526
+ return usable(index) ? (HAT_FITS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] ?? HAT_FITS[DEFAULT_STYLE][index]) : null;
527
+ }
528
+
529
+ // Where an earned item sits on the avatar in a set (`EARNED_FITS`), toon's
530
+ // where the set draws the avatar from toon's model (`4`-`15`), or null for one
531
+ // this kit does not have. The same object every time.
532
+ export function earnedFit(index, which = style()) {
533
+ return usable(index) ? (EARNED_FITS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] ?? EARNED_FITS[DEFAULT_STYLE][index]) : null;
258
534
  }
259
535
 
260
536
  // The blueprint other players are drawn from, as a path the live files map
261
537
  // has, or null before the files are known. A set these files do not have is
262
538
  // drawn from toon's.
263
- export function blueprint(files, index, which = style()) {
264
- return find(files, index, which) ?? find(files, index, DEFAULT_STYLE);
539
+ export function blueprint(files, index, which = style(), color = 0) {
540
+ const path = find(files, index, which) ?? find(files, index, DEFAULT_STYLE);
541
+ const c = which === 'toon' ? Colors.known(index, color) : 0;
542
+ if (!path || !c) {
543
+ return path;
544
+ }
545
+ const root = path.slice(0, path.indexOf('blueprints/'));
546
+ const colored = `${root}.colors/avatar-${index}-c${c}.scene`;
547
+ if (typeof files[colored] === 'string') {
548
+ return colored;
549
+ }
550
+ try {
551
+ const copy = JSON.parse(files[path]);
552
+ const model = copy.actors?.[0]?.components?.Model;
553
+ const source = resolveModel(path, model?.file);
554
+ if (typeof files[source] !== 'string') {
555
+ return path;
556
+ }
557
+ const file = `${root}.colors/avatar-${index}-c${c}.pxmodel`;
558
+ const text = Colors.recolored(files[source], index, c);
559
+ model.file = root ? `@${file}` : file;
560
+ files[file] = text;
561
+ files[colored] = JSON.stringify(copy);
562
+ return colored;
563
+ } catch {
564
+ return path;
565
+ }
566
+ }
567
+
568
+ // Blueprint-relative kit files, or an explicit @imports/... live-map key.
569
+ function resolveModel(path, file) {
570
+ if (typeof file !== 'string') {
571
+ return null;
572
+ }
573
+ if (file.startsWith('@')) {
574
+ return file.slice(1);
575
+ }
576
+ return file.startsWith('imports/') || !path.includes('blueprints/') ? file : path.slice(0, path.indexOf('blueprints/')) + file;
265
577
  }
266
578
 
267
579
  // The model the local player wears: the one the avatar's blueprint draws.
268
- export function model(files, index, which = style()) {
269
- const path = blueprint(files, index, which);
580
+ export function model(files, index, which = style(), color = 0) {
581
+ const path = blueprint(files, index, which, color);
270
582
  if (!path) {
271
583
  return null;
272
584
  }
273
585
  try {
274
- const file = JSON.parse(files[path]).actors?.[0]?.components?.Model?.file ?? null;
275
- if (typeof file !== 'string') {
276
- return null;
277
- }
278
- // A blueprint may name an import's file as `@imports/...`; the live files
279
- // map keys it without the `@`. Any other path is the blueprint's own
280
- // deck's: this kit's, wherever it is.
281
- if (file.startsWith('@')) {
282
- return file.slice(1);
283
- }
284
- return file.startsWith('imports/') ? file : path.slice(0, path.indexOf('blueprints/')) + file;
586
+ return resolveModel(path, JSON.parse(files[path]).actors?.[0]?.components?.Model?.file);
285
587
  } catch {
286
588
  return null;
287
589
  }
288
590
  }
591
+
592
+ // The avatar another player is drawn as here: the one the place says they
593
+ // wear, or, for an index this kit does not have (a character of a later kit),
594
+ // one of the first four, the same one every time, so they are never left
595
+ // undrawn. Null for anything that is not an avatar index at all.
596
+ export function known(index) {
597
+ if (usable(index)) {
598
+ return index;
599
+ }
600
+ return Number.isInteger(index) && index >= AVATARS ? index % DEFAULT_AVATARS : null;
601
+ }