create-threenative 0.2.6 → 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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -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
+ }
@@ -1,55 +1,55 @@
1
- import {
2
- AmbientLight,
3
- DirectionalLight,
4
- HemisphereLight,
5
- PCFSoftShadowMap,
6
- type Scene,
7
- } from "three";
8
- import { palette } from "./palette.js";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // A dark room with two warm lamps in it (authored with the props themselves, in `vault.ts`). The
5
+ // whole read of this picture is that the *ambient* is almost nothing and every bright surface is
6
+ // bright because a named source is pointing at it, so the temptation to raise the fill until the
7
+ // crates are comfortably visible has to be resisted: the moment the floor stops being near-black
8
+ // the picture stops being a vault.
9
+ import { DirectionalLight, HemisphereLight, PCFSoftShadowMap, type Scene } from "three";
9
10
 
10
11
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
12
 
12
- /**
13
- * Key, fill, rim, ambient — named, so each one can be changed on its own.
14
- *
15
- * An indoor contraption room lives or dies on contact shadows: the player has to see that a crate
16
- * is *on* the floor and that the ball is *touching* the ramp, or every physical judgement becomes
17
- * a guess. So the key is hard, with a tight shadow frustum.
18
- *
19
- * It is also nearly overhead, and that was a fix rather than a preference. A key at fifteen
20
- * degrees off the horizon threw the left wall across half the play area, and the first capture
21
- * had a black floor on one side and a legible one on the other — the room looked broken. In an
22
- * interior with walls this tall, the key belongs above the room and the fill has to be strong
23
- * enough that its shadow still has a readable floor inside it.
24
- *
25
- * Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
26
- * the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
27
- * rendering a black pass.
28
- */
29
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
13
+ /** Returns the key light: the godrays stage raymarches a shadow map and refuses a shadowless one. */
14
+ export function setupLighting(
15
+ scene: Scene,
16
+ renderer: ShadowRenderer,
17
+ mobile = false,
18
+ ): DirectionalLight {
30
19
  renderer.shadowMap.enabled = true;
31
20
  renderer.shadowMap.type = PCFSoftShadowMap;
32
- scene.add(new HemisphereLight(palette.skyLow, palette.floor, 2.4));
33
21
 
34
- const key = new DirectionalLight(0xfff2dd, 3);
35
- key.position.set(-4, 24, 7);
22
+ // Sky above, floor bounce below, both cold and both very quiet.
23
+ scene.add(new HemisphereLight(0x33456a, 0x171d29, 0.6));
24
+
25
+ // The key. Warm, high, and from the lantern side, so crate tops catch a little of the same
26
+ // colour the plaster does and the shadows all fall the same way.
27
+ const key = new DirectionalLight(0xf4e8da, 0.8);
28
+ key.position.set(-7, 15, 5);
36
29
  key.castShadow = true;
37
- key.shadow.mapSize.set(1024, 1024);
38
- key.shadow.camera.near = 0.5;
39
- key.shadow.camera.far = 70;
40
- key.shadow.camera.left = -18;
41
- key.shadow.camera.right = 18;
42
- key.shadow.camera.top = 18;
43
- key.shadow.camera.bottom = -18;
30
+ const size = mobile ? 1024 : 2048;
31
+ key.shadow.mapSize.set(size, size);
32
+ key.shadow.camera.near = 1;
33
+ key.shadow.camera.far = 46;
34
+ // The extent covers the whole room and nothing else: the vault is 16 x 11 metres and a shadow
35
+ // camera any wider spends its texels outside the walls.
36
+ const extent = 10;
37
+ key.shadow.camera.left = -extent;
38
+ key.shadow.camera.right = extent;
39
+ key.shadow.camera.top = extent;
40
+ key.shadow.camera.bottom = -extent;
41
+ key.shadow.bias = -0.0006;
42
+ // Rounded geometry self-shadows at grazing angles without this, and the bias alone would have
43
+ // to grow big enough to detach the contact shadow under every crate.
44
44
  key.shadow.normalBias = 0.035;
45
45
  scene.add(key);
46
46
 
47
- // Cool, from behind and low: it separates the steel and the wall tops from the dark beyond the
48
- // room without adding a second set of shadows to read.
49
- const rim = new DirectionalLight(palette.skyLow, 1.3);
50
- rim.position.set(9, 5, -14);
47
+ // The rim: cold, low and shadowless, from the far corner the lanterns never reach. A crate's
48
+ // shadowed side is otherwise the same black as the floor it stands on, and the pile stops
49
+ // reading as forty separate boxes.
50
+ const rim = new DirectionalLight(0x5f7fb0, 0.24);
51
+ rim.position.set(9, 5, -7);
51
52
  scene.add(rim);
52
- scene.add(new AmbientLight(palette.skyLow, 0.5));
53
53
 
54
54
  return key;
55
55
  }
@@ -12,17 +12,17 @@ import {
12
12
  import { palette } from "./palette.js";
13
13
 
14
14
  /* BEGIN THREENATIVE LOADING APPEARANCE */
15
- /** Puzzle look and composition; edit this generated source to change the screen. */
15
+ /** Vault look and composition; edit this generated source to change the screen. */
16
16
  export const loading = {
17
- backgroundColor: palette.skyLow,
17
+ backgroundColor: palette.void,
18
18
  backgroundImage: undefined as string | undefined,
19
19
  enabled: true,
20
20
  fillImage: undefined as string | undefined,
21
21
  logoImage: undefined as string | undefined,
22
22
  progressColor: palette.accent,
23
23
  showStatus: false,
24
- trackColor: palette.skyHigh,
25
- bar: { anchorX: 0.5, anchorY: 0.76, height: 11, maxWidth: 520, minWidth: 1, width: 0.6 },
24
+ trackColor: palette.timber,
25
+ bar: { anchorX: 0.5, anchorY: 0.72, height: 12, maxWidth: 520, minWidth: 1, width: 0.62 },
26
26
  } as const;
27
27
  /* END THREENATIVE LOADING APPEARANCE */
28
28