castle-web-cli 0.4.232 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (355) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  28. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  29. package/dist/shell/index.html +2 -2
  30. package/dist/taskSteer.d.ts +13 -0
  31. package/dist/taskSteer.js +22 -2
  32. package/kits/base/castle.json +1 -1
  33. package/kits/base/package-lock.json +1 -1
  34. package/kits/base/sdk/README.md +79 -2
  35. package/kits/base/sdk/avatar.d.ts +6 -2
  36. package/kits/base/sdk/avatar.js +12 -4
  37. package/kits/base/sdk/castle.d.ts +1 -1
  38. package/kits/base/sdk/commands.d.ts +14 -0
  39. package/kits/base/sdk/hub.d.ts +6 -2
  40. package/kits/base/sdk/hub.js +13 -0
  41. package/kits/base/sdk/multiplayer.js +17 -1
  42. package/kits/base/sdk/save.js +2 -1
  43. package/kits/base/sdk/server/hub.d.ts +87 -0
  44. package/kits/base/sdk/server/hub.js +70 -0
  45. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  46. package/kits/base/sdk/server/storage.d.ts +13 -0
  47. package/kits/base/sdk/server/storage.js +46 -0
  48. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  49. package/kits/base/sdk/server/wrapper.js +83 -8
  50. package/kits/hub-game/CLAUDE.md +329 -11
  51. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  52. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  63. package/kits/hub-game/code/client/actorBudget.js +47 -0
  64. package/kits/hub-game/code/client/attention.js +11 -2
  65. package/kits/hub-game/code/client/avatar.js +309 -35
  66. package/kits/hub-game/code/client/avatarCap.js +228 -0
  67. package/kits/hub-game/code/client/avatarColors.js +70 -0
  68. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  69. package/kits/hub-game/code/client/avatarShare.js +251 -0
  70. package/kits/hub-game/code/client/ballot.js +467 -0
  71. package/kits/hub-game/code/client/build.js +22 -0
  72. package/kits/hub-game/code/client/chrome.js +1144 -50
  73. package/kits/hub-game/code/client/companion.js +716 -0
  74. package/kits/hub-game/code/client/companionDress.js +99 -0
  75. package/kits/hub-game/code/client/decor.js +509 -0
  76. package/kits/hub-game/code/client/earned.js +131 -0
  77. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  78. package/kits/hub-game/code/client/grab.js +339 -20
  79. package/kits/hub-game/code/client/hookLayer.js +299 -13
  80. package/kits/hub-game/code/client/idle.js +163 -22
  81. package/kits/hub-game/code/client/interestCap.js +81 -0
  82. package/kits/hub-game/code/client/keys.js +36 -0
  83. package/kits/hub-game/code/client/labelsNear.js +205 -0
  84. package/kits/hub-game/code/client/menuIcons.js +34 -0
  85. package/kits/hub-game/code/client/pack.js +6 -2
  86. package/kits/hub-game/code/client/packFormat.js +3 -3
  87. package/kits/hub-game/code/client/rehello.js +167 -0
  88. package/kits/hub-game/code/client/shot.js +92 -0
  89. package/kits/hub-game/code/client/sound.js +63 -8
  90. package/kits/hub-game/code/client/soundscape.js +1151 -0
  91. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  92. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  93. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  94. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  95. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  96. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  97. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  98. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  99. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  100. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  101. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  102. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  103. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  104. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  105. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  106. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  107. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  108. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  109. package/kits/hub-game/code/client/spin.js +101 -0
  110. package/kits/hub-game/code/client/state.js +109 -1
  111. package/kits/hub-game/code/client/stuck.js +259 -0
  112. package/kits/hub-game/code/client/talk.js +538 -47
  113. package/kits/hub-game/code/client/tiers.js +516 -27
  114. package/kits/hub-game/code/client/toastBand.js +37 -0
  115. package/kits/hub-game/code/client/together.js +32 -0
  116. package/kits/hub-game/code/client/visibility.js +43 -0
  117. package/kits/hub-game/code/client/wear.js +461 -170
  118. package/kits/hub-game/code/client/yours.js +199 -0
  119. package/kits/hub-game/code/companionSpec.js +45 -0
  120. package/kits/hub-game/code/privateText.js +7 -0
  121. package/kits/hub-game/code/server/actions.js +133 -0
  122. package/kits/hub-game/code/server/actors.js +9 -1
  123. package/kits/hub-game/code/server/ask.js +155 -0
  124. package/kits/hub-game/code/server/ballot.js +539 -0
  125. package/kits/hub-game/code/server/cells.js +100 -0
  126. package/kits/hub-game/code/server/companion.js +82 -0
  127. package/kits/hub-game/code/server/cues.js +70 -0
  128. package/kits/hub-game/code/server/decor.js +269 -0
  129. package/kits/hub-game/code/server/earned.js +461 -0
  130. package/kits/hub-game/code/server/friendBests.js +166 -0
  131. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  132. package/kits/hub-game/code/server/history.js +5 -0
  133. package/kits/hub-game/code/server/hub.js +1254 -50
  134. package/kits/hub-game/code/server/idle.js +30 -11
  135. package/kits/hub-game/code/server/index.js +2 -2
  136. package/kits/hub-game/code/server/labels.js +28 -2
  137. package/kits/hub-game/code/server/manifest.js +378 -7
  138. package/kits/hub-game/code/server/menu.js +133 -0
  139. package/kits/hub-game/code/server/npcs.js +830 -80
  140. package/kits/hub-game/code/server/party.js +2 -2
  141. package/kits/hub-game/code/server/players.js +22 -0
  142. package/kits/hub-game/code/server/shot.js +110 -0
  143. package/kits/hub-game/code/server/standing.js +124 -0
  144. package/kits/hub-game/code/server/vis.js +113 -0
  145. package/kits/hub-game/code/server/wear.js +12 -0
  146. package/kits/hub-game/code/server/yours.js +59 -0
  147. package/kits/hub-game/code/shared/cues.js +9 -0
  148. package/kits/hub-game/code/shared/decor.js +41 -0
  149. package/kits/hub-game/code/shared/shot.js +19 -0
  150. package/kits/hub-game/code/shared/spin.js +57 -0
  151. package/kits/hub-game/code/systems/hub.js +845 -95
  152. package/kits/hub-game/docs/content-pack.md +1 -1
  153. package/kits/hub-game/docs/contract.md +2244 -61
  154. package/kits/hub-game/docs/home-pieces.md +64 -0
  155. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  156. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  157. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  158. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  159. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  160. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  161. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  162. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  163. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  164. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  165. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  166. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  167. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  168. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  169. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  170. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  171. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  172. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  173. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  174. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  175. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  176. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  177. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  178. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  179. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  180. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  181. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  182. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  183. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  184. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  185. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  186. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  187. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  188. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  189. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  190. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  191. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  192. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  193. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  194. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  195. package/kits/hub-game/package-lock.json +2 -0
  196. package/kits/hub-game/package.json +2 -1
  197. package/kits/hub-game/scripts/check.mjs +78 -11
  198. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  199. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  200. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  201. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  202. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  203. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  204. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  205. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  206. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  207. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  208. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  209. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  210. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  211. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  212. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  213. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  214. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  215. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  216. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  217. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  218. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  219. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  220. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  221. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  222. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  223. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  224. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  225. package/kits/hub-game/scripts/test-build.mjs +31 -0
  226. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  227. package/kits/hub-game/scripts/test-chat.mjs +662 -0
  228. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  229. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  230. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  231. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  232. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  233. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  234. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  235. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  236. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  237. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  238. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  239. package/kits/hub-game/scripts/test-grab.mjs +7 -0
  240. package/kits/hub-game/scripts/test-hats.mjs +422 -168
  241. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  242. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  243. package/kits/hub-game/scripts/test-hub-trip.mjs +716 -2
  244. package/kits/hub-game/scripts/test-hud-clear.mjs +328 -4
  245. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  246. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  247. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  248. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  249. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  250. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  251. package/kits/hub-game/scripts/test-manifest.mjs +207 -0
  252. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  253. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  254. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  255. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  256. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  257. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  258. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  259. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  260. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  261. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  262. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  263. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  264. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  265. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  266. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  267. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  268. package/kits/hub-game/scripts/test-tiers.mjs +477 -2
  269. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  270. package/kits/hub-game/scripts/test-try-on.mjs +22 -22
  271. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  272. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  273. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  274. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  275. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  276. package/kits/multiplayer-3d/castle.json +5 -5
  277. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  278. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  279. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  280. package/kits/multiplayer-3d/code/options.js +5 -0
  281. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  282. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  283. package/kits/multiplayer-3d/code/server/world.js +7 -0
  284. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  285. package/kits/multiplayer-3d/package.json +2 -1
  286. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  287. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  288. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  289. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  290. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  291. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  292. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  293. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  294. package/kits/physics-2d/CLAUDE.md +9 -0
  295. package/kits/physics-2d/castle.json +2 -2
  296. package/kits/physics-2d/engine/scene.js +253 -1
  297. package/kits/physics-2d/engine/skyKey.js +129 -0
  298. package/kits/physics-2d/engine/stillClock.js +106 -0
  299. package/kits/physics-2d/engine/updateBudget.js +21 -0
  300. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +326 -1
  301. package/kits/physics-3d/CLAUDE.md +1169 -30
  302. package/kits/physics-3d/behaviors/Player.jsx +629 -72
  303. package/kits/physics-3d/castle.json +3 -3
  304. package/kits/physics-3d/docs/pxmodel-format.md +8 -0
  305. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +69 -13
  306. package/kits/physics-3d/engine3d/actornode.js +86 -0
  307. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  308. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  309. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  310. package/kits/physics-3d/engine3d/framecap.js +96 -0
  311. package/kits/physics-3d/engine3d/gait.js +118 -0
  312. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  313. package/kits/physics-3d/engine3d/look.js +507 -48
  314. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  315. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  316. package/kits/physics-3d/engine3d/motion.js +39 -10
  317. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  318. package/kits/physics-3d/engine3d/optimize.js +9 -5
  319. package/kits/physics-3d/engine3d/orbitinput.js +487 -9
  320. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  321. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  322. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  323. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  324. package/kits/physics-3d/engine3d/sky.js +547 -0
  325. package/kits/physics-3d/engine3d/skylife.js +306 -0
  326. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  327. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  328. package/kits/physics-3d/engine3d/world3d.js +796 -69
  329. package/kits/physics-3d/main.jsx +5 -0
  330. package/kits/physics-3d/package.json +1 -1
  331. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  332. package/kits/physics-3d/scripts/test-camera-orbit.mjs +2563 -80
  333. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +1 -1
  334. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  335. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  336. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  337. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  338. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  339. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  340. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  341. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  342. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  343. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  344. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  345. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  346. package/kits/physics-3d/scripts/test-static-actors.mjs +8 -1
  347. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  348. package/kits/physics-3d/scripts/test-steady-hover.mjs +2 -0
  349. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  350. package/kits/physics-3d/systems/physics3d.js +383 -6
  351. package/kits/real-time/castle.json +2 -2
  352. package/kits/real-time/code/server/gameHooks.js +7 -0
  353. package/kits/real-time/code/server/session.js +97 -19
  354. package/package.json +2 -2
  355. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -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,7 +34,7 @@ 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],
@@ -43,8 +51,20 @@ const HAT_FITS = {
43
51
  toon: [
44
52
  [1.27, 1.3, 0.08],
45
53
  [1.21, 1.1, 0.07],
46
- [1.18, 1.1, 0.08],
47
- [1.43, 0.6, 0.06],
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],
48
68
  ],
49
69
  blocky: [
50
70
  [1.39, 1.1, 0.04],
@@ -66,6 +86,74 @@ const HAT_FITS = {
66
86
  ],
67
87
  };
68
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
+
69
157
  // Where the kit's blueprints are: inside the import in a deck, at the root
70
158
  // while this kit is served as itself.
71
159
  const ROOTS = ['imports/castle.hub-game/', ''];
@@ -77,10 +165,16 @@ const platform = {
77
165
  state: 'idle',
78
166
  // The avatar ghost last confirmed.
79
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,
80
172
  // The player's latest pick, until ghost has it or refused it; worn meanwhile.
81
173
  desired: null,
82
174
  // The pick being written; one write at a time, so answers cannot cross.
83
175
  writing: null,
176
+ retries: 0,
177
+ lastError: null,
84
178
  };
85
179
 
86
180
  // The SDK's Avatar, or null on an SDK from before it. Tests swap it.
@@ -89,6 +183,86 @@ function api() {
89
183
  return apiOverride !== undefined ? apiOverride : (castleSdk.Avatar ?? null);
90
184
  }
91
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
+
92
266
  function usable(avatar) {
93
267
  return Number.isInteger(avatar) && avatar >= 0 && avatar < AVATARS;
94
268
  }
@@ -98,9 +272,14 @@ function usable(avatar) {
98
272
  function standIn(scene) {
99
273
  platform.state = 'none';
100
274
  if (platform.desired !== null && scene) {
101
- (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
+ }
102
280
  }
103
281
  platform.desired = null;
282
+ platform.desiredColor = null;
104
283
  }
105
284
 
106
285
  // Starts reading the platform avatar, once per runtime.
@@ -114,20 +293,20 @@ export function load(scene) {
114
293
  return;
115
294
  }
116
295
  platform.state = 'loading';
117
- Avatar.get().then(
296
+ requestWithRetry('read', () => Avatar.get(),
118
297
  (result) => {
119
298
  if (result?.status === 'ok' && usable(result.avatar)) {
120
299
  platform.state = 'ready';
121
300
  platform.confirmed = result.avatar;
301
+ platform.colors = Object.hasOwn(result, 'color') && Avatar.colors === true;
302
+ platform.color = cleanColor(result.color);
122
303
  write(scene);
123
304
  } else {
124
305
  standIn(scene);
125
306
  }
126
307
  },
127
- (error) => {
128
- console.warn('[hub] platform avatar unavailable:', error?.code ?? error);
129
- standIn(scene);
130
- },
308
+ () => standIn(scene),
309
+ transportFailure,
131
310
  );
132
311
  }
133
312
 
@@ -154,10 +333,53 @@ export function choose(scene, index) {
154
333
  return;
155
334
  }
156
335
  if (platform.state === 'none' || !api()) {
157
- (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;
158
379
  return;
159
380
  }
160
381
  platform.desired = index;
382
+ platform.desiredColor = color;
161
383
  write(scene);
162
384
  }
163
385
 
@@ -172,32 +394,40 @@ function write(scene) {
172
394
  return;
173
395
  }
174
396
  const want = platform.desired;
397
+ const color = platform.desiredColor;
175
398
  platform.writing = want;
176
399
  const done = (result) => {
177
400
  platform.writing = null;
178
401
  if (result?.status === 'ok' && usable(result.avatar)) {
179
402
  platform.confirmed = result.avatar;
403
+ platform.color = cleanColor(result.color);
180
404
  } else if (result?.status === 'unavailable') {
181
405
  // This place may not change it (or the account is gone): the pick stays
182
406
  // this runtime's own.
183
407
  standIn(scene);
184
408
  return;
185
409
  }
186
- if (platform.desired === want) {
410
+ if (platform.desired === want && platform.desiredColor === color) {
187
411
  platform.desired = null;
412
+ platform.desiredColor = null;
188
413
  }
189
414
  write(scene);
190
415
  };
191
- Avatar.set(want).then(done, (error) => {
192
- console.warn('[hub] avatar not saved:', error?.code ?? error);
193
- done(null);
194
- });
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
+ );
195
423
  }
196
424
 
197
425
  // Tests only.
198
- 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 };
199
429
  apiOverride = api;
200
- 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 });
201
431
  }
202
432
 
203
433
  // Tests only: `{ location, experiment, experimentsReady }` in place of the
@@ -287,41 +517,85 @@ export function drawn(files, index, which = style()) {
287
517
  // How tall the avatar stands in a set, or a usual height for one this kit
288
518
  // does not have.
289
519
  export function top(index, which = style()) {
290
- 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;
291
521
  }
292
522
 
293
523
  // How a hat sits on the avatar in a set (`HAT_FITS`), or null for one this kit
294
524
  // does not have. The same array every time: nothing is made per frame.
295
525
  export function hatFit(index, which = style()) {
296
- return usable(index) ? HAT_FITS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] : null;
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;
297
534
  }
298
535
 
299
536
  // The blueprint other players are drawn from, as a path the live files map
300
537
  // has, or null before the files are known. A set these files do not have is
301
538
  // drawn from toon's.
302
- export function blueprint(files, index, which = style()) {
303
- 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;
304
577
  }
305
578
 
306
579
  // The model the local player wears: the one the avatar's blueprint draws.
307
- export function model(files, index, which = style()) {
308
- const path = blueprint(files, index, which);
580
+ export function model(files, index, which = style(), color = 0) {
581
+ const path = blueprint(files, index, which, color);
309
582
  if (!path) {
310
583
  return null;
311
584
  }
312
585
  try {
313
- const file = JSON.parse(files[path]).actors?.[0]?.components?.Model?.file ?? null;
314
- if (typeof file !== 'string') {
315
- return null;
316
- }
317
- // A blueprint may name an import's file as `@imports/...`; the live files
318
- // map keys it without the `@`. Any other path is the blueprint's own
319
- // deck's: this kit's, wherever it is.
320
- if (file.startsWith('@')) {
321
- return file.slice(1);
322
- }
323
- 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);
324
587
  } catch {
325
588
  return null;
326
589
  }
327
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
+ }