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
@@ -0,0 +1,117 @@
1
+ // One client-side lease for every question card in the town's shared ask
2
+ // slot. The server owns each offer; this only decides how long a displayed
3
+ // card remains actionable on this client.
4
+ export const ASK_SLOT_MS = 12_000;
5
+ export const ASK_SLOT_DISTANCE_M = 3;
6
+
7
+ const finiteAt = (at) => at && Number.isFinite(at.x) && Number.isFinite(at.z) ? { x: at.x, z: at.z } : null;
8
+
9
+ export function askSlotKey(ask) {
10
+ if (typeof ask?.slotKey === 'string') {
11
+ return ask.slotKey;
12
+ }
13
+ if (!ask || typeof ask.key !== 'string') {
14
+ return null;
15
+ }
16
+ return ask.key;
17
+ }
18
+
19
+ export function padsAt(scene, at, hidden = new Set()) {
20
+ const point = finiteAt(at);
21
+ if (!point || typeof scene?.getActors !== 'function') {
22
+ return new Set();
23
+ }
24
+ const pads = new Set();
25
+ for (const actor of scene.getActors()) {
26
+ if (hidden.has(actor?.id)) {
27
+ continue;
28
+ }
29
+ const pad = actor?.components?.HubPad;
30
+ const t = actor?.components?.Transform;
31
+ if (!pad || !Number.isFinite(t?.x) || !Number.isFinite(t?.z)) {
32
+ continue;
33
+ }
34
+ const radius = pad.radius ?? actor.components.Shape?.radius ?? 2.3;
35
+ if (Number.isFinite(radius) && radius >= 0 && Math.hypot(point.x - t.x, point.z - t.z) <= radius) {
36
+ pads.add(actor.id);
37
+ }
38
+ }
39
+ return pads;
40
+ }
41
+
42
+ export function makeAskSlot() {
43
+ const shown = new Map();
44
+
45
+ function frame(at, pads, now) {
46
+ const point = finiteAt(at);
47
+ const on = pads instanceof Set ? pads : new Set(pads ?? []);
48
+ for (const record of shown.values()) {
49
+ if (record.expired) {
50
+ continue;
51
+ }
52
+ const enteredPad = [...on].some((id) => !record.pads.has(id));
53
+ if (now - record.shownAt >= ASK_SLOT_MS ||
54
+ (point && record.at && Math.hypot(point.x - record.at.x, point.z - record.at.z) >= ASK_SLOT_DISTANCE_M) ||
55
+ enteredPad) {
56
+ record.expired = true;
57
+ }
58
+ record.pads = new Set(on);
59
+ }
60
+ }
61
+
62
+ function display(ask, at, pads, now) {
63
+ frame(at, pads, now);
64
+ const key = askSlotKey(ask);
65
+ if (!key) {
66
+ return null;
67
+ }
68
+ let record = shown.get(key);
69
+ if (!record) {
70
+ // Each producer can have only one current occurrence. Replacing an
71
+ // occurrence of that kind bounds retention without evicting a still
72
+ // eligible lower-priority kind (for example an expired Your games card
73
+ // hidden by many later invitations).
74
+ for (const [oldKey, old] of shown) {
75
+ if (old.kind === ask.kind) {
76
+ shown.delete(oldKey);
77
+ }
78
+ }
79
+ record = { kind: ask.kind, shownAt: now, at: finiteAt(at), pads: new Set(pads ?? []), expired: false };
80
+ shown.set(key, record);
81
+ }
82
+ return record.expired ? null : ask;
83
+ }
84
+
85
+ function accepts(ask, at, pads, now) {
86
+ frame(at, pads, now);
87
+ const record = shown.get(askSlotKey(ask));
88
+ return Boolean(record && !record.expired);
89
+ }
90
+
91
+ function retire(ask) {
92
+ const record = shown.get(askSlotKey(ask));
93
+ if (record) {
94
+ record.expired = true;
95
+ }
96
+ }
97
+
98
+ function known(ask) {
99
+ return shown.has(askSlotKey(ask));
100
+ }
101
+
102
+ function expired(ask) {
103
+ return shown.get(askSlotKey(ask))?.expired === true;
104
+ }
105
+
106
+ return {
107
+ frame,
108
+ display,
109
+ accepts,
110
+ retire,
111
+ known,
112
+ expired,
113
+ clear() {
114
+ shown.clear();
115
+ },
116
+ };
117
+ }
@@ -99,13 +99,22 @@ export function nameOpacity(d) {
99
99
  // tag changed, the size the multiplayer kit gave it and the width it was
100
100
  // shrunk to, so a tag the multiplayer kit did not resize this frame is not
101
101
  // shrunk twice, and leaving the town puts it back as the multiplayer kit
102
- // drew it.
103
- export function fadeNames(mp, from, town, touched) {
102
+ // drew it. In any hub place (`place`) the player's own tag is not drawn at
103
+ // all (Jesse, Oct 7: no username over your own head); out of one it is
104
+ // shown again.
105
+ export function fadeNames(mp, from, town, touched, place = town) {
104
106
  for (const [key, tag] of mp?.avatars?.tags ?? []) {
105
107
  const sprite = tag?.sprite;
106
108
  if (!sprite) {
107
109
  continue;
108
110
  }
111
+ if (key === 'self' && place) {
112
+ sprite.visible = false;
113
+ if (!touched.has(tag)) {
114
+ touched.set(tag, { own: true });
115
+ }
116
+ continue;
117
+ }
109
118
  if (!town || !from) {
110
119
  const was = touched.get(tag);
111
120
  if (was) {
@@ -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,88 @@ 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
+ // Wrapped, not passed through: browser timers throw "Illegal invocation" when called as a method of another object.
196
+ const realClock = { now: () => Date.now(), setTimeout: (fn, ms) => setTimeout(fn, ms), clearTimeout: (id) => clearTimeout(id) };
197
+ let retryClock = realClock;
198
+ const retryChains = new Set();
199
+
200
+ // A chain holds its read/write slot during backoff as well as during requests.
201
+ // An answered refusal is final; only a thrown failure can be retried.
202
+ function requestWithRetry(operation, request, done, giveUp, retryable = () => true) {
203
+ const clock = retryClock;
204
+ const started = clock.now();
205
+ let failures = 0;
206
+ let timer = null;
207
+ let active = true;
208
+ const cancel = () => {
209
+ active = false;
210
+ if (timer !== null) { clock.clearTimeout(timer); }
211
+ retryChains.delete(cancel);
212
+ };
213
+ retryChains.add(cancel);
214
+ const failed = (error) => {
215
+ if (!active) { return; }
216
+ // Codes/names only: diagnostics must not expose payloads or credentials.
217
+ platform.lastError = typeof error?.code === 'string' ? error.code :
218
+ typeof error?.name === 'string' ? error.name : 'Error';
219
+ if (!retryable(error)) {
220
+ cancel();
221
+ done(null);
222
+ return;
223
+ }
224
+ if (failures === 0) {
225
+ console.warn(`[hub] platform avatar ${operation} failed; retrying:`, platform.lastError);
226
+ }
227
+ const delay = RETRY_DELAYS[Math.min(failures++, RETRY_DELAYS.length - 1)];
228
+ const remaining = RETRY_BUDGET - (clock.now() - started);
229
+ const exhausted = () => {
230
+ cancel();
231
+ console.warn(`[hub] platform avatar ${operation} gave up:`, platform.lastError);
232
+ giveUp();
233
+ };
234
+ if (remaining <= 0) {
235
+ exhausted();
236
+ return;
237
+ }
238
+ timer = clock.setTimeout(() => {
239
+ timer = null;
240
+ if (clock.now() - started >= RETRY_BUDGET) {
241
+ exhausted();
242
+ } else {
243
+ platform.retries += 1;
244
+ attempt();
245
+ }
246
+ }, Math.min(delay, remaining));
247
+ };
248
+ const attempt = () => {
249
+ let result;
250
+ try { result = request(); } catch (error) { failed(error); return; }
251
+ Promise.resolve(result).then((answer) => {
252
+ if (!active) { return; }
253
+ cancel();
254
+ done(answer);
255
+ }, failed);
256
+ };
257
+ attempt();
258
+ }
259
+
260
+ export function diagnostics() {
261
+ return Object.freeze({
262
+ state: platform.state, colors: platform.colors, confirmed: platform.confirmed,
263
+ color: platform.color, desired: platform.desired, retries: platform.retries,
264
+ lastError: platform.lastError,
265
+ });
266
+ }
267
+
92
268
  function usable(avatar) {
93
269
  return Number.isInteger(avatar) && avatar >= 0 && avatar < AVATARS;
94
270
  }
@@ -98,9 +274,14 @@ function usable(avatar) {
98
274
  function standIn(scene) {
99
275
  platform.state = 'none';
100
276
  if (platform.desired !== null && scene) {
101
- (scene.persistent ??= {}).hubAvatar = platform.desired;
277
+ const per = (scene.persistent ??= {});
278
+ per.hubAvatar = platform.desired;
279
+ if (colorsAvailable()) {
280
+ per.hubAvatarColor = platform.desiredColor ?? 0;
281
+ }
102
282
  }
103
283
  platform.desired = null;
284
+ platform.desiredColor = null;
104
285
  }
105
286
 
106
287
  // Starts reading the platform avatar, once per runtime.
@@ -114,20 +295,20 @@ export function load(scene) {
114
295
  return;
115
296
  }
116
297
  platform.state = 'loading';
117
- Avatar.get().then(
298
+ requestWithRetry('read', () => Avatar.get(),
118
299
  (result) => {
119
300
  if (result?.status === 'ok' && usable(result.avatar)) {
120
301
  platform.state = 'ready';
121
302
  platform.confirmed = result.avatar;
303
+ platform.colors = Object.hasOwn(result, 'color') && Avatar.colors === true;
304
+ platform.color = cleanColor(result.color);
122
305
  write(scene);
123
306
  } else {
124
307
  standIn(scene);
125
308
  }
126
309
  },
127
- (error) => {
128
- console.warn('[hub] platform avatar unavailable:', error?.code ?? error);
129
- standIn(scene);
130
- },
310
+ () => standIn(scene),
311
+ transportFailure,
131
312
  );
132
313
  }
133
314
 
@@ -154,10 +335,53 @@ export function choose(scene, index) {
154
335
  return;
155
336
  }
156
337
  if (platform.state === 'none' || !api()) {
157
- (scene.persistent ??= {}).hubAvatar = index;
338
+ const per = (scene.persistent ??= {});
339
+ if (colorsAvailable() && per.hubAvatar !== index) {
340
+ per.hubAvatarColor = 0;
341
+ }
342
+ per.hubAvatar = index;
343
+ return;
344
+ }
345
+ platform.desired = index;
346
+ platform.desiredColor = null;
347
+ write(scene);
348
+ }
349
+
350
+ function cleanColor(color) {
351
+ return Number.isInteger(color) && color >= 0 && color < 16 ? color : 0;
352
+ }
353
+
354
+ export function colorsAvailable() {
355
+ return platform.colors || ((platform.state === 'none' || !api()) && deck.avatarColors === true);
356
+ }
357
+
358
+ export function currentColor(scene) {
359
+ if (!colorsAvailable()) {
360
+ return 0;
361
+ }
362
+ if (platform.desired !== null) {
363
+ return platform.desiredColor ?? 0;
364
+ }
365
+ if (platform.state === 'ready') {
366
+ return platform.color;
367
+ }
368
+ return platform.state === 'none' || !api() ? cleanColor(scene.persistent?.hubAvatarColor) : 0;
369
+ }
370
+
371
+ export function chooseColor(scene, color) {
372
+ if (!colorsAvailable()) {
373
+ return;
374
+ }
375
+ const index = current(scene);
376
+ if (!Number.isInteger(color) || color < 0 || color >= Colors.COLORS || !Colors.AVATAR_COLORS[index]) {
377
+ return;
378
+ }
379
+ if (platform.state === 'none' || !api()) {
380
+ (scene.persistent ??= {}).hubAvatarColor = color;
158
381
  return;
159
382
  }
160
383
  platform.desired = index;
384
+ platform.desiredColor = color;
161
385
  write(scene);
162
386
  }
163
387
 
@@ -172,32 +396,40 @@ function write(scene) {
172
396
  return;
173
397
  }
174
398
  const want = platform.desired;
399
+ const color = platform.desiredColor;
175
400
  platform.writing = want;
176
401
  const done = (result) => {
177
402
  platform.writing = null;
178
403
  if (result?.status === 'ok' && usable(result.avatar)) {
179
404
  platform.confirmed = result.avatar;
405
+ platform.color = cleanColor(result.color);
180
406
  } else if (result?.status === 'unavailable') {
181
407
  // This place may not change it (or the account is gone): the pick stays
182
408
  // this runtime's own.
183
409
  standIn(scene);
184
410
  return;
185
411
  }
186
- if (platform.desired === want) {
412
+ if (platform.desired === want && platform.desiredColor === color) {
187
413
  platform.desired = null;
414
+ platform.desiredColor = null;
188
415
  }
189
416
  write(scene);
190
417
  };
191
- Avatar.set(want).then(done, (error) => {
192
- console.warn('[hub] avatar not saved:', error?.code ?? error);
193
- done(null);
194
- });
418
+ requestWithRetry('write',
419
+ () => color === null ? Avatar.set(want) : Avatar.set(want, { color }),
420
+ done, () => done(null),
421
+ // Host refusals still undo the pick. Transport failures (including plain
422
+ // timeout Errors) leave this exact request queued for another attempt.
423
+ transportFailure,
424
+ );
195
425
  }
196
426
 
197
427
  // Tests only.
198
- export function resetPlatformForTests(api) {
428
+ export function resetPlatformForTests(api, clock) {
429
+ for (const cancel of retryChains) { cancel(); }
430
+ retryClock = clock ?? realClock;
199
431
  apiOverride = api;
200
- Object.assign(platform, { state: 'idle', confirmed: null, desired: null, writing: null });
432
+ Object.assign(platform, { state: 'idle', confirmed: null, color: 0, colors: false, desiredColor: null, desired: null, writing: null, retries: 0, lastError: null });
201
433
  }
202
434
 
203
435
  // Tests only: `{ location, experiment, experimentsReady }` in place of the
@@ -287,41 +519,85 @@ export function drawn(files, index, which = style()) {
287
519
  // How tall the avatar stands in a set, or a usual height for one this kit
288
520
  // does not have.
289
521
  export function top(index, which = style()) {
290
- return usable(index) ? TOPS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] : DEFAULT_TOP;
522
+ return usable(index) ? (TOPS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] ?? TOPS[DEFAULT_STYLE][index]) : DEFAULT_TOP;
291
523
  }
292
524
 
293
525
  // How a hat sits on the avatar in a set (`HAT_FITS`), or null for one this kit
294
526
  // does not have. The same array every time: nothing is made per frame.
295
527
  export function hatFit(index, which = style()) {
296
- return usable(index) ? HAT_FITS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] : null;
528
+ return usable(index) ? (HAT_FITS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] ?? HAT_FITS[DEFAULT_STYLE][index]) : null;
529
+ }
530
+
531
+ // Where an earned item sits on the avatar in a set (`EARNED_FITS`), toon's
532
+ // where the set draws the avatar from toon's model (`4`-`15`), or null for one
533
+ // this kit does not have. The same object every time.
534
+ export function earnedFit(index, which = style()) {
535
+ return usable(index) ? (EARNED_FITS[STYLES.includes(which) ? which : DEFAULT_STYLE][index] ?? EARNED_FITS[DEFAULT_STYLE][index]) : null;
297
536
  }
298
537
 
299
538
  // The blueprint other players are drawn from, as a path the live files map
300
539
  // has, or null before the files are known. A set these files do not have is
301
540
  // drawn from toon's.
302
- export function blueprint(files, index, which = style()) {
303
- return find(files, index, which) ?? find(files, index, DEFAULT_STYLE);
541
+ export function blueprint(files, index, which = style(), color = 0) {
542
+ const path = find(files, index, which) ?? find(files, index, DEFAULT_STYLE);
543
+ const c = which === 'toon' ? Colors.known(index, color) : 0;
544
+ if (!path || !c) {
545
+ return path;
546
+ }
547
+ const root = path.slice(0, path.indexOf('blueprints/'));
548
+ const colored = `${root}.colors/avatar-${index}-c${c}.scene`;
549
+ if (typeof files[colored] === 'string') {
550
+ return colored;
551
+ }
552
+ try {
553
+ const copy = JSON.parse(files[path]);
554
+ const model = copy.actors?.[0]?.components?.Model;
555
+ const source = resolveModel(path, model?.file);
556
+ if (typeof files[source] !== 'string') {
557
+ return path;
558
+ }
559
+ const file = `${root}.colors/avatar-${index}-c${c}.pxmodel`;
560
+ const text = Colors.recolored(files[source], index, c);
561
+ model.file = root ? `@${file}` : file;
562
+ files[file] = text;
563
+ files[colored] = JSON.stringify(copy);
564
+ return colored;
565
+ } catch {
566
+ return path;
567
+ }
568
+ }
569
+
570
+ // Blueprint-relative kit files, or an explicit @imports/... live-map key.
571
+ function resolveModel(path, file) {
572
+ if (typeof file !== 'string') {
573
+ return null;
574
+ }
575
+ if (file.startsWith('@')) {
576
+ return file.slice(1);
577
+ }
578
+ return file.startsWith('imports/') || !path.includes('blueprints/') ? file : path.slice(0, path.indexOf('blueprints/')) + file;
304
579
  }
305
580
 
306
581
  // 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);
582
+ export function model(files, index, which = style(), color = 0) {
583
+ const path = blueprint(files, index, which, color);
309
584
  if (!path) {
310
585
  return null;
311
586
  }
312
587
  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;
588
+ return resolveModel(path, JSON.parse(files[path]).actors?.[0]?.components?.Model?.file);
324
589
  } catch {
325
590
  return null;
326
591
  }
327
592
  }
593
+
594
+ // The avatar another player is drawn as here: the one the place says they
595
+ // wear, or, for an index this kit does not have (a character of a later kit),
596
+ // one of the first four, the same one every time, so they are never left
597
+ // undrawn. Null for anything that is not an avatar index at all.
598
+ export function known(index) {
599
+ if (usable(index)) {
600
+ return index;
601
+ }
602
+ return Number.isInteger(index) && index >= AVATARS ? index % DEFAULT_AVATARS : null;
603
+ }