create-threenative 0.2.6 → 0.2.8

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 (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  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 +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  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/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,146 @@
1
+ // Generated for you. Ordinary Three.js, and the whole coastal look lives in this file.
2
+ //
3
+ // The coast is not a set of meshes. It is one raymarched distance field — terrain, the road down
4
+ // it, the double yellow line, the sea, the island, the forest, the six lamps, the rail, the cabin
5
+ // with its lit window and its antenna, the wet reflections and the rain ripples — evaluated in the
6
+ // fragment shader, which is why the whole thing is a single screen-sized quad. Its maths lives in
7
+ // `world-shader.ts`, which `tools/generate-shaders.mjs` transpiles from GLSL; this file
8
+ // owns the camera basis, the weather uniforms and the sky it reflects, and nothing else.
9
+ //
10
+ // Conventions: one world unit is one metre, +x is out to sea, -z runs down the coast.
11
+ import {
12
+ DoubleSide,
13
+ Mesh,
14
+ type PerspectiveCamera,
15
+ PlaneGeometry,
16
+ type Scene,
17
+ Vector3,
18
+ } from "three";
19
+ import { cameraFar, cameraNear, clamp, float, positionGeometry, uv, vec4 } from "three/tsl";
20
+ import { MeshBasicNodeMaterial } from "three/webgpu";
21
+ import type { QualityName, Weather } from "../state.js";
22
+ import { type ICloudPass, createCloudPass } from "./clouds.js";
23
+ import { setupLighting } from "./lighting.js";
24
+ import { setupMaterials } from "./materials.js";
25
+ import { studyTier } from "./quality.js";
26
+ import { setupSky } from "./sky.js";
27
+ import {
28
+ tempestWorld,
29
+ uAspect,
30
+ uCam,
31
+ uFlash,
32
+ uFog,
33
+ uForward,
34
+ uRain,
35
+ uReflect,
36
+ uRight,
37
+ uStrike,
38
+ uTan,
39
+ uTime,
40
+ uUp,
41
+ uWet,
42
+ } from "./world-shader.js";
43
+
44
+ export interface IWeatherWorldOptions {
45
+ /** Absolute seconds, so the weather phase does not depend on how the frame was scheduled. */
46
+ readonly elapsed: number;
47
+ /** Current flash envelope, already gated on the photosensitivity switch by the caller. */
48
+ readonly flash: number;
49
+ readonly weather: Weather;
50
+ /** Where the last strike landed, in metres. Only visible while `flash` is above zero. */
51
+ readonly strike: Vector3;
52
+ /** The player's tier: `quality.ts` decides whether it runs the 36-step reflection march. */
53
+ readonly quality: QualityName;
54
+ }
55
+
56
+ export interface IWeatherWorld {
57
+ /** The screen quad, for the engine's culling pass: see the engine's `alwaysRender`. */
58
+ readonly quad: Mesh;
59
+ /** What the cloud pass really drew last frame: its target size and its march steps. */
60
+ readonly clouds: ICloudPass["measured"];
61
+ dispose(): void;
62
+ update(options: IWeatherWorldOptions): void;
63
+ }
64
+
65
+ /**
66
+ * The cloud pass is built first because it is what the world samples: `createCloudPass` binds the
67
+ * pass's texture node to the world's `uSky`, and the world shader's own functions read that binding
68
+ * when this call below builds their graph. The order of these two lines is the whole dependency.
69
+ */
70
+ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWeatherWorld {
71
+ const clouds: ICloudPass = createCloudPass({ camera });
72
+ // The look the two passes read: sky and haze colours, the sun and the flash light, and the lamp
73
+ // and sea colours. Set once; nothing here changes per frame.
74
+ setupSky(scene);
75
+ setupLighting();
76
+ setupMaterials();
77
+
78
+ const world = tempestWorld(uv());
79
+ // The shader's own depth is a curve fitted to the source's camera; the closed form is reversible,
80
+ // so the engine's near/far decide the real clip depth and anything drawn after this quad — rain,
81
+ // then lightning — is occluded by the coast rather than floating through it.
82
+ const viewDistance = float(0.150009).div(float(1.00006).sub(world.w));
83
+ const material = new MeshBasicNodeMaterial();
84
+ // The source driver drew its coast quad with both faces, so the vertex stage is written to flip
85
+ // the corner order; a single-face material would cull whichever way that lands.
86
+ material.side = DoubleSide;
87
+ material.vertexNode = vec4(positionGeometry.xy, 0, 1);
88
+ material.fragmentNode = world.xyz;
89
+ material.depthNode = clamp(
90
+ cameraNear
91
+ .add(cameraFar)
92
+ .sub(cameraNear.mul(cameraFar).mul(2).div(viewDistance))
93
+ .div(cameraFar.sub(cameraNear))
94
+ .add(1)
95
+ .mul(0.5),
96
+ 0,
97
+ 1,
98
+ );
99
+
100
+ const geometry = new PlaneGeometry(2, 2);
101
+ const quad = new Mesh(geometry, material);
102
+ // The quad's own bounds are two metres wide and sit at the origin, so both frustum tests would
103
+ // throw it away the moment the camera looks along the coast.
104
+ quad.frustumCulled = false;
105
+ scene.add(quad);
106
+
107
+ const forward = new Vector3();
108
+ const right = new Vector3();
109
+ const up = new Vector3();
110
+
111
+ return {
112
+ quad,
113
+ clouds: clouds.measured,
114
+ dispose(): void {
115
+ scene.remove(quad);
116
+ geometry.dispose();
117
+ material.dispose();
118
+ clouds.dispose();
119
+ },
120
+ update({ elapsed, flash, quality, strike, weather }): void {
121
+ // The camera basis the shader raymarches from: the same three axes the renderer draws with,
122
+ // and the same field of view, so the coast lines up with anything the engine adds later.
123
+ camera.getWorldDirection(forward);
124
+ right.set(1, 0, 0).applyQuaternion(camera.quaternion);
125
+ up.set(0, 1, 0).applyQuaternion(camera.quaternion);
126
+ uCam.value.copy(camera.position);
127
+ uForward.value.copy(forward);
128
+ uRight.value.copy(right);
129
+ uUp.value.copy(up);
130
+ uAspect.value = camera.aspect;
131
+ uTan.value = Math.tan((camera.fov * Math.PI) / 360);
132
+ uTime.value = elapsed;
133
+
134
+ uRain.value = weather.rain;
135
+ uFog.value = weather.fog;
136
+ uWet.value = weather.wet;
137
+ uFlash.value = flash;
138
+ uStrike.value.copy(strike);
139
+ uReflect.value = studyTier(quality).reflections ? 1 : 0;
140
+
141
+ // The sky the shader draws and reflects is the cloud target, so the same weather that steers
142
+ // the rain also lights the ceiling, and a flash reaches both from one value.
143
+ clouds.update({ elapsed, flash, quality, strike, weather });
144
+ },
145
+ };
146
+ }
@@ -24,8 +24,10 @@ import {
24
24
  } from "three";
25
25
  import { bloom } from "three/addons/tsl/display/BloomNode.js";
26
26
  import { denoise } from "three/addons/tsl/display/DenoiseNode.js";
27
+ import { fxaa } from "three/addons/tsl/display/FXAANode.js";
27
28
  import { ao } from "three/addons/tsl/display/GTAONode.js";
28
29
  import { godrays } from "three/addons/tsl/display/GodraysNode.js";
30
+ import { smaa } from "three/addons/tsl/display/SMAANode.js";
29
31
  import { ssgi } from "three/addons/tsl/display/SSGINode.js";
30
32
  import { ssr } from "three/addons/tsl/display/SSRNode.js";
31
33
  import { sharpen } from "three/addons/tsl/display/SharpenNode.js";
@@ -33,6 +35,7 @@ import {
33
35
  color,
34
36
  convertToTexture,
35
37
  float,
38
+ max,
36
39
  metalness,
37
40
  mrt,
38
41
  normalView,
@@ -45,6 +48,9 @@ import {
45
48
  } from "three/tsl";
46
49
  import type { Node } from "three/webgpu";
47
50
 
51
+ /** Godot's `Viewport.screen_space_aa`: which post-process antialiasing smooths the frame's edges. */
52
+ export type ScreenSpaceAA = "smaa" | "fxaa" | "disabled";
53
+
48
54
  /** Godot's `Environment.tonemap_mode`, with the modes Three.js actually ships. */
49
55
  export type TonemapMode = "aces" | "agx" | "neutral";
50
56
 
@@ -184,6 +190,16 @@ export interface IWorldEnvironmentOptions {
184
190
  readonly sharpenStrength?: number;
185
191
  /** Corner darkening, as a fraction removed at the extreme corner. Zero disables it. */
186
192
  readonly vignetteAmount?: number;
193
+ /**
194
+ * Post-process antialiasing, run last. Godot's `Viewport.screen_space_aa`. Default `"smaa"`.
195
+ *
196
+ * Not optional in practice: the chain renders `pass(scene, camera)` single-sampled, so the moment
197
+ * any stage runs, the renderer's own multisampling no longer reaches the frame and every edge
198
+ * stairsteps — the single loudest "this is a prototype" signal in a frame. It is requested only
199
+ * when some other stage (or a `baseColour`) installs a chain; with nothing installed the renderer
200
+ * draws straight to the canvas with its own MSAA and this would be paying twice.
201
+ */
202
+ readonly screenSpaceAA?: ScreenSpaceAA;
187
203
  /** Godot's `glow_enabled`. */
188
204
  readonly bloomEnabled?: boolean;
189
205
  readonly bloomStrength?: number;
@@ -391,6 +407,7 @@ export class WorldEnvironment {
391
407
  sharpenEnabled: options.sharpenEnabled ?? false,
392
408
  sharpenStrength: options.sharpenStrength ?? 0.2,
393
409
  vignetteAmount: options.vignetteAmount ?? 0,
410
+ screenSpaceAA: options.screenSpaceAA ?? "smaa",
394
411
  bloomEnabled: options.bloomEnabled ?? true,
395
412
  bloomStrength: options.bloomStrength ?? 0.7,
396
413
  bloomRadius: options.bloomRadius ?? 0.5,
@@ -432,6 +449,11 @@ export class WorldEnvironment {
432
449
  (name === "vignette" && options.vignetteAmount > 0),
433
450
  );
434
451
  requested.push(...options.authoredStageNames);
452
+ if (
453
+ options.screenSpaceAA !== "disabled" &&
454
+ (requested.length > 0 || target.baseColour !== undefined)
455
+ )
456
+ requested.push("antialias");
435
457
 
436
458
  // With no stage running there is no node graph to install — the renderer's own
437
459
  // tone-mapping path renders the frame, and the exposure scalar is live there (measured:
@@ -542,7 +564,14 @@ export class WorldEnvironment {
542
564
  // Applied before SSGI by the chain's canonical order; composing it after the GI
543
565
  // combine instead darkens crevices the gather re-lit — that is a look choice, and
544
566
  // this file is where you make it.
545
- return input.mul(contact.r);
567
+ //
568
+ // Denoised with the same depth-aware filter as the GI gather: GTAO's interleaved
569
+ // sampling otherwise reads as a speckled halo around every contact — around feet on a
570
+ // plain floor most of all — which is exactly the "not smooth" a player notices first.
571
+ const occlusion = options.denoiseEnabled
572
+ ? denoised(denoise(contact.getTextureNode(), depth(), normal(), view))
573
+ : contact;
574
+ return input.mul(occlusion.r);
546
575
  },
547
576
  }),
548
577
  stage({
@@ -668,6 +697,26 @@ export class WorldEnvironment {
668
697
  return input.mul(fall.oneMinus());
669
698
  },
670
699
  }),
700
+ {
701
+ // Last, after every built-in: antialiasing is defined on the finished picture, and any
702
+ // stage after it would put the stairsteps back.
703
+ name: "antialias",
704
+ after: "gradualBackground",
705
+ build: (input) => {
706
+ const colour = input as ChainNode;
707
+ // SMAA and FXAA find edges by local contrast and expect display-range colour, but this is
708
+ // the linear HDR frame before the tone curve — a sun-lit edge at 20 against sky at 3
709
+ // would blend into a bright halo. The reversible Karis weighting squeezes it into [0, 1)
710
+ // for the filter and expands it back afterwards, so edges resolve without the halo.
711
+ const peak = max(colour.r, max(colour.g, colour.b));
712
+ const squeezed = colour.div(peak.add(1));
713
+ const filtered = (options.screenSpaceAA === "fxaa"
714
+ ? fxaa(squeezed)
715
+ : smaa(squeezed)) as unknown as ChainNode;
716
+ const back = max(filtered.r, max(filtered.g, filtered.b));
717
+ return filtered.div(float(1).sub(back).max(1e-4));
718
+ },
719
+ },
671
720
  ];
672
721
 
673
722
  // The kit's own stages, composed after the built-ins. The factory is called with the two
@@ -723,6 +772,7 @@ export class WorldEnvironment {
723
772
  const options = this.#options;
724
773
  const off: Record<string, string> = {
725
774
  ambientOcclusion: "gtaoEnabled is false",
775
+ antialias: 'screenSpaceAA is "disabled", or no other stage installed a chain',
726
776
  bloom: "bloomEnabled is false",
727
777
  godRays: "godraysEnabled is false",
728
778
  sharpen: "sharpenEnabled is false",
@@ -745,6 +795,7 @@ export class WorldEnvironment {
745
795
  denoise: options.denoiseEnabled,
746
796
  exposure: options.exposure,
747
797
  marker: "TN_WORLD_ENVIRONMENT",
798
+ screenSpaceAA: options.screenSpaceAA,
748
799
  ssgiQuality: options.ssgiQuality,
749
800
  stages,
750
801
  tonemapMode: options.tonemapMode,
@@ -0,0 +1,334 @@
1
+ // Generated for you. The one scene: a coast you can walk, and an atmosphere you can reshape.
2
+ import { type ICtx, Scene, type SceneFrame, alwaysRender, isMobile } from "@threenative/core";
3
+ import { type PerspectiveCamera, Vector3 } from "three";
4
+ import { STORM_AUDIO_ENTITY, createStormAudio } from "../audio/storm.js";
5
+ import { createCameraRig, setupCamera } from "../render/camera.js";
6
+ import { type IStormLightning, createStormLightning } from "../render/lightning.js";
7
+ import { createLoadingScreen } from "../render/loading.js";
8
+ import { type IStormPost, setupPost } from "../render/postprocessing.js";
9
+ import { type IStormRain, createStormRain } from "../render/rain.js";
10
+ import { createWeatherWorld } from "../render/world.js";
11
+ import {
12
+ AUTO_STRIKE_CLOUD,
13
+ type GameState,
14
+ MAX_STEP,
15
+ type SimStatus,
16
+ WEATHER_KEYS,
17
+ type Weather,
18
+ easeWeather,
19
+ flashAt,
20
+ intentPatch,
21
+ thunderDelay,
22
+ } from "../state.js";
23
+
24
+ export type WeatherCtx = ICtx<GameState>;
25
+
26
+ /** Seconds of weather the clock starts on, so the first frame is not the start of the storm. */
27
+ const START_TIME = 28;
28
+ /** The storm, this far in, is not waiting for the first automatic strike. */
29
+ const FIRST_STRIKE_DELAY = 9;
30
+ const STRIKE_MIN_GAP = 8;
31
+ const STRIKE_SPREAD = 16;
32
+ /** Below this gap the atmosphere is where it was aimed, and the status can say so. */
33
+ const SETTLED = 0.004;
34
+ /** Where a strike lands, in the game's own coordinates: out to sea, ahead of the coast. */
35
+ const STRIKE_SITE = { maxX: 49, minX: -45, nearZ: -250, spread: 220 } as const;
36
+
37
+ const STORM: Weather = {
38
+ cloud: 0.76,
39
+ exposure: 1.12,
40
+ fog: 0.4,
41
+ rain: 0.76,
42
+ wet: 1,
43
+ wind: 0.55,
44
+ };
45
+
46
+ export class Coast extends Scene<GameState> {
47
+ // Kept on the instance because `enter` builds them and `exit` is the only hook that runs when the
48
+ // scene goes away: a dropped handle is a shader chain and a geometry that never come back.
49
+ #rain: IStormRain | undefined;
50
+ #post: IStormPost | undefined;
51
+ #lightning: IStormLightning | undefined;
52
+ #measureClouds: (() => GameState["cloudPass"]) | undefined;
53
+ #curtainLifted: (() => boolean) | undefined;
54
+
55
+ static override readonly initialState: GameState = {
56
+ audioEnabled: false,
57
+ autoLightning: true,
58
+ cameraReset: false,
59
+ cinematic: false,
60
+ cloudPass: { height: 0, steps: 0, width: 0 },
61
+ droplets: true,
62
+ dropCount: 0,
63
+ elapsed: START_TIME,
64
+ flash: 0,
65
+ fps: 0,
66
+ frame: 0,
67
+ frozen: false,
68
+ heading: 0,
69
+ helpOpen: false,
70
+ muted: false,
71
+ paused: false,
72
+ lastStrike: { at: -1, delay: 0, metres: 0 },
73
+ loading: { progress: 0, ready: false },
74
+ pendingThunderAt: -1,
75
+ position: { x: 0, y: 0, z: 0 },
76
+ preset: "storm",
77
+ quality: "balanced",
78
+ safe: false,
79
+ status: "steady",
80
+ stepRequest: 0,
81
+ strikeRequested: false,
82
+ strikes: 0,
83
+ target: { ...STORM },
84
+ uiHidden: false,
85
+ uiReady: false,
86
+ weather: { ...STORM },
87
+ };
88
+
89
+ override enter(ctx: WeatherCtx): SceneFrame<GameState> {
90
+ const camera = ctx.camera as PerspectiveCamera;
91
+ setupCamera(camera);
92
+ const rig = createCameraRig(camera);
93
+ // The study's player is the fly camera, so that is the subject a playtest moves and measures.
94
+ ctx.entities.add("player", camera);
95
+ const loading = createLoadingScreen(ctx);
96
+ // The storm's noise volume is the same 64³ every run whatever the player does: it is seeded
97
+ // inside the render layer, because the sequence that fills it is the storm's appearance.
98
+ const world = createWeatherWorld(ctx.scene, camera);
99
+ // The world is one screen-sized quad at the origin, so the camera's own frustum would cull it
100
+ // the moment it looked along the coast. Marking it is how a game says "this is always drawn".
101
+ alwaysRender(world.quad);
102
+ // The rain is one instanced draw whose drops are projected by its own vertex stage, so its
103
+ // bounds say nothing about where they land and the same marker keeps it drawn at any heading.
104
+ const rain = createStormRain(ctx.scene, camera);
105
+ alwaysRender(rain.mesh);
106
+ // The bolt is drawn after the coast and depth-tested against it, so a strike behind the
107
+ // headland is hidden by it. Its quads are projected by its own vertex stage, like the rain.
108
+ const lightning = createStormLightning(ctx.scene, camera);
109
+ alwaysRender(lightning.mesh);
110
+ // Retained, not called and dropped: `update` is where the post pass learns this frame's time,
111
+ // exposure, rain and droplet toggle, and `uRes` is zero until it has run once.
112
+ const post = setupPost(ctx.renderer, ctx.scene, camera, {
113
+ mobile: isMobile(),
114
+ software: ctx.renderer.softwareAdapter !== undefined,
115
+ });
116
+ this.#rain = rain;
117
+ this.#post = post;
118
+ this.#lightning = lightning;
119
+ this.#measureClouds = world.clouds;
120
+ // `loading.ts` lifts its cover by making the canvas layer transparent again; that is the frame
121
+ // the world is on screen, so it is the frame the interface may appear on.
122
+ this.#curtainLifted = () => !ctx.canvasLayer.opaque;
123
+ // Registered, so the engine's registry disposes it with the game and `game.ts` can reach it by
124
+ // name for the two holds that arrive outside a frame (the pause intent and tab visibility).
125
+ const audio = ctx.entities.add(STORM_AUDIO_ENTITY, createStormAudio(ctx));
126
+
127
+ let weather: Weather = { ...STORM };
128
+ let elapsed = START_TIME;
129
+ let frame = 0;
130
+ let nextStrikeAt = START_TIME + FIRST_STRIKE_DELAY;
131
+ let strikeAt = -100;
132
+ let pendingThunderAt = -1;
133
+ let cinematic = false;
134
+ let safe = false;
135
+ let strikes = 0;
136
+ let lastStrike = { at: -1, delay: 0, metres: 0 };
137
+ // Where the bolt lands, and where it entered the cloud deck. The deck point is what the clouds
138
+ // glow around and what the coast is lit from; the ground point is what the thunder crosses.
139
+ // Out at sea, so a flash that lands before the first strike still lights open water.
140
+ const site = new Vector3(0, 0, -400);
141
+ const strikePoint = new Vector3(0, 180, -400);
142
+
143
+ /**
144
+ * A strike is queued on the same clock as everything else, so the flash, the thunder and the
145
+ * distance it crossed cannot disagree with each other. Gated on the photosensitivity switch
146
+ * at the one door every path comes through, manual key and automatic alike.
147
+ */
148
+ const strike = (): void => {
149
+ if (safe) return;
150
+ strikeAt = elapsed - 0.025;
151
+ site.set(
152
+ STRIKE_SITE.minX + ctx.random() * (STRIKE_SITE.maxX - STRIKE_SITE.minX),
153
+ 0,
154
+ STRIKE_SITE.nearZ - ctx.random() * STRIKE_SITE.spread,
155
+ );
156
+ strikePoint.copy(lightning.strike(site, ctx.random));
157
+ const metres = rig.position.distanceTo(site);
158
+ const delay = thunderDelay(metres);
159
+ pendingThunderAt = elapsed + delay;
160
+ nextStrikeAt = elapsed + STRIKE_MIN_GAP + ctx.random() * STRIKE_SPREAD;
161
+ strikes += 1;
162
+ lastStrike = { at: elapsed, delay, metres };
163
+ // The thunder is queued on the same clock the flash is drawn against, by the same distance
164
+ // the delay came from, so what is heard cannot disagree with what was seen.
165
+ audio.queueStrike({ at: pendingThunderAt, metres });
166
+ };
167
+
168
+ /**
169
+ * The keyboard shortcuts, through the same validated door the panel's controls use, so a key
170
+ * and a click cannot disagree about what photosensitivity mode or sound means.
171
+ */
172
+ const readKeys = (frameCtx: WeatherCtx): void => {
173
+ const input = frameCtx.input;
174
+ const ui = frameCtx.state.getState();
175
+ let patch: Partial<GameState> = {};
176
+ if (input.justPressed("safe"))
177
+ patch = { ...patch, ...intentPatch("setSafe", !ui.safe, ui.target) };
178
+ if (input.justPressed("hideUi")) patch.uiHidden = !ui.uiHidden;
179
+ if (input.justPressed("sound")) {
180
+ const on = ui.audioEnabled && !ui.muted;
181
+ patch.audioEnabled = true;
182
+ patch.muted = on;
183
+ }
184
+ if (input.justPressed("pause")) {
185
+ patch.paused = !ui.paused;
186
+ audio.setSilenced(patch.paused);
187
+ }
188
+ if (Object.keys(patch).length > 0) frameCtx.state.set(patch);
189
+ };
190
+
191
+ /** Read the intent the UI sent between frames, before anything is derived from it. */
192
+ const readIntent = (frameCtx: WeatherCtx): GameState => {
193
+ readKeys(frameCtx);
194
+ const ui = frameCtx.state.getState();
195
+ // Both resets come through the same door, and each one is a fresh request: the flag is
196
+ // consumed and cleared below, never latched, so a second reset still lands.
197
+ const reset = ui.cameraReset || frameCtx.input.justPressed("resetCamera");
198
+ if (reset) {
199
+ rig.reset();
200
+ cinematic = false;
201
+ } else {
202
+ // Any real input hands the camera back: the orbit is a mode, not a cage.
203
+ cinematic = ui.cinematic && !rig.manual;
204
+ }
205
+ safe = ui.safe;
206
+ if (ui.strikeRequested || frameCtx.input.justPressed("strike")) strike();
207
+ return ui;
208
+ };
209
+
210
+ const advance = (ui: GameState, step: number): void => {
211
+ // A held simulation still draws, as the study's did: the look follows the panel at once
212
+ // instead of easing on a clock that is not running, and nothing else moves.
213
+ if (ui.paused || ui.frozen) weather = { ...ui.target };
214
+ if (step <= 0) return;
215
+ elapsed += step;
216
+ weather = easeWeather(weather, ui.target, step);
217
+ // The study's own gate: past its time, the first frame with real cloud cover strikes.
218
+ if (ui.autoLightning && elapsed > nextStrikeAt && weather.cloud > AUTO_STRIKE_CLOUD) strike();
219
+ };
220
+
221
+ return (frameCtx, dt) => {
222
+ const ui = readIntent(frameCtx);
223
+ // Pause holds the simulation the way the study's did — the frame is still drawn, so a drag
224
+ // still looks around — and `frozen` is the automation's stopped clock, which only an explicit
225
+ // `step` moves on. A step never runs while paused, exactly as the study's `step(dt)`.
226
+ const wall = ui.paused || ui.frozen ? 0 : Math.min(dt, MAX_STEP);
227
+ const step = wall + (ui.paused ? 0 : ui.stepRequest);
228
+ advance(ui, step);
229
+
230
+ const flash = safe ? 0 : flashAt(elapsed - strikeAt);
231
+ if (pendingThunderAt >= 0 && elapsed >= pendingThunderAt) pendingThunderAt = -1;
232
+
233
+ rig.update(wall, elapsed, frameCtx.input, cinematic);
234
+ // The rig only learns it is being driven once it has run, so the published flag is settled
235
+ // after it: a hand on the camera ends the orbit on the same frame it happened.
236
+ if (rig.manual) cinematic = false;
237
+ // Both passes read the weather this frame has just eased towards, not the target the UI
238
+ // asked for, so a drop and a lens bead are lit by the same air the coast is drawn with.
239
+ rain.update({ elapsed, flash, weather, quality: ui.quality });
240
+ lightning.update(flash);
241
+ post.update({
242
+ elapsed,
243
+ exposure: weather.exposure,
244
+ rain: weather.rain,
245
+ droplets: ui.droplets,
246
+ });
247
+ world.update({
248
+ elapsed,
249
+ flash,
250
+ quality: ui.quality,
251
+ strike: strikePoint,
252
+ weather,
253
+ });
254
+ loading.update();
255
+ frame += 1;
256
+
257
+ // Both request flags are consumed here, so the next request is a new one.
258
+ frameCtx.state.set({
259
+ cameraReset: false,
260
+ cinematic,
261
+ cloudPass: { ...frameCtx.state.getState().cloudPass, steps: world.clouds().steps },
262
+ dropCount: rain.instanceCount,
263
+ elapsed,
264
+ flash,
265
+ fps: frameCtx.fps,
266
+ frame,
267
+ heading: rig.heading,
268
+ lastStrike,
269
+ pendingThunderAt,
270
+ position: { x: rig.position.x, y: rig.position.y, z: rig.position.z },
271
+ safe,
272
+ stepRequest: 0,
273
+ strikeRequested: false,
274
+ strikes,
275
+ status: statusOf(ui.paused, flash, weather, ui.target),
276
+ weather,
277
+ });
278
+ frameCtx.state.flush();
279
+ // Last, so the mix is written from the frame that just ran rather than the one before it:
280
+ // `getState` already carries the patch above. The pause hold itself is an intent in
281
+ // `game.ts`, so the sound stops on the press rather than a frame later.
282
+ audio.update(frameCtx.state.getState());
283
+ };
284
+ }
285
+
286
+ /**
287
+ * The launch and the cloud target, published from the render hook rather than the simulation
288
+ * frame: a frame is drawn whether or not the clock moved (a paused or tick-driven run draws
289
+ * without simulating), the loading curtain must lift on the frame that shows the storm, and the
290
+ * cloud target is only resized by the render itself. "Ready" is the canvas loading screen in
291
+ * `src/render/loading.ts` having lifted, so the interface and the world appear together.
292
+ */
293
+ override render(ctx: WeatherCtx): void {
294
+ const progress = ctx.startup.progress;
295
+ // The interface's curtain lifts with the engine's own loading screen, on the same frame.
296
+ const ready = this.#curtainLifted?.() ?? false;
297
+ const current = ctx.state.getState();
298
+ // Read after the frame was drawn, so it is the target the cloud pass really rendered into.
299
+ const clouds = this.#measureClouds?.() ?? current.cloudPass;
300
+ // Steps are the frame's own (set by the tier this frame simulated); the size is the render's.
301
+ const same =
302
+ current.loading.ready === ready &&
303
+ current.loading.progress === progress &&
304
+ current.cloudPass.width === clouds.width &&
305
+ current.cloudPass.height === clouds.height;
306
+ if (same) return;
307
+ ctx.state.set({
308
+ cloudPass: { ...current.cloudPass, height: clouds.height, width: clouds.width },
309
+ loading: { progress, ready },
310
+ });
311
+ ctx.state.flush();
312
+ }
313
+
314
+ /** The scene is leaving: both passes were built here, so both are released here. */
315
+ override exit(): void {
316
+ this.#rain?.dispose();
317
+ this.#post?.dispose();
318
+ this.#lightning?.dispose();
319
+ this.#rain = undefined;
320
+ this.#post = undefined;
321
+ this.#lightning = undefined;
322
+ }
323
+ }
324
+
325
+ /** Derived from the frame that just ran, so the label cannot describe a frame that is over. */
326
+ function statusOf(paused: boolean, flash: number, weather: Weather, target: Weather): SimStatus {
327
+ if (paused) return "paused";
328
+ if (flash > 0.003) return "flashing";
329
+ return settled(weather, target) ? "steady" : "settling";
330
+ }
331
+
332
+ function settled(current: Weather, target: Weather): boolean {
333
+ return WEATHER_KEYS.every((key) => Math.abs(current[key] - target[key]) < SETTLED);
334
+ }