create-threenative 0.2.5 → 0.2.7

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 (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,72 +1,129 @@
1
1
  import type { ICtx } from "@threenative/core";
2
- import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
3
- import type { Mesh, Vector3 } from "three";
4
- import { CRATE_LAYER, CRATE_MASK, type PuzzlePhysics } from "../physics.js";
5
- import { CRATE_SIZE, crate as crateMesh } from "../render/shapes.js";
2
+ import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
+ import { type Material, Mesh, type Quaternion, Vector3 } from "three";
4
+ import { CRATE_SIZE, crateGeometry } from "../render/crateShape.js";
6
5
  import type { GameState } from "../state.js";
7
6
 
8
- type GameCtx = ICtx<GameState, PuzzlePhysics>;
9
-
10
- const CARRY_HEIGHT = 1.15;
11
- const CARRY_BLEND = 12;
7
+ /**
8
+ * The two kinds of body in the vault.
9
+ *
10
+ * `solid` crates occupy the default collision layer, so the warden's capsule scans them and is
11
+ * stopped by them. `phase` crates occupy a layer the warden's mask does not include, so they are
12
+ * simulated against the floor and against each other exactly like the solid ones — they fall,
13
+ * stack and are shoved by a solid crate — while the warden's own sweep never sees them.
14
+ *
15
+ * The distinction is a collision layer, not a sensor: a sensor collider would also stop colliding
16
+ * with the crates around it, and a phase crate that fell through the floor would not read as
17
+ * "walk through me", it would read as broken.
18
+ */
19
+ export type CrateKind = "phase" | "solid";
12
20
 
13
21
  /**
14
- * A box the player can pick up, carry and set down.
22
+ * Three layers, and the third one is the reason this is not two.
23
+ *
24
+ * 1 — solid crates and the warden. 2 — the room: floor, walls. 4 — the ward.
15
25
  *
16
- * Carrying is a velocity, not a teleport. Snapping a dynamic body to the claw each frame makes it
17
- * pass through walls and pop the solver; steering its velocity toward the carry point keeps every
18
- * contact the room has honest, which is the whole point of a physics puzzle.
26
+ * The ward has to fall, stack on itself and rest on the floor, so it cannot be a sensor; and it
27
+ * has to be transparent to *everything the player can move*, not only to the warden. A ward that
28
+ * blocked crates while letting the warden through produced a dead level: the warden shoved a crate
29
+ * north, the crate wedged against the ward, and the warden — already touching that crate — could
30
+ * not advance a single millimetre toward the seal. `playerZ` was bit-identical to its spawn value
31
+ * after two hundred ticks of held input, which reads exactly like an input binding that never
32
+ * arrived.
19
33
  */
34
+ export const SOLID_LAYER = 1;
35
+ export const WORLD_LAYER = 2;
36
+ export const PHASE_LAYER = 4;
37
+ /** Solid crates scan other solid crates, the warden, and the room. Never the ward. */
38
+ export const SOLID_MASK = SOLID_LAYER | WORLD_LAYER;
39
+ /** The ward scans the room and itself, and nothing else in the vault. */
40
+ export const PHASE_MASK = WORLD_LAYER | PHASE_LAYER;
41
+ /** What the warden scans: solid crates and the room. */
42
+ export const WARDEN_MASK = SOLID_LAYER | WORLD_LAYER;
43
+
44
+ export interface ICrateOptions {
45
+ /** Names the body for the runner's physics cohort — `settled` matches on this prefix. */
46
+ readonly entity: string;
47
+ readonly kind?: CrateKind;
48
+ /** Restores a full orientation — the replay check rebuilds crates from captured poses. */
49
+ readonly quaternion?: Quaternion;
50
+ readonly rotationY?: number;
51
+ readonly x: number;
52
+ readonly y: number;
53
+ readonly z: number;
54
+ }
55
+
20
56
  export class Crate {
21
57
  readonly mesh: Mesh;
22
58
  readonly body: RigidBody3D;
23
- #held = false;
59
+ readonly kind: CrateKind;
60
+ /** Where it was authored, before the opening drop. */
61
+ readonly spawn: Vector3;
62
+ /** Where the drop left it, filled in once the vault has settled. */
63
+ readonly rest = new Vector3();
24
64
 
25
65
  constructor(
26
- ctx: GameCtx,
27
- position: Vector3,
28
- readonly id: string,
66
+ ctx: ICtx<GameState, IPhysicsContext>,
67
+ material: Material | readonly Material[],
68
+ options: ICrateOptions,
29
69
  ) {
30
- this.mesh = crateMesh();
31
- this.mesh.position.copy(position);
70
+ this.kind = options.kind ?? "solid";
71
+ this.mesh = new Mesh(crateGeometry(), material as Material | Material[]);
72
+ this.mesh.position.set(options.x, options.y, options.z);
73
+ if (options.quaternion === undefined) this.mesh.rotation.y = options.rotationY ?? 0;
74
+ else this.mesh.quaternion.copy(options.quaternion);
75
+ this.mesh.castShadow = true;
76
+ this.mesh.receiveShadow = true;
77
+ this.spawn = this.mesh.position.clone();
78
+ this.rest.copy(this.spawn);
32
79
  ctx.add(this.mesh);
33
80
  this.body = new RigidBody3D({
34
- collisionLayer: CRATE_LAYER,
35
- collisionMask: CRATE_MASK,
36
- entity: `crate.${id}`,
37
- mass: 14,
81
+ // A box shape, not `fromMesh`: the merged brace planks would become a convex hull a
82
+ // centimetre proud of the crate on every face, and a stack of those never sits flush.
83
+ collisionLayer: this.kind === "phase" ? PHASE_LAYER : SOLID_LAYER,
84
+ collisionMask: this.kind === "phase" ? PHASE_MASK : SOLID_MASK,
85
+ // Without a name every body is reported as `physics.body.<n>`, and a `settled` assertion can
86
+ // only address the whole world — which always contains the walls and the floor, and those
87
+ // never sleep. Naming the crates is what makes "the crates came to rest" assertable.
88
+ entity: options.entity,
89
+ // Light, and measured rather than chosen. At 6 kg the warden shoving a crate crossed 2.5 m
90
+ // in 3.3 s instead of 11; at 2.5 kg, six. Rapier bounds a character's push by the
91
+ // character's own mass and no option here exposes it, so the crate is what has to give.
92
+ mass: 1.2,
38
93
  object: this.mesh,
39
94
  physics: ctx.physics,
40
95
  shape: CollisionShape3D.box(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE),
41
96
  });
42
97
  }
43
98
 
44
- get held(): boolean {
45
- return this.#held;
99
+ get speed(): number {
100
+ const velocity = this.body.linearVelocity;
101
+ return Math.hypot(velocity.x, velocity.y, velocity.z);
46
102
  }
47
103
 
48
- hold(): void {
49
- this.#held = true;
104
+ /** Metres from where the opening drop left it. Zero until `markRest` has run. */
105
+ displacement(): number {
106
+ return this.mesh.position.distanceTo(this.rest);
50
107
  }
51
108
 
52
- /** Lets go, keeping whatever velocity the carry gave it — a shove is a legitimate solution. */
53
- release(): void {
54
- this.#held = false;
55
- }
56
-
57
- carry(target: Vector3, dt: number): void {
58
- if (!this.#held) return;
59
- const blend = Math.min(1, Math.max(0, dt) * CARRY_BLEND);
60
- const position = this.mesh.position;
61
- this.body.linearVelocity = {
62
- x: ((target.x - position.x) / Math.max(dt, 1 / 240)) * blend,
63
- y: ((target.y + CARRY_HEIGHT - position.y) / Math.max(dt, 1 / 240)) * blend,
64
- z: ((target.z - position.z) / Math.max(dt, 1 / 240)) * blend,
65
- };
109
+ /**
110
+ * Put this body back at a pose without destroying it.
111
+ *
112
+ * `RigidBody3D` has no `teleport` — `CharacterBody3D` does — so the only documented way to move
113
+ * a dynamic body is an impulse or a force, and neither can place one. `syncToPhysics()` is
114
+ * undocumented but is the one member that could plausibly push the object's transform back into
115
+ * the backend, which is what this needs: destroying and recreating forty-four bodies instead
116
+ * changes the order the backend hands out handles, and that alone moved the pile by centimetres.
117
+ */
118
+ reset(position: Vector3, quaternion: Quaternion): void {
119
+ this.mesh.position.copy(position);
120
+ this.mesh.quaternion.copy(quaternion);
121
+ this.body.linearVelocity = { x: 0, y: 0, z: 0 };
122
+ this.body.syncToPhysics();
66
123
  }
67
124
 
68
- debug(): Record<string, unknown> {
69
- return { held: this.#held, position: this.mesh.position.toArray() };
125
+ markRest(): void {
126
+ this.rest.copy(this.mesh.position);
70
127
  }
71
128
 
72
129
  dispose(): void {
@@ -0,0 +1,69 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import {
3
+ Area3D,
4
+ CollisionShape3D,
5
+ type IPhysicsContext,
6
+ type PhysicsBody3D,
7
+ } from "@threenative/physics";
8
+ import type { Object3D } from "three";
9
+ import { SEAL } from "../render/vault.js";
10
+ import type { GameState } from "../state.js";
11
+
12
+ /**
13
+ * The way out, and the only thing in the game that can end the run.
14
+ *
15
+ * It is an `Area3D` and nothing else: the run ends when the physics backend reports that a body
16
+ * has *overlapped* this volume — the warden's capsule, or a crate the warden shoved into it. No
17
+ * distance check, no timer, no "close enough". If the solver never reports contact the run never
18
+ * ends, which is the point: a proximity test would pass on a warden standing on the far side of a
19
+ * crate it could not actually move.
20
+ */
21
+ export class Seal {
22
+ readonly area: Area3D;
23
+ /** The lit floor plate, so a scenario can ask whether the destination is on screen. */
24
+ readonly mesh: Object3D;
25
+ #contacts = 0;
26
+
27
+ constructor(ctx: ICtx<GameState, IPhysicsContext>, mesh: Object3D) {
28
+ this.mesh = mesh;
29
+ this.area = new Area3D({
30
+ entity: "seal",
31
+ physics: ctx.physics,
32
+ // Lifted clear of the floor slab: an area whose underside sits on y = 0 overlaps the fixed
33
+ // floor body from the first step, and the run reports itself won before anything moves.
34
+ position: { x: SEAL.x, y: 0.78, z: SEAL.z },
35
+ // Tall enough that a crate resting on the plate counts, shallow enough that a crate sailing
36
+ // over the kerb without stopping does not linger in it.
37
+ shape: CollisionShape3D.box(SEAL.half * 2, 1.2, SEAL.half * 2),
38
+ });
39
+ }
40
+
41
+ /**
42
+ * Register the two things that can trip it. Returns an unsubscribe for the scene's `exit`.
43
+ *
44
+ * The area hands back the physics node itself, so "was that the warden" is an identity check
45
+ * against the node the scene already holds — not an id lookup, and not a name.
46
+ */
47
+ watch(handlers: {
48
+ readonly isCrate: (body: PhysicsBody3D) => boolean;
49
+ readonly warden: PhysicsBody3D;
50
+ readonly onContact: (by: "crate" | "warden") => void;
51
+ }): () => void {
52
+ return this.area.on("bodyEntered", (body) => {
53
+ const by = body === handlers.warden ? "warden" : handlers.isCrate(body) ? "crate" : undefined;
54
+ // Walls and the floor slab overlap this volume too. Only the two things the brief allows to
55
+ // end the run are counted, and anything else is not even recorded as a contact.
56
+ if (by === undefined) return;
57
+ this.#contacts += 1;
58
+ handlers.onContact(by);
59
+ });
60
+ }
61
+
62
+ get contacts(): number {
63
+ return this.#contacts;
64
+ }
65
+
66
+ dispose(): void {
67
+ this.area.dispose();
68
+ }
69
+ }
@@ -0,0 +1,135 @@
1
+ import type { ICtx } from "@threenative/core";
2
+ import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
+ import { Group, Vector3 } from "three";
4
+ import { wardenFigure } from "../render/warden.js";
5
+ import type { GameState } from "../state.js";
6
+ import { WARDEN_MASK } from "./Crate.js";
7
+
8
+ type GameCtx = ICtx<GameState, IPhysicsContext>;
9
+
10
+ const MOVE_SPEED = 4.5;
11
+ /** Capsule: total height 2 * (halfHeight + radius) = 1.12 m, centred on the body origin. */
12
+ const CAPSULE_HALF_HEIGHT = 0.28;
13
+ const CAPSULE_RADIUS = 0.28;
14
+ /** How far the solver has to fall short of the asked-for step before it counts as blocked. */
15
+ const BLOCKED_FRACTION = 0.45;
16
+
17
+ export const WARDEN_SPAWN = { x: -4.2, y: 0.62, z: 2.35 } as const;
18
+
19
+ /**
20
+ * The controlled character: a capsule that pushes, and a figure that leans the way it is pushing.
21
+ *
22
+ * `pushesDynamicBodies` is the whole point of this class. Its default is `false`, which matches
23
+ * Rapier — a character walks into a crate and the crate does not move, which on screen reads as a
24
+ * broken collider rather than as a default someone chose.
25
+ */
26
+ export class Warden {
27
+ readonly mesh: Group;
28
+ readonly body: CharacterBody3D;
29
+ #figure: Group;
30
+ #odometer = 0;
31
+ #blockedTicks = 0;
32
+ #previous = new Vector3();
33
+ #hasPrevious = false;
34
+ #asked = 0;
35
+ #facing = 0;
36
+
37
+ constructor(ctx: GameCtx) {
38
+ this.mesh = new Group();
39
+ this.mesh.name = "warden";
40
+ this.#figure = wardenFigure();
41
+ // The capsule is centred on the body origin, so a figure modelled standing on y = 0 floats
42
+ // exactly halfHeight + radius above every floor it lands on unless it is offset back down.
43
+ this.#figure.position.y = -(CAPSULE_HALF_HEIGHT + CAPSULE_RADIUS);
44
+ this.mesh.add(this.#figure);
45
+ this.mesh.position.set(WARDEN_SPAWN.x, WARDEN_SPAWN.y, WARDEN_SPAWN.z);
46
+ ctx.add(this.mesh);
47
+ this.body = new CharacterBody3D({
48
+ autostep: { includeDynamicBodies: false, maxHeight: 0.32, minWidth: 0.2 },
49
+ collisionMask: WARDEN_MASK,
50
+ // Named, or the runtime contact log records this body as an anonymous id and a `contacts`
51
+ // assertion has nothing to match on. The registry name (`ctx.entities.add("player", ...)`)
52
+ // is a different namespace and does not reach the physics observation.
53
+ entity: "player",
54
+ object: this.mesh,
55
+ physics: ctx.physics,
56
+ pushesDynamicBodies: true,
57
+ shape: CollisionShape3D.capsule(CAPSULE_HALF_HEIGHT, CAPSULE_RADIUS),
58
+ });
59
+ }
60
+
61
+ /**
62
+ * One fixed step. `move` is the intent in world XZ, already clamped to unit length; the replay
63
+ * check hands the same scripted vector in that the keyboard would have produced.
64
+ */
65
+ update(dt: number, move: { readonly x: number; readonly z: number }): void {
66
+ // Both measurements below read LAST tick's ask against LAST tick's delivery, and they have to.
67
+ //
68
+ // `moveAndSlide` queues motion for the bulk step; `mesh.position` still holds the previous
69
+ // transform until the solver writes it, some time after this function returns. Comparing the
70
+ // ask with `mesh.position` inside the same call therefore always measures zero delivered
71
+ // motion, and "the warden was blocked" becomes "the warden pressed a key" — measured, it
72
+ // counted 400 blocked ticks in a 400-tick run in which the warden crossed six metres.
73
+ if (this.#hasPrevious) {
74
+ const delivered = Math.hypot(
75
+ this.mesh.position.x - this.#previous.x,
76
+ this.mesh.position.z - this.#previous.z,
77
+ );
78
+ this.#odometer += this.mesh.position.distanceTo(this.#previous);
79
+ if (this.#asked > 0.004 && delivered < this.#asked * BLOCKED_FRACTION)
80
+ this.#blockedTicks += 1;
81
+ }
82
+ this.#previous.copy(this.mesh.position);
83
+ this.body.velocity.x = move.x * MOVE_SPEED;
84
+ this.body.velocity.z = move.z * MOVE_SPEED;
85
+ this.#asked = Math.hypot(this.body.velocity.x, this.body.velocity.z) * dt;
86
+ this.body.moveAndSlide(dt);
87
+ this.#hasPrevious = true;
88
+ if (move.x !== 0 || move.z !== 0) {
89
+ const target = Math.atan2(move.x, move.z);
90
+ // Shortest-arc turn, framerate independent, so the figure faces the shove rather than
91
+ // snapping between the four arrow directions.
92
+ const delta = Math.atan2(Math.sin(target - this.#facing), Math.cos(target - this.#facing));
93
+ this.#facing += delta * (1 - Math.exp(-dt / 0.06));
94
+ this.#figure.rotation.y = this.#facing;
95
+ }
96
+ // Lean into the push. Purely cosmetic, and it is most of what makes the shove read.
97
+ const lean = Math.min(0.28, Math.hypot(move.x, move.z) * 0.28);
98
+ this.#figure.rotation.x += (lean - this.#figure.rotation.x) * (1 - Math.exp(-dt / 0.09));
99
+ }
100
+
101
+ teleport(position: { readonly x: number; readonly y: number; readonly z: number }): void {
102
+ // Velocity survives a teleport, and `velocity.y` is the component this class never writes —
103
+ // gravity accumulates into it every step. Two replay passes that start from different
104
+ // vertical speeds resolve their first contacts differently, and the run that is supposed to
105
+ // prove determinism reports 0.28 m of drift. Reset the whole vector, not the two axes the
106
+ // caller happens to set.
107
+ this.body.velocity.set(0, 0, 0);
108
+ this.body.teleport(position);
109
+ this.mesh.position.set(position.x, position.y, position.z);
110
+ this.#previous.copy(this.mesh.position);
111
+ this.#hasPrevious = false;
112
+ this.#asked = 0;
113
+ }
114
+
115
+ get fallSpeed(): number {
116
+ return this.body.velocity.y;
117
+ }
118
+
119
+ get grounded(): boolean {
120
+ return this.body.grounded;
121
+ }
122
+
123
+ get blockedTicks(): number {
124
+ return this.#blockedTicks;
125
+ }
126
+
127
+ get odometer(): number {
128
+ return this.#odometer;
129
+ }
130
+
131
+ dispose(): void {
132
+ this.body.dispose();
133
+ this.mesh.removeFromParent();
134
+ }
135
+ }
@@ -1,30 +1,32 @@
1
1
  import { defineGame } from "@threenative/core";
2
2
  import { playtest } from "@threenative/core/playtest";
3
+ import type { IPhysicsContext } from "@threenative/physics";
3
4
  import { rapier } from "@threenative/physics";
4
5
  import config from "../threenative.config.js";
5
- import type { PuzzlePhysics } from "./physics.js";
6
- import { Boot } from "./scenes/Boot.js";
7
- import { Puzzle } from "./scenes/Puzzle.js";
6
+ import { Play } from "./scenes/Play.js";
8
7
  import type { GameState } from "./state.js";
9
8
 
10
- const game = defineGame<GameState, PuzzlePhysics>({
9
+ // game.state is the single store: the fixed-step loop writes it, and React/playtests read it.
10
+ const game = defineGame<GameState, IPhysicsContext>({
11
11
  input: {
12
+ // The four directions of `input.vector("move")`. Arrows are what the sealed proof presses;
13
+ // WASD is here so a human plays the same game.
12
14
  move: {
13
15
  down: ["ArrowDown", "KeyS"],
14
16
  left: ["ArrowLeft", "KeyA"],
15
17
  right: ["ArrowRight", "KeyD"],
16
18
  up: ["ArrowUp", "KeyW"],
17
19
  },
18
- grab: { keys: ["KeyE", "Space"] },
20
+ // V runs the vault twice on the same scripted input and reports whether it landed the same.
21
+ verify: { keys: ["KeyV"] },
19
22
  restart: { keys: ["KeyR"] },
20
- swing: { keys: ["KeyF"] },
21
23
  },
22
- plugins: [rapier({ gravity: { x: 0, y: -9.81, z: 0 } }), playtest()],
24
+ plugins: [rapier(), playtest()],
23
25
  display: config.display,
24
26
  render: config.renderer,
25
- scenes: { boot: Boot, puzzle: Puzzle },
26
- seed: 51_204,
27
- start: "boot",
27
+ scenes: { play: Play },
28
+ seed: 6132,
29
+ start: "play",
28
30
  });
29
31
 
30
32
  export default game;
@@ -37,10 +39,12 @@ export default game;
37
39
  * state instead, which keeps one source of truth on the side that owns the simulation.
38
40
  */
39
41
  game.ui.onIntent((intent) => {
40
- if (intent === "restart") void game.goto("puzzle");
42
+ if (intent === "restart") void game.goto("play");
41
43
  if (intent === "pause") game.pause();
42
44
  if (intent === "resume") game.resume();
43
45
  game.state.set({
46
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
47
+ // overlay that never came up apart from a game whose HUD is simply empty.
44
48
  uiReady: game.ui.connected,
45
49
  ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
46
50
  });
@@ -1,37 +1,72 @@
1
+ // Ordinary Three.js — ThreeNative does not read this file.
2
+ //
3
+ // One fixed three-quarter shot of the whole vault, because the reference is a room portrait: the
4
+ // warden, the pile, the phase crates and the seal are all supposed to be legible on the first
5
+ // screen, and a camera that trails the character loses two of the four every time it moves.
6
+ //
7
+ // It still breathes. `settle` eases the framing in over the opening drop, and `nudge` lets the
8
+ // shot drift a fraction of a metre toward the warden so the picture is not completely static.
1
9
  import type { PerspectiveCamera, Vector3 } from "three";
10
+ import { Vector3 as Vec3 } from "three";
2
11
 
3
- const HEIGHT = 20;
4
- const BACK = 17;
5
- /** How far the rig is allowed to lean toward the claw. A puzzle is read by comparing two things
6
- * that are not moving, so the frame must stay still enough to compare them. */
7
- const LEAN = 2.4;
8
- // Biased toward the far half, but not so far that the claw's spawn sits on the bottom edge —
9
- // which is exactly where the first framing put it.
10
- const LOOK_AT = { x: 0, y: 0.4, z: 0.6 };
12
+ export const VAULT_SHOT = {
13
+ fov: 31,
14
+ /**
15
+ * Where the camera sits: about 44 degrees above the floor and 30 degrees off the room's axis.
16
+ *
17
+ * The yaw is the part that matters, and about twenty degrees is the window. An axis-aligned shot puts the near wall across the bottom of
18
+ * the frame as a flat band and flattens the whole room into a rectangle; swinging the camera
19
+ * onto the corner is what makes the left wall recede and gives the picture the diagonal the
20
+ * reference is built on; past thirty the room reads as a diamond with dead corners.
21
+ *
22
+ * The numbers are solved rather than eyeballed. Four attempts at nudging them by hand each cost
23
+ * a build and a screenshot and each landed with the room cropped on one side; projecting the
24
+ * room's eight outer corners through this exact camera and binary-searching the distance found
25
+ * a fit in one pass. Yaw 17 degrees, elevation 41, the room spanning 1.84 of the 2.0 of clip
26
+ * space vertically — so the near wall is just cropped, as it is in the reference — and biased a
27
+ * little right of centre, which is where the HUD is not.
28
+ */
29
+ position: new Vec3(-4.35, 13.33, 14.72),
30
+ /** What it points at: the middle of the room, biased toward the seal corner. */
31
+ target: new Vec3(0, 0.4, 0.5),
32
+ /** How far the shot is allowed to drift toward the warden, in metres. */
33
+ drift: 0.1,
34
+ } as const;
11
35
 
12
- export function setupCamera(camera: PerspectiveCamera): void {
13
- camera.fov = 42;
14
- camera.near = 0.1;
15
- camera.far = 120;
16
- camera.position.set(0, HEIGHT, BACK);
17
- camera.lookAt(LOOK_AT.x, LOOK_AT.y, LOOK_AT.z);
18
- camera.updateProjectionMatrix();
36
+ export interface IVaultCamera {
37
+ readonly snap: () => void;
38
+ readonly follow: (subject: Vector3, dt: number) => void;
19
39
  }
20
40
 
21
- /**
22
- * A fixed three-quarter rig that leans toward the claw and never leaves the room.
23
- *
24
- * The lean is clamped and the look-at target is constant. An earlier version scaled both the
25
- * position and the target by the claw's position; walking to a wall then swung the whole frame
26
- * outside the room and tipped the floor plane, which looked like a broken scene and was a broken
27
- * camera. Damping a bounded offset around a fixed target cannot do that.
28
- */
29
- export function followGripper(camera: PerspectiveCamera, target: Vector3, dt: number): void {
30
- const blend = Math.min(1, Math.max(0, dt) * 3);
31
- const wantX = Math.max(-LEAN, Math.min(LEAN, target.x * 0.3));
32
- const wantZ = BACK + Math.max(-LEAN, Math.min(LEAN, target.z * 0.2));
33
- camera.position.x += (wantX - camera.position.x) * blend;
34
- camera.position.z += (wantZ - camera.position.z) * blend;
35
- camera.position.y = HEIGHT;
36
- camera.lookAt(LOOK_AT.x, LOOK_AT.y, LOOK_AT.z);
41
+ export function createVaultCamera(camera: PerspectiveCamera): IVaultCamera {
42
+ camera.fov = VAULT_SHOT.fov;
43
+ camera.near = 0.5;
44
+ camera.far = 90;
45
+ camera.updateProjectionMatrix();
46
+
47
+ const desired = new Vec3();
48
+ const aim = new Vec3();
49
+ const currentAim = VAULT_SHOT.target.clone();
50
+
51
+ const snap = (): void => {
52
+ camera.position.copy(VAULT_SHOT.position);
53
+ currentAim.copy(VAULT_SHOT.target);
54
+ camera.lookAt(currentAim);
55
+ };
56
+
57
+ const follow = (subject: Vector3, dt: number): void => {
58
+ // Drift a fraction of a metre toward the warden and no further. The shot is the room; this
59
+ // is only enough parallax that the picture is not a still.
60
+ aim.copy(subject).sub(VAULT_SHOT.target);
61
+ aim.y = 0;
62
+ if (aim.lengthSq() > 1e-6) aim.normalize().multiplyScalar(VAULT_SHOT.drift);
63
+ else aim.set(0, 0, 0);
64
+ desired.copy(VAULT_SHOT.position).add(aim);
65
+ // 1 - e^(-dt/tau) is the framerate-independent form of a lerp: the same second of drift at
66
+ // 30 fps and at 120 fps ends in the same place.
67
+ camera.position.lerp(desired, 1 - Math.exp(-dt / 0.9));
68
+ camera.lookAt(currentAim);
69
+ };
70
+
71
+ return { follow, snap };
37
72
  }
@@ -0,0 +1,70 @@
1
+ // Ordinary Three.js — ThreeNative does not read this file.
2
+ //
3
+ // A crate is a rounded box with plank braces nailed across each side in an X. Both parts are
4
+ // merged into ONE geometry carrying two material groups, so a crate costs two draws instead of
5
+ // nine, and forty of them stay affordable while every one is a separately simulated body.
6
+ import { BoxGeometry, type BufferGeometry, Matrix4 } from "three";
7
+ import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
8
+ import { roundedBox } from "./shapes.js";
9
+
10
+ export const CRATE_SIZE = 0.92;
11
+
12
+ let cached: BufferGeometry | undefined;
13
+
14
+ /**
15
+ * Group 0 is the crate body, group 1 is the brace timber. Build a crate with
16
+ * `new Mesh(crateGeometry(), [colour, braceMaterial])`.
17
+ */
18
+ export function crateGeometry(): BufferGeometry {
19
+ if (cached !== undefined) return cached;
20
+ const half = CRATE_SIZE / 2;
21
+ const body = roundedBox(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE, 0.075, 3).clone();
22
+
23
+ const planks: BufferGeometry[] = [];
24
+ const diagonal = CRATE_SIZE * 1.24;
25
+ // Four side faces and the lid. The underside is never seen and is not paid for.
26
+ const faces: readonly {
27
+ readonly rotation: Matrix4;
28
+ readonly offset: [number, number, number];
29
+ }[] = [
30
+ { offset: [0, 0, half], rotation: new Matrix4() },
31
+ { offset: [0, 0, -half], rotation: new Matrix4().makeRotationY(Math.PI) },
32
+ { offset: [half, 0, 0], rotation: new Matrix4().makeRotationY(Math.PI / 2) },
33
+ { offset: [-half, 0, 0], rotation: new Matrix4().makeRotationY(-Math.PI / 2) },
34
+ { offset: [0, half, 0], rotation: new Matrix4().makeRotationX(-Math.PI / 2) },
35
+ ];
36
+ for (const face of faces) {
37
+ for (const sign of [1, -1]) {
38
+ const plank = new BoxGeometry(diagonal, 0.058, 0.028);
39
+ // `roundedBox` welds away its UVs, and `mergeGeometries` refuses a set of geometries whose
40
+ // attributes do not match exactly — it returns null and logs, which is easy to miss.
41
+ plank.deleteAttribute("uv");
42
+ plank.applyMatrix4(new Matrix4().makeRotationZ((sign * Math.PI) / 4));
43
+ plank.applyMatrix4(new Matrix4().makeTranslation(0, 0, 0.01));
44
+ plank.applyMatrix4(face.rotation);
45
+ plank.applyMatrix4(
46
+ new Matrix4().makeTranslation(face.offset[0], face.offset[1], face.offset[2]),
47
+ );
48
+ planks.push(plank);
49
+ }
50
+ // A rail along the top and bottom of each side face, which is what stops the X reading as a
51
+ // sticker and starts it reading as carpentry.
52
+ for (const edge of [half - 0.1, -half + 0.1]) {
53
+ const rail = new BoxGeometry(CRATE_SIZE * 0.98, 0.062, 0.028);
54
+ rail.deleteAttribute("uv");
55
+ rail.applyMatrix4(new Matrix4().makeTranslation(0, edge, 0.01));
56
+ rail.applyMatrix4(face.rotation);
57
+ rail.applyMatrix4(
58
+ new Matrix4().makeTranslation(face.offset[0], face.offset[1], face.offset[2]),
59
+ );
60
+ planks.push(rail);
61
+ }
62
+ }
63
+
64
+ const braces = mergeGeometries(planks, false);
65
+ if (braces === null) throw new Error("Crate braces failed to merge.");
66
+ const merged = mergeGeometries([body, braces], true);
67
+ if (merged === null) throw new Error("Crate geometry failed to merge.");
68
+ cached = merged;
69
+ return merged;
70
+ }