castle-web-cli 0.4.231 → 0.4.233

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (368) hide show
  1. package/dist/agent-failures.d.ts +8 -0
  2. package/dist/agent-failures.js +19 -2
  3. package/dist/agent-prompts.d.ts +1 -1
  4. package/dist/agent-prompts.js +10 -3
  5. package/dist/agent.d.ts +64 -3
  6. package/dist/agent.js +170 -81
  7. package/dist/castle-host/host.d.ts +1 -0
  8. package/dist/castle-host/host.js +51 -3
  9. package/dist/castleJson.d.ts +4 -2
  10. package/dist/castleJson.js +2 -0
  11. package/dist/check.d.ts +3 -1
  12. package/dist/check.js +11 -1
  13. package/dist/devSessionStorage.js +47 -1
  14. package/dist/importPinMismatch.d.ts +22 -0
  15. package/dist/importPinMismatch.js +77 -0
  16. package/dist/importRegression.js +3 -15
  17. package/dist/imports.d.ts +10 -3
  18. package/dist/imports.js +88 -20
  19. package/dist/index.js +5 -4
  20. package/dist/init.js +1 -1
  21. package/dist/platformDoc.js +22 -0
  22. package/dist/routerFences.d.ts +5 -0
  23. package/dist/routerFences.js +12 -2
  24. package/dist/save-deck.d.ts +5 -0
  25. package/dist/save-deck.js +37 -4
  26. package/dist/serve.js +3 -0
  27. package/dist/serverBundle.js +5 -3
  28. package/dist/shell/assets/{index-D2tWM896.js → index-BjOxR-lW.js} +4 -4
  29. package/dist/shell/assets/index-MVLfNYd9.css +1 -0
  30. package/dist/shell/index.html +2 -2
  31. package/dist/taskSteer.d.ts +13 -0
  32. package/dist/taskSteer.js +22 -2
  33. package/kits/base/castle.json +1 -1
  34. package/kits/base/package-lock.json +1 -1
  35. package/kits/base/sdk/README.md +79 -2
  36. package/kits/base/sdk/avatar.d.ts +6 -2
  37. package/kits/base/sdk/avatar.js +12 -4
  38. package/kits/base/sdk/castle.d.ts +1 -1
  39. package/kits/base/sdk/commands.d.ts +14 -0
  40. package/kits/base/sdk/hub.d.ts +6 -2
  41. package/kits/base/sdk/hub.js +13 -0
  42. package/kits/base/sdk/multiplayer.js +17 -1
  43. package/kits/base/sdk/save.js +2 -1
  44. package/kits/base/sdk/server/hub.d.ts +87 -0
  45. package/kits/base/sdk/server/hub.js +70 -0
  46. package/kits/base/sdk/server/platformHandle.d.ts +31 -1
  47. package/kits/base/sdk/server/storage.d.ts +13 -0
  48. package/kits/base/sdk/server/storage.js +46 -0
  49. package/kits/base/sdk/server/wrapper.d.ts +36 -5
  50. package/kits/base/sdk/server/wrapper.js +83 -8
  51. package/kits/hub-game/CLAUDE.md +352 -12
  52. package/kits/hub-game/blueprints/avatar-10.scene +28 -0
  53. package/kits/hub-game/blueprints/avatar-11.scene +28 -0
  54. package/kits/hub-game/blueprints/avatar-12.scene +28 -0
  55. package/kits/hub-game/blueprints/avatar-13.scene +28 -0
  56. package/kits/hub-game/blueprints/avatar-14.scene +28 -0
  57. package/kits/hub-game/blueprints/avatar-15.scene +28 -0
  58. package/kits/hub-game/blueprints/avatar-4.scene +28 -0
  59. package/kits/hub-game/blueprints/avatar-5.scene +28 -0
  60. package/kits/hub-game/blueprints/avatar-6.scene +28 -0
  61. package/kits/hub-game/blueprints/avatar-7.scene +28 -0
  62. package/kits/hub-game/blueprints/avatar-8.scene +28 -0
  63. package/kits/hub-game/blueprints/avatar-9.scene +28 -0
  64. package/kits/hub-game/code/client/actorBudget.js +47 -0
  65. package/kits/hub-game/code/client/attention.js +11 -2
  66. package/kits/hub-game/code/client/avatar.js +345 -32
  67. package/kits/hub-game/code/client/avatarCap.js +228 -0
  68. package/kits/hub-game/code/client/avatarColors.js +70 -0
  69. package/kits/hub-game/code/client/avatarFaces.js +21 -0
  70. package/kits/hub-game/code/client/avatarShare.js +251 -0
  71. package/kits/hub-game/code/client/ballot.js +467 -0
  72. package/kits/hub-game/code/client/build.js +22 -0
  73. package/kits/hub-game/code/client/chat.js +12 -0
  74. package/kits/hub-game/code/client/chrome.js +1334 -50
  75. package/kits/hub-game/code/client/companion.js +716 -0
  76. package/kits/hub-game/code/client/companionDress.js +99 -0
  77. package/kits/hub-game/code/client/decor.js +509 -0
  78. package/kits/hub-game/code/client/earned.js +131 -0
  79. package/kits/hub-game/code/client/emoteBubble.js +75 -0
  80. package/kits/hub-game/code/client/grab.js +363 -20
  81. package/kits/hub-game/code/client/hats.js +26 -0
  82. package/kits/hub-game/code/client/hookLayer.js +328 -15
  83. package/kits/hub-game/code/client/hudClear.js +126 -0
  84. package/kits/hub-game/code/client/idle.js +163 -22
  85. package/kits/hub-game/code/client/interestCap.js +81 -0
  86. package/kits/hub-game/code/client/keys.js +36 -0
  87. package/kits/hub-game/code/client/labelsNear.js +205 -0
  88. package/kits/hub-game/code/client/menuIcons.js +34 -0
  89. package/kits/hub-game/code/client/pack.js +6 -2
  90. package/kits/hub-game/code/client/packFormat.js +3 -3
  91. package/kits/hub-game/code/client/rehello.js +167 -0
  92. package/kits/hub-game/code/client/shot.js +92 -0
  93. package/kits/hub-game/code/client/sound.js +63 -8
  94. package/kits/hub-game/code/client/soundscape.js +1151 -0
  95. package/kits/hub-game/code/client/soundscapeActions.js +99 -0
  96. package/kits/hub-game/code/client/soundscapeAmbience.js +453 -0
  97. package/kits/hub-game/code/client/soundscapeBaked.js +143 -0
  98. package/kits/hub-game/code/client/soundscapeBusker.js +217 -0
  99. package/kits/hub-game/code/client/soundscapeCourt.js +200 -0
  100. package/kits/hub-game/code/client/soundscapeCrowd.js +331 -0
  101. package/kits/hub-game/code/client/soundscapeCues.js +362 -0
  102. package/kits/hub-game/code/client/soundscapeMap.js +181 -0
  103. package/kits/hub-game/code/client/soundscapeMarket.js +176 -0
  104. package/kits/hub-game/code/client/soundscapeMusic.js +126 -0
  105. package/kits/hub-game/code/client/soundscapeMusicEngine.js +460 -0
  106. package/kits/hub-game/code/client/soundscapeSimlish.js +737 -0
  107. package/kits/hub-game/code/client/soundscapeSongs.js +127 -0
  108. package/kits/hub-game/code/client/soundscapeSongsRound3.js +63 -0
  109. package/kits/hub-game/code/client/soundscapeSynthesis.js +168 -0
  110. package/kits/hub-game/code/client/soundscapeUi.js +211 -0
  111. package/kits/hub-game/code/client/soundscapeVoice.js +1209 -0
  112. package/kits/hub-game/code/client/soundscapeWaves.js +206 -0
  113. package/kits/hub-game/code/client/spin.js +101 -0
  114. package/kits/hub-game/code/client/state.js +131 -1
  115. package/kits/hub-game/code/client/stuck.js +259 -0
  116. package/kits/hub-game/code/client/talk.js +538 -47
  117. package/kits/hub-game/code/client/tiers.js +541 -27
  118. package/kits/hub-game/code/client/toastBand.js +37 -0
  119. package/kits/hub-game/code/client/together.js +98 -1
  120. package/kits/hub-game/code/client/visibility.js +43 -0
  121. package/kits/hub-game/code/client/wear.js +470 -97
  122. package/kits/hub-game/code/client/yours.js +199 -0
  123. package/kits/hub-game/code/companionSpec.js +45 -0
  124. package/kits/hub-game/code/privateText.js +7 -0
  125. package/kits/hub-game/code/server/actions.js +133 -0
  126. package/kits/hub-game/code/server/actors.js +14 -1
  127. package/kits/hub-game/code/server/ask.js +155 -0
  128. package/kits/hub-game/code/server/ballot.js +539 -0
  129. package/kits/hub-game/code/server/cells.js +100 -0
  130. package/kits/hub-game/code/server/companion.js +82 -0
  131. package/kits/hub-game/code/server/cues.js +70 -0
  132. package/kits/hub-game/code/server/decor.js +269 -0
  133. package/kits/hub-game/code/server/earned.js +461 -0
  134. package/kits/hub-game/code/server/friendBests.js +166 -0
  135. package/kits/hub-game/code/server/friendsAmong.js +232 -0
  136. package/kits/hub-game/code/server/grab.js +296 -11
  137. package/kits/hub-game/code/server/history.js +5 -0
  138. package/kits/hub-game/code/server/hub.js +1317 -52
  139. package/kits/hub-game/code/server/idle.js +30 -11
  140. package/kits/hub-game/code/server/index.js +2 -2
  141. package/kits/hub-game/code/server/labels.js +28 -2
  142. package/kits/hub-game/code/server/manifest.js +424 -8
  143. package/kits/hub-game/code/server/menu.js +133 -0
  144. package/kits/hub-game/code/server/npcs.js +830 -80
  145. package/kits/hub-game/code/server/party.js +13 -2
  146. package/kits/hub-game/code/server/players.js +22 -0
  147. package/kits/hub-game/code/server/say.js +8 -2
  148. package/kits/hub-game/code/server/shot.js +110 -0
  149. package/kits/hub-game/code/server/standing.js +124 -0
  150. package/kits/hub-game/code/server/vis.js +113 -0
  151. package/kits/hub-game/code/server/wear.js +128 -11
  152. package/kits/hub-game/code/server/yours.js +59 -0
  153. package/kits/hub-game/code/shared/cues.js +9 -0
  154. package/kits/hub-game/code/shared/decor.js +41 -0
  155. package/kits/hub-game/code/shared/shot.js +19 -0
  156. package/kits/hub-game/code/shared/spin.js +57 -0
  157. package/kits/hub-game/code/systems/hub.js +1083 -85
  158. package/kits/hub-game/docs/content-pack.md +1 -1
  159. package/kits/hub-game/docs/contract.md +2440 -61
  160. package/kits/hub-game/docs/home-pieces.md +64 -0
  161. package/kits/hub-game/models/avatar-10.pxmodel +28 -0
  162. package/kits/hub-game/models/avatar-11.pxmodel +28 -0
  163. package/kits/hub-game/models/avatar-12.pxmodel +27 -0
  164. package/kits/hub-game/models/avatar-13.pxmodel +24 -0
  165. package/kits/hub-game/models/avatar-14.pxmodel +29 -0
  166. package/kits/hub-game/models/avatar-15.pxmodel +24 -0
  167. package/kits/hub-game/models/avatar-4.pxmodel +29 -0
  168. package/kits/hub-game/models/avatar-5.pxmodel +27 -0
  169. package/kits/hub-game/models/avatar-6.pxmodel +26 -0
  170. package/kits/hub-game/models/avatar-7.pxmodel +25 -0
  171. package/kits/hub-game/models/avatar-8.pxmodel +24 -0
  172. package/kits/hub-game/models/avatar-9.pxmodel +30 -0
  173. package/kits/hub-game/models/earned/badge-round.pxmodel +100 -0
  174. package/kits/hub-game/models/earned/badge-shield.pxmodel +117 -0
  175. package/kits/hub-game/models/earned/badge-star.pxmodel +87 -0
  176. package/kits/hub-game/models/earned/belt-plain.pxmodel +72 -0
  177. package/kits/hub-game/models/earned/held-ball.pxmodel +43 -0
  178. package/kits/hub-game/models/earned/held-lantern.pxmodel +85 -0
  179. package/kits/hub-game/models/earned/held-net.pxmodel +57 -0
  180. package/kits/hub-game/models/earned/held-trophy.pxmodel +109 -0
  181. package/kits/hub-game/models/earned/pin-round.pxmodel +62 -0
  182. package/kits/hub-game/models/earned/sash-plain.pxmodel +66 -0
  183. package/kits/hub-game/models/earned/square/belt-plain.pxmodel +104 -0
  184. package/kits/hub-game/models/earned/square/sash-plain.pxmodel +98 -0
  185. package/kits/hub-game/models/hats/bat-clip.pxmodel +206 -0
  186. package/kits/hub-game/models/hats/beekeeper.pxmodel +149 -0
  187. package/kits/hub-game/models/hats/cap.pxmodel +162 -0
  188. package/kits/hub-game/models/hats/captain.pxmodel +178 -0
  189. package/kits/hub-game/models/hats/crooked-top.pxmodel +172 -0
  190. package/kits/hub-game/models/hats/flower-crown.pxmodel +451 -0
  191. package/kits/hub-game/models/hats/foam-crown.pxmodel +179 -0
  192. package/kits/hub-game/models/hats/lantern.pxmodel +230 -0
  193. package/kits/hub-game/models/hats/laurel.pxmodel +533 -0
  194. package/kits/hub-game/models/hats/lighthouse.pxmodel +96 -0
  195. package/kits/hub-game/models/hats/sailor.pxmodel +141 -0
  196. package/kits/hub-game/models/hats/souwester.pxmodel +131 -0
  197. package/kits/hub-game/models/hats/straw.pxmodel +139 -0
  198. package/kits/hub-game/models/hats/sunflower.pxmodel +406 -0
  199. package/kits/hub-game/models/hats/sweatband.pxmodel +112 -0
  200. package/kits/hub-game/models/hats/witch.pxmodel +147 -0
  201. package/kits/hub-game/package-lock.json +2 -0
  202. package/kits/hub-game/package.json +2 -1
  203. package/kits/hub-game/scripts/check.mjs +78 -11
  204. package/kits/hub-game/scripts/companion-follower-wire.json +1 -0
  205. package/kits/hub-game/scripts/fixtures/decor-keyless-draw.json +121 -0
  206. package/kits/hub-game/scripts/fixtures/decor-keyless.json +293 -0
  207. package/kits/hub-game/scripts/fixtures/engine-models-stub.mjs +23 -0
  208. package/kits/hub-game/scripts/fixtures/fake-dom.mjs +107 -0
  209. package/kits/hub-game/scripts/fixtures/interest-legacy.json +385 -0
  210. package/kits/hub-game/scripts/fixtures/npc-notes-v1.77.jsonl +4 -0
  211. package/kits/hub-game/scripts/fixtures/vis-shared-wire.json +1 -0
  212. package/kits/hub-game/scripts/gen-avatars.mjs +933 -16
  213. package/kits/hub-game/scripts/gen-earned.mjs +285 -0
  214. package/kits/hub-game/scripts/gen-hats.mjs +827 -0
  215. package/kits/hub-game/scripts/grab.before-orbit.mjs +400 -0
  216. package/kits/hub-game/scripts/soundscape-wave-analysis.mjs +125 -0
  217. package/kits/hub-game/scripts/test-actions-client.mjs +488 -0
  218. package/kits/hub-game/scripts/test-actions.mjs +298 -0
  219. package/kits/hub-game/scripts/test-actor-budget.mjs +44 -0
  220. package/kits/hub-game/scripts/test-actors.mjs +19 -17
  221. package/kits/hub-game/scripts/test-ask-client.mjs +358 -0
  222. package/kits/hub-game/scripts/test-ask.mjs +269 -0
  223. package/kits/hub-game/scripts/test-attention.mjs +10 -1
  224. package/kits/hub-game/scripts/test-avatar-cap.mjs +379 -0
  225. package/kits/hub-game/scripts/test-avatar-colors.mjs +72 -0
  226. package/kits/hub-game/scripts/test-avatar-models.mjs +181 -0
  227. package/kits/hub-game/scripts/test-avatar-share.mjs +318 -0
  228. package/kits/hub-game/scripts/test-avatar-wire.mjs +753 -0
  229. package/kits/hub-game/scripts/test-avatar.mjs +540 -7
  230. package/kits/hub-game/scripts/test-ballot.mjs +1001 -0
  231. package/kits/hub-game/scripts/test-build.mjs +31 -0
  232. package/kits/hub-game/scripts/test-cells.mjs +71 -0
  233. package/kits/hub-game/scripts/test-chat.mjs +694 -0
  234. package/kits/hub-game/scripts/test-classic.mjs +2 -0
  235. package/kits/hub-game/scripts/test-companion-chat.mjs +198 -0
  236. package/kits/hub-game/scripts/test-companion-client.mjs +1167 -0
  237. package/kits/hub-game/scripts/test-companion.mjs +259 -0
  238. package/kits/hub-game/scripts/test-decor-client.mjs +303 -0
  239. package/kits/hub-game/scripts/test-decor.mjs +457 -0
  240. package/kits/hub-game/scripts/test-earned-client.mjs +459 -0
  241. package/kits/hub-game/scripts/test-earned.mjs +1194 -0
  242. package/kits/hub-game/scripts/test-emote-bubble.mjs +110 -0
  243. package/kits/hub-game/scripts/test-friend-bests.mjs +435 -0
  244. package/kits/hub-game/scripts/test-grab-client.mjs +186 -3
  245. package/kits/hub-game/scripts/test-grab-orbit.mjs +918 -0
  246. package/kits/hub-game/scripts/test-grab.mjs +864 -3
  247. package/kits/hub-game/scripts/test-hats.mjs +483 -0
  248. package/kits/hub-game/scripts/test-hub-leaving.mjs +203 -0
  249. package/kits/hub-game/scripts/test-hub-ops.mjs +439 -2
  250. package/kits/hub-game/scripts/test-hub-trip.mjs +1228 -1
  251. package/kits/hub-game/scripts/test-hud-clear.mjs +1000 -0
  252. package/kits/hub-game/scripts/test-idle.mjs +361 -1
  253. package/kits/hub-game/scripts/test-interest-cap.mjs +36 -0
  254. package/kits/hub-game/scripts/test-interest-cells.mjs +493 -0
  255. package/kits/hub-game/scripts/test-interest-client.mjs +118 -0
  256. package/kits/hub-game/scripts/test-keys.mjs +46 -1
  257. package/kits/hub-game/scripts/test-labels.mjs +596 -0
  258. package/kits/hub-game/scripts/test-manifest.mjs +282 -0
  259. package/kits/hub-game/scripts/test-menu-client.mjs +480 -0
  260. package/kits/hub-game/scripts/test-menu.mjs +296 -0
  261. package/kits/hub-game/scripts/test-npcs.mjs +1718 -12
  262. package/kits/hub-game/scripts/test-object-entry.mjs +76 -0
  263. package/kits/hub-game/scripts/test-pack.mjs +7 -0
  264. package/kits/hub-game/scripts/test-party.mjs +22 -1
  265. package/kits/hub-game/scripts/test-picker.mjs +314 -0
  266. package/kits/hub-game/scripts/test-rehello.mjs +1039 -0
  267. package/kits/hub-game/scripts/test-relations-among.mjs +222 -0
  268. package/kits/hub-game/scripts/test-relations-refresh.mjs +188 -0
  269. package/kits/hub-game/scripts/test-say.mjs +59 -2
  270. package/kits/hub-game/scripts/test-shot.mjs +756 -0
  271. package/kits/hub-game/scripts/test-soundscape.mjs +5432 -0
  272. package/kits/hub-game/scripts/test-spin.mjs +314 -0
  273. package/kits/hub-game/scripts/test-standing.mjs +416 -0
  274. package/kits/hub-game/scripts/test-stuck.mjs +1903 -0
  275. package/kits/hub-game/scripts/test-tier-cells.mjs +706 -0
  276. package/kits/hub-game/scripts/test-tiers-render.mjs +339 -0
  277. package/kits/hub-game/scripts/test-tiers.mjs +666 -3
  278. package/kits/hub-game/scripts/test-toast-band.mjs +61 -0
  279. package/kits/hub-game/scripts/test-try-on.mjs +940 -0
  280. package/kits/hub-game/scripts/test-vis.mjs +343 -0
  281. package/kits/hub-game/scripts/test-visibility.mjs +134 -0
  282. package/kits/hub-game/scripts/test-yours-chrome.mjs +166 -0
  283. package/kits/hub-game/scripts/test-yours.mjs +372 -0
  284. package/kits/multiplayer-3d/CLAUDE.md +50 -0
  285. package/kits/multiplayer-3d/castle.json +5 -5
  286. package/kits/multiplayer-3d/code/client/avatars.js +7 -0
  287. package/kits/multiplayer-3d/code/client/gait.js +65 -0
  288. package/kits/multiplayer-3d/code/client/nameTags.js +59 -4
  289. package/kits/multiplayer-3d/code/options.js +5 -0
  290. package/kits/multiplayer-3d/code/server/ownership.js +10 -2
  291. package/kits/multiplayer-3d/code/server/sceneBodies.js +12 -0
  292. package/kits/multiplayer-3d/code/server/world.js +7 -0
  293. package/kits/multiplayer-3d/code/systems/multiplayer.js +74 -4
  294. package/kits/multiplayer-3d/package.json +2 -1
  295. package/kits/multiplayer-3d/scripts/fixtures/README.md +11 -0
  296. package/kits/multiplayer-3d/scripts/fixtures/ownership-legacy.json +2 -0
  297. package/kits/multiplayer-3d/scripts/ownership-harness.mjs +102 -0
  298. package/kits/multiplayer-3d/scripts/ownership-loader.mjs +46 -0
  299. package/kits/multiplayer-3d/scripts/ownership-worker.mjs +15 -0
  300. package/kits/multiplayer-3d/scripts/record-ownership-session.mjs +98 -0
  301. package/kits/multiplayer-3d/scripts/test-eligible-claims.mjs +167 -0
  302. package/kits/multiplayer-3d/scripts/test-own-name-tag.mjs +247 -0
  303. package/kits/physics-2d/CLAUDE.md +9 -0
  304. package/kits/physics-2d/castle.json +2 -2
  305. package/kits/physics-2d/engine/scene.js +288 -1
  306. package/kits/physics-2d/engine/skyKey.js +129 -0
  307. package/kits/physics-2d/engine/stillClock.js +106 -0
  308. package/kits/physics-2d/engine/updateBudget.js +21 -0
  309. package/kits/physics-2d/scripts/test-skip-unchanged.mjs +370 -1
  310. package/kits/physics-3d/CLAUDE.md +1391 -0
  311. package/kits/physics-3d/behaviors/Player.jsx +921 -3
  312. package/kits/physics-3d/castle.json +3 -3
  313. package/kits/physics-3d/docs/pxmodel-format.md +12 -0
  314. package/kits/physics-3d/engine3d/Scene3DPlayer.jsx +98 -10
  315. package/kits/physics-3d/engine3d/actornode.js +86 -0
  316. package/kits/physics-3d/engine3d/animationBudget.js +23 -0
  317. package/kits/physics-3d/engine3d/editorWorld.js +6 -0
  318. package/kits/physics-3d/engine3d/emptynodes.js +232 -0
  319. package/kits/physics-3d/engine3d/framecap.js +96 -0
  320. package/kits/physics-3d/engine3d/gait.js +118 -0
  321. package/kits/physics-3d/engine3d/kithooks.js +47 -0
  322. package/kits/physics-3d/engine3d/look.js +507 -48
  323. package/kits/physics-3d/engine3d/lookbake.js +208 -0
  324. package/kits/physics-3d/engine3d/materialpresets.js +2 -0
  325. package/kits/physics-3d/engine3d/motion.js +39 -10
  326. package/kits/physics-3d/engine3d/nearshadows.js +37 -19
  327. package/kits/physics-3d/engine3d/optimize.js +58 -5
  328. package/kits/physics-3d/engine3d/orbitinput.js +755 -0
  329. package/kits/physics-3d/engine3d/orbitlens.js +48 -0
  330. package/kits/physics-3d/engine3d/ownmodel.js +213 -0
  331. package/kits/physics-3d/engine3d/pxmodel.js +42 -11
  332. package/kits/physics-3d/engine3d/shadowfade.js +882 -0
  333. package/kits/physics-3d/engine3d/sky.js +547 -0
  334. package/kits/physics-3d/engine3d/skylife.js +306 -0
  335. package/kits/physics-3d/engine3d/unchanged.js +11 -0
  336. package/kits/physics-3d/engine3d/viewrange.js +52 -0
  337. package/kits/physics-3d/engine3d/world3d.js +870 -87
  338. package/kits/physics-3d/main.jsx +5 -0
  339. package/kits/physics-3d/package.json +1 -1
  340. package/kits/physics-3d/scripts/Player.before-orbit.mjs +310 -0
  341. package/kits/physics-3d/scripts/Scene3DPlayer.before-orbit.jsx +337 -0
  342. package/kits/physics-3d/scripts/look-baseline.mjs +155 -0
  343. package/kits/physics-3d/scripts/test-camera-follow.mjs +12 -2
  344. package/kits/physics-3d/scripts/test-camera-orbit.mjs +4588 -0
  345. package/kits/physics-3d/scripts/test-drop-empty-parts.mjs +787 -0
  346. package/kits/physics-3d/scripts/test-frame-cap-bob.mjs +435 -0
  347. package/kits/physics-3d/scripts/test-frame-cap.mjs +452 -0
  348. package/kits/physics-3d/scripts/test-gait.mjs +387 -0
  349. package/kits/physics-3d/scripts/test-look-bake.mjs +1056 -0
  350. package/kits/physics-3d/scripts/test-model-parse-cache.mjs +92 -0
  351. package/kits/physics-3d/scripts/test-near-shadows.mjs +3 -0
  352. package/kits/physics-3d/scripts/test-orbit-shadow-fade.mjs +1920 -0
  353. package/kits/physics-3d/scripts/test-orbit-shift-lock.mjs +545 -0
  354. package/kits/physics-3d/scripts/test-orbit-shot.mjs +583 -0
  355. package/kits/physics-3d/scripts/test-orbit-view.mjs +230 -0
  356. package/kits/physics-3d/scripts/test-skip-empty-nodes.mjs +845 -0
  357. package/kits/physics-3d/scripts/test-sky.mjs +2470 -0
  358. package/kits/physics-3d/scripts/test-static-actors.mjs +13 -1
  359. package/kits/physics-3d/scripts/test-static-passes.mjs +1 -1
  360. package/kits/physics-3d/scripts/test-static-scenery.mjs +2171 -0
  361. package/kits/physics-3d/scripts/test-steady-hover.mjs +635 -0
  362. package/kits/physics-3d/scripts/test-view-range.mjs +260 -0
  363. package/kits/physics-3d/systems/physics3d.js +474 -12
  364. package/kits/real-time/castle.json +2 -2
  365. package/kits/real-time/code/server/gameHooks.js +7 -0
  366. package/kits/real-time/code/server/session.js +97 -19
  367. package/package.json +2 -2
  368. package/dist/shell/assets/index-Cf61cNfT.css +0 -1
@@ -0,0 +1,285 @@
1
+ // `node scripts/gen-earned.mjs`: writes the earned items a hub game may give
2
+ // (contract §11 v1.53, `code/client/earned.js` `EARNED_SHAPES`) to
3
+ // `models/earned/<shape>.pxmodel`.
4
+ //
5
+ // Each is modelled about where it is worn (`avatar.js` `EARNED_FITS` puts it
6
+ // there), +z the way the wearer faces and +x their left:
7
+ // badge, pin y = 0 at its middle, z = 0 its back, on the body's front
8
+ // belt, sash round the middle of a ring 0.2 m from its middle (stretched
9
+ // to the body; a sash is tilted to the right shoulder by its
10
+ // fit), and a square one for a boxy body (`SQUARE`)
11
+ // held y = 0 the grip, the middle of the right hand at the side:
12
+ // what shows is clear of a hand 0.1 m round it
13
+ // Each is drawn with the avatars' own look (a dark outline), small, at most
14
+ // about 400 triangles. Its main materials are written in `EARNED_MAIN`, which
15
+ // the client replaces with the item's colour (`earned.js` `tinted`); trims are
16
+ // any other colour and stay. `badge-round` is the glow badge: its main colour
17
+ // glows a little. Every badge's soft glow behind it is the client's
18
+ // (`wear.js`), not the model's: a model's disc has a hard edge.
19
+ import * as fs from 'node:fs';
20
+ import * as path from 'node:path';
21
+ import { fileURLToPath } from 'node:url';
22
+ import { EARNED_MAIN, EARNED_SHAPES } from '../code/client/earned.js';
23
+
24
+ const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
25
+ const OUT = path.join(ROOT, 'models', 'earned');
26
+
27
+ const MAIN = EARNED_MAIN;
28
+ const GOLD = '#e3c35a';
29
+ const SILVER = '#c9ccd6';
30
+ const WHITE = '#ffffff';
31
+ const WOOD = '#9a6b3c';
32
+ const INK = '#2b2b33';
33
+ const LOOK = { outline: 0.012, outlineColor: '#241a2e', rim: 0.3, ao: 0.4 };
34
+ const r3 = (n) => Math.round(n * 1000) / 1000;
35
+ const DEG = Math.PI / 180;
36
+
37
+ // A flat disc facing +z, its back at `z`.
38
+ const disc = (id, radius, depth, z, color, extra = {}) => ({
39
+ id,
40
+ kind: 'cylinder',
41
+ radius,
42
+ height: depth,
43
+ position: [0, 0, r3(z + depth / 2)],
44
+ rotation: [90, 0, 0],
45
+ color,
46
+ segments: 16,
47
+ ...extra,
48
+ });
49
+ // A ring in the x-y plane, facing +z.
50
+ const rim = (id, radius, tube, z, color, extra = {}) => ({
51
+ id,
52
+ kind: 'torus',
53
+ radius,
54
+ tube,
55
+ position: [0, 0, z],
56
+ color,
57
+ segments: 20,
58
+ ...extra,
59
+ });
60
+ // A flat outline facing +z, its back at `z`.
61
+ const plate = (id, outline, depth, z, color, extra = {}) => ({
62
+ id,
63
+ kind: 'extrude',
64
+ outline,
65
+ depth,
66
+ bevel: 0.004,
67
+ position: [0, 0, r3(z + depth / 2 + 0.004)],
68
+ color,
69
+ ...extra,
70
+ });
71
+ const star = (outer, inner, n = 5) =>
72
+ Array.from({ length: n * 2 }, (_, i) => {
73
+ const a = (i / (n * 2)) * Math.PI * 2 + Math.PI / 2;
74
+ const r = i % 2 ? inner : outer;
75
+ return [r3(Math.cos(a) * r), r3(Math.sin(a) * r)];
76
+ });
77
+ const shield = (w, h) => [
78
+ [-w, h * 0.5],
79
+ [w, h * 0.5],
80
+ [w, -h * 0.05],
81
+ [w * 0.6, -h * 0.35],
82
+ [0, -h * 0.5],
83
+ [-w * 0.6, -h * 0.35],
84
+ [-w, -h * 0.05],
85
+ ];
86
+ // A band round the 0.2 m ring, `high` tall.
87
+ const band = (id, high, color, extra = {}) => ({
88
+ id,
89
+ kind: 'lathe',
90
+ segments: 24,
91
+ profile: [
92
+ [0.2, -high / 2],
93
+ [0.214, -high / 2 + 0.006],
94
+ [0.216, 0],
95
+ [0.214, high / 2 - 0.006],
96
+ [0.2, high / 2],
97
+ ],
98
+ color,
99
+ ...extra,
100
+ });
101
+
102
+ // A gold buckle on the front of a band, `z` out from the middle.
103
+ const buckle = (z) => [
104
+ { id: 'buckle', kind: 'box', size: [0.072, 0.058, 0.014], round: 0.006, position: [0, 0, z], color: GOLD },
105
+ { id: 'hole', kind: 'box', size: [0.042, 0.03, 0.01], position: [0, 0, r3(z + 0.004)], color: MAIN },
106
+ ];
107
+ // A point on the ring `r` from its middle, `deg` round from the wearer's left.
108
+ const ringPoint = (r, deg) => [r3(Math.cos(deg * DEG) * r), 0, r3(Math.sin(deg * DEG) * r)];
109
+ // A gold rosette with a knot of the item's colour, facing out at `at`.
110
+ const rosette = (at) => [
111
+ { id: 'rosette', kind: 'torus', radius: 0.03, tube: 0.012, position: at, color: GOLD, segments: 12 },
112
+ { id: 'knot', kind: 'sphere', radius: 0.02, position: at, color: MAIN, segments: 8 },
113
+ ];
114
+
115
+ const SHAPES = {
116
+ // The glow badge: a round badge in the item's colour, glowing a little, a
117
+ // gold rim and a white star.
118
+ 'badge-round': () => [
119
+ disc('face', 0.056, 0.016, 0, MAIN, { emissive: MAIN, emissiveIntensity: 0.8, segments: 16 }),
120
+ rim('rim', 0.056, 0.007, 0.012, GOLD, { segments: 12 }),
121
+ plate('star', star(0.026, 0.011), 0.006, 0.016, WHITE),
122
+ ],
123
+ // A five-point star with a gold boss.
124
+ 'badge-star': () => [
125
+ plate('star', star(0.066, 0.03), 0.016, 0, MAIN, { emissive: MAIN, emissiveIntensity: 0.5 }),
126
+ disc('boss', 0.018, 0.008, 0.016, GOLD, { segments: 12 }),
127
+ ],
128
+ // A shield with a white band across it and a gold edge at the top.
129
+ 'badge-shield': () => [
130
+ plate('shield', shield(0.05, 0.12), 0.016, 0, MAIN, { emissive: MAIN, emissiveIntensity: 0.5 }),
131
+ plate('stripe', [[-0.05, 0.01], [0.05, 0.01], [0.05, -0.012], [-0.05, -0.012]], 0.006, 0.016, WHITE),
132
+ plate('top', [[-0.05, 0.06], [0.05, 0.06], [0.05, 0.048], [-0.05, 0.048]], 0.006, 0.016, GOLD),
133
+ ],
134
+ // A small enamel pin: a silver rim round its colour.
135
+ 'pin-round': () => [
136
+ disc('face', 0.032, 0.012, 0, MAIN, { segments: 16 }),
137
+ rim('rim', 0.032, 0.005, 0.01, SILVER, { segments: 10 }),
138
+ disc('dot', 0.01, 0.006, 0.012, WHITE, { segments: 8 }),
139
+ ],
140
+ // A plain belt with a gold buckle at the front.
141
+ 'belt-plain': () => [band('belt', 0.05, MAIN), ...buckle(0.222)],
142
+ // A sash: a band round the body, tilted by its fit (`avatar.js`) to run
143
+ // from the right shoulder to the left hip, a gold rosette on the hip.
144
+ 'sash-plain': () => [band('sash', 0.085, MAIN), ...rosette(ringPoint(0.222, 50))],
145
+ // A lantern hanging from the hand: its handle in the grip, a lit glass
146
+ // between two frames of its colour under the hand.
147
+ 'held-lantern': () => [
148
+ {
149
+ id: 'handle',
150
+ kind: 'torus',
151
+ radius: 0.05,
152
+ tube: 0.008,
153
+ position: [0, -0.03, 0],
154
+ rotation: [0, 90, 0],
155
+ color: INK,
156
+ segments: 12,
157
+ },
158
+ { id: 'roof', kind: 'cone', radius: 0.078, height: 0.04, position: [0, -0.095, 0], color: MAIN, segments: 12 },
159
+ { id: 'top', kind: 'cylinder', radius: 0.07, height: 0.02, position: [0, -0.12, 0], color: MAIN, segments: 12 },
160
+ {
161
+ id: 'glass',
162
+ kind: 'cylinder',
163
+ radius: 0.056,
164
+ height: 0.07,
165
+ position: [0, -0.163, 0],
166
+ color: '#ffe9a3',
167
+ emissive: '#ffd24a',
168
+ emissiveIntensity: 0.8,
169
+ segments: 12,
170
+ },
171
+ { id: 'base', kind: 'cylinder', radius: 0.07, height: 0.022, position: [0, -0.205, 0], color: MAIN, segments: 12 },
172
+ ],
173
+ // A cup held up by its stem: the cup and handles in its colour, a silver
174
+ // stem in the grip and a dark base under the hand. Held a little out in
175
+ // front, so the cup stands clear of a thick arm (blocky's) above the hand.
176
+ 'held-trophy': () => [
177
+ { id: 'base', kind: 'box', size: [0.1, 0.035, 0.1], round: 0.008, position: [0, -0.125, 0.09], color: INK },
178
+ { id: 'stem', kind: 'cylinder', radius: 0.02, height: 0.22, position: [0, 0, 0.09], color: SILVER, segments: 10 },
179
+ {
180
+ id: 'cup',
181
+ kind: 'lathe',
182
+ segments: 14,
183
+ position: [0, 0, 0.09],
184
+ profile: [
185
+ [0, 0.1],
186
+ [0.04, 0.105],
187
+ [0.075, 0.145],
188
+ [0.088, 0.232],
189
+ [0.08, 0.24],
190
+ [0.066, 0.155],
191
+ [0, 0.137],
192
+ ],
193
+ color: MAIN,
194
+ },
195
+ ...[1, -1].map((side) => ({
196
+ id: side > 0 ? 'handleL' : 'handleR',
197
+ kind: 'torus',
198
+ radius: 0.034,
199
+ tube: 0.009,
200
+ position: [r3(side * 0.09), 0.185, 0.09],
201
+ color: MAIN,
202
+ segments: 8,
203
+ })),
204
+ ],
205
+ // A net on a wooden pole held upright a little out in front, the hoop in
206
+ // its colour facing out beside it, a white net behind.
207
+ 'held-net': () => [
208
+ { id: 'pole', kind: 'cylinder', radius: 0.014, height: 0.5, position: [0, 0.05, 0.07], color: WOOD, segments: 8 },
209
+ {
210
+ id: 'hoop',
211
+ kind: 'torus',
212
+ radius: 0.08,
213
+ tube: 0.011,
214
+ position: [-0.08, 0.3, 0.07],
215
+ color: MAIN,
216
+ segments: 16,
217
+ },
218
+ {
219
+ id: 'net',
220
+ kind: 'cone',
221
+ radius: 0.075,
222
+ height: 0.13,
223
+ position: [-0.08, 0.3, 0.005],
224
+ rotation: [-90, 0, 0],
225
+ color: '#f4efe6',
226
+ segments: 12,
227
+ },
228
+ ],
229
+ // A ball held in the hand, in front of it, a white stripe round it.
230
+ 'held-ball': () => [
231
+ { id: 'ball', kind: 'sphere', radius: 0.12, position: [-0.03, -0.03, 0.1], color: MAIN, segments: 13 },
232
+ {
233
+ id: 'stripe',
234
+ kind: 'torus',
235
+ radius: 0.119,
236
+ tube: 0.012,
237
+ position: [-0.03, -0.03, 0.1],
238
+ rotation: [0, 90, 0],
239
+ color: WHITE,
240
+ segments: 16,
241
+ },
242
+ ],
243
+ };
244
+
245
+ // The square variants of the ring shapes, for a boxy body (blocky, pixel:
246
+ // `avatar.js` fits with `square`): the same band as four flat sides round a
247
+ // square 0.2 m from its middle, so it lies flat on a box instead of cutting
248
+ // through its corners. `models/earned/square/<shape>.pxmodel`.
249
+ const sideBand = (id, high, color) => {
250
+ const t = 0.016;
251
+ const w = 0.2 + t;
252
+ return [
253
+ { id: `${id}F`, kind: 'box', size: [2 * w, high, t], position: [0, 0, 0.2 + t / 2], color },
254
+ { id: `${id}B`, kind: 'box', size: [2 * w, high, t], position: [0, 0, -0.2 - t / 2], color },
255
+ { id: `${id}L`, kind: 'box', size: [t, high, 2 * w], position: [0.2 + t / 2, 0, 0], color },
256
+ { id: `${id}R`, kind: 'box', size: [t, high, 2 * w], position: [-0.2 - t / 2, 0, 0], color },
257
+ ];
258
+ };
259
+
260
+ export const SQUARE = {
261
+ 'belt-plain': () => [...sideBand('belt', 0.05, MAIN), ...buckle(0.222)],
262
+ 'sash-plain': () => [...sideBand('sash', 0.085, MAIN), ...rosette([0.12, 0, 0.222])],
263
+ };
264
+
265
+ export function earnedModel(shape, square = false) {
266
+ const parts = square ? SQUARE[shape]() : SHAPES[shape]();
267
+ return { format: 'pxmodel', name: square ? `${shape}-square` : shape, triangles: 400, look: LOOK, parts };
268
+ }
269
+
270
+ export const SHAPE_IDS = Object.keys(SHAPES);
271
+
272
+ if (process.argv[1] === fileURLToPath(import.meta.url)) {
273
+ if (SHAPE_IDS.join() !== EARNED_SHAPES.join()) {
274
+ throw new Error('gen-earned.mjs and earned.js EARNED_SHAPES list different shapes');
275
+ }
276
+ fs.mkdirSync(OUT, { recursive: true });
277
+ for (const shape of SHAPE_IDS) {
278
+ fs.writeFileSync(path.join(OUT, `${shape}.pxmodel`), `${JSON.stringify(earnedModel(shape), null, 1)}\n`);
279
+ }
280
+ fs.mkdirSync(path.join(OUT, 'square'), { recursive: true });
281
+ for (const shape of Object.keys(SQUARE)) {
282
+ fs.writeFileSync(path.join(OUT, 'square', `${shape}.pxmodel`), `${JSON.stringify(earnedModel(shape, true), null, 1)}\n`);
283
+ }
284
+ console.log(`wrote ${SHAPE_IDS.length} earned items and ${Object.keys(SQUARE).length} square ones to ${path.relative(process.cwd(), OUT)}`);
285
+ }