create-threenative 0.2.9 → 0.2.12

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 (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +229 -36
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +17 -11
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +16 -10
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +17 -11
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +17 -11
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +17 -11
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +16 -10
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +16 -10
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +17 -11
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +17 -11
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +17 -11
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +17 -11
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +53 -34
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +17 -11
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -7,7 +7,7 @@
7
7
  // The shader is the coast: terrain, road, sea, the rail and cabin on it, wet reflections and the
8
8
  // fog that closes the distance. It is raymarched, so it is one full-screen quad and one function
9
9
  // call — see src/render/world.ts for the uniforms and the camera basis it expects.
10
- import { DataTexture, Vector2, Vector3, Vector4 } from "three";
10
+ import { DataTexture, Vector3, Vector4 } from "three";
11
11
  import {
12
12
  Break,
13
13
  Fn,
@@ -33,7 +33,6 @@ import {
33
33
  mix,
34
34
  mul,
35
35
  normalize,
36
- oneMinus,
37
36
  pow,
38
37
  property,
39
38
  reflect,
@@ -79,6 +78,21 @@ export function setSky(value: TextureNode): void {
79
78
  uSky = value;
80
79
  }
81
80
  export const uReflect = uniform(0, "int").setGroup(frameGroup);
81
+ const uHeightPlaceholder = new DataTexture(new Uint8Array([0, 0, 0, 255]), 1, 1);
82
+ uHeightPlaceholder.needsUpdate = true;
83
+ export let uHeight: TextureNode = texture(uHeightPlaceholder).setGroup(frameGroup);
84
+ export function setHeight(value: TextureNode): void {
85
+ uHeight = value;
86
+ }
87
+ export const uHeightGrid = uniform(new Vector4(), "vec4").setGroup(frameGroup);
88
+ export const uHeightMargin = uniform(0, "float").setGroup(frameGroup);
89
+ const uBasePlaceholder = new DataTexture(new Uint8Array([0, 0, 0, 255]), 1, 1);
90
+ uBasePlaceholder.needsUpdate = true;
91
+ export let uBase: TextureNode = texture(uBasePlaceholder).setGroup(frameGroup);
92
+ export function setBase(value: TextureNode): void {
93
+ uBase = value;
94
+ }
95
+ export const uBaseGrid = uniform(new Vector3(), "vec3").setGroup(frameGroup);
82
96
 
83
97
  // Three.js Transpiler r185
84
98
 
@@ -210,121 +224,265 @@ export const choose = /*@__PURE__*/ Fn(([a, b]: [Node<"vec2">, Node<"vec2">]) =>
210
224
  return select(a.x.lessThan(b.x), a, b);
211
225
  });
212
226
 
213
- export const sceneMap = /*@__PURE__*/ Fn(([p]: [Node<"vec3">]) => {
214
- const h = terrain(p.xz).toVar();
215
- const res = vec2(p.y.sub(select(h.greaterThan(1), h, -3.5)).mul(0.58), 1).toVar();
227
+ // One bounded procedural tree per spatial cell; crowns fit inside their cells.
216
228
 
217
- // One bounded procedural tree per spatial cell; crowns fit inside their cells.
229
+ export const treeCell = /*@__PURE__*/ Fn(([p]: [Node<"vec2">]) => {
230
+ return floor(p.add(vec2(2, 1)).div(10.5));
231
+ });
218
232
 
219
- const cell = floor(p.xz.add(vec2(2, 1)).div(10.5)).toVar();
220
- const seed = hash12(cell.add(17)).toVar();
221
- const tc = cell
233
+ export const treeCentre = /*@__PURE__*/ Fn(([cell]: [Node<"vec2">]) => {
234
+ return cell
222
235
  .add(0.5)
223
236
  .mul(10.5)
224
237
  .sub(vec2(2, 1))
225
238
  .add(vec2(hash12(cell.add(3)), hash12(cell.add(7))).mul(0.9))
226
- .sub(0.45)
227
- .toVar();
228
- const th = terrain(tc).toVar();
239
+ .sub(0.45);
240
+ });
241
+
242
+ // The ground under a cell's tree, or 1e4 when the cell grows none. terrain() is the costliest call
243
+ // in the march, so it runs only for a cell the cheap tests admit, and trace() asks once per cell.
244
+
245
+ export const treeBase = /*@__PURE__*/ Fn(([cell]: [Node<"vec2">]) => {
246
+ const seed = hash12(cell.add(17)).toVar();
247
+ const tc = treeCentre(cell).toVar();
229
248
  const rel = tc.x.sub(roadCenter(tc.y)).toVar();
230
- const forest = rel
231
- .lessThan(-9)
232
- .or(tc.y.lessThan(-175))
233
- .and(th.greaterThan(-0.2))
234
- .and(th.lessThan(115))
235
- .and(seed.greaterThan(0.15))
236
- .and(tc.y.lessThan(-12).or(tc.x.lessThan(-45)))
237
- .toVar();
249
+ const th = float(1e4).toVar();
250
+
251
+ If(
252
+ rel
253
+ .lessThan(-9)
254
+ .or(tc.y.lessThan(-175))
255
+ .and(seed.greaterThan(0.15))
256
+ .and(tc.y.lessThan(-12).or(tc.x.lessThan(-45))),
257
+ () => {
258
+ const g = terrain(tc).toVar();
259
+
260
+ If(g.greaterThan(-0.2).and(g.lessThan(115)), () => {
261
+ th.assign(g);
262
+ });
263
+ },
264
+ );
238
265
 
239
- If(forest, () => {
240
- const q = p.sub(vec3(tc.x, th, tc.y)).toVar();
241
- const ht = add(6, seed.mul(13)).toVar();
242
- const cy = clamp(q.y.div(ht), 0, 1).toVar();
243
- const angle = atan(q.z, q.x).toVar();
244
- const tier = add(0.77, mul(0.23, sin(q.y.mul(3.5).add(seed.mul(13))))).toVar();
245
- const r = sub(1, cy)
246
- .mul(add(2, seed.mul(1.45)))
247
- .mul(tier)
248
- .toVar();
249
- r.mulAssign(
250
- add(0.88, mul(0.12, sin(angle.mul(9).add(q.y.mul(2.7))))).add(
251
- mul(0.07, sin(angle.mul(19).sub(q.y.mul(6)))),
252
- ),
253
- );
254
- const needle = noise2(q.xz.mul(6).add(q.y.mul(2)))
255
- .sub(0.5)
256
- .mul(0.18)
257
- .mul(sub(1, cy))
258
- .toVar();
259
- const d = max(length(q.xz).sub(r).add(needle), max(sub(0.8, q.y), q.y.sub(ht)))
260
- .mul(0.67)
261
- .toVar();
262
- res.assign(choose(res, vec2(d, 2)));
263
- res.assign(
264
- choose(
265
- res,
266
- vec2(
267
- max(length(q.xz).sub(mul(0.13, sub(1, cy.mul(0.65)))), max(q.y.negate(), q.y.sub(ht))),
268
- 3,
269
- ),
270
- ),
266
+ return th;
267
+ });
268
+
269
+ // The march reads a hill only where it rises above 1 m, else the -3.5 floor. Each hill's weight times
270
+ // its largest height (the noises stay below 1) bounds it, so a point no hill can lift past 1 m skips
271
+ // terrain()'s five noises and gets the same floor it would have.
272
+ // terrain() is static, so src/render/world.ts caches it every frame in two small passes: `uHeight` holds
273
+ // it on a camera-centred grid, and `uBase` holds every nearby tree cell's base. A cached height is
274
+ // only an estimate between its texels, so it stands in for terrain() only as an upper bound,
275
+ // `uHeightMargin` above the sample: a point that bound puts under 1 m gets the floor, a point more
276
+ // than 2 m above it steps as if the hill reached the bound (a shorter step, never through the
277
+ // ground), and any point nearer the ground calls terrain() itself, so every hit and every normal
278
+ // still lands on the exact surface. Only the 148-step coast trace reads the bound (`bounded`): the
279
+ // 36-step reflection march would run out of steps on the shorter ones and reflect sky for hillside.
280
+
281
+ export const heightBound = /*@__PURE__*/ Fn(([p]: [Node<"vec2">]) => {
282
+ const g = p.sub(uHeightGrid.xy).div(uHeightGrid.zw).toVar();
283
+ const bound = float(1e4).toVar();
284
+
285
+ If(
286
+ g.x
287
+ .greaterThan(0.002)
288
+ .and(g.y.greaterThan(0.002))
289
+ .and(g.x.lessThan(0.998))
290
+ .and(g.y.lessThan(0.998)),
291
+ () => {
292
+ bound.assign(uHeight.sample(vec2(g.x, g.y.oneMinus())).r.add(uHeightMargin));
293
+ },
294
+ );
295
+
296
+ return bound;
297
+ });
298
+
299
+ export const hillHeight = /*@__PURE__*/ Fn(
300
+ ([p, y, bounded]: [Node<"vec2">, Node<"float">, Node<"float">]) => {
301
+ const di = p.sub(vec2(94, -205)).div(vec2(39, 48)).toVar();
302
+ const h = float(-3.5).toVar();
303
+
304
+ If(
305
+ smoothstep(13, 155, p.x.negate())
306
+ .mul(183)
307
+ .greaterThan(1)
308
+ .or(smoothstep(280, 670, p.y.negate()).mul(223).greaterThan(1))
309
+ .or(smoothstep(190, 430, p.x).mul(125).greaterThan(1))
310
+ .or(exp(dot(di, di).negate()).mul(28).greaterThan(1)),
311
+ () => {
312
+ const bound = select(bounded.greaterThan(0.5), heightBound(p), 1e4).toVar();
313
+
314
+ If(bound.greaterThan(1), () => {
315
+ If(y.sub(bound).greaterThan(2), () => {
316
+ h.assign(bound);
317
+ }).Else(() => {
318
+ const g = terrain(p).toVar();
319
+
320
+ If(g.greaterThan(1), () => {
321
+ h.assign(g);
322
+ });
323
+ });
324
+ });
325
+ },
271
326
  );
327
+
328
+ return h;
329
+ },
330
+ );
331
+
332
+ // One texel per tree cell, centred on the camera's cell: r + g is the base (split so a half-float
333
+ // target keeps it to a tenth of a millimetre) and b is 1 where the cell grows a tree.
334
+
335
+ export const baseTable = /*@__PURE__*/ Fn(([vUv]: [Node<"vec2">]) => {
336
+ const th = treeBase(uBaseGrid.xy.add(floor(vUv.mul(uBaseGrid.z)))).toVar();
337
+ const hi = floor(th.mul(4)).div(4).toVar();
338
+ const res = vec4(0, 0, 0, 1).toVar();
339
+
340
+ If(th.lessThan(1e3), () => {
341
+ res.assign(vec4(hi, th.sub(hi), 1, 1));
272
342
  });
273
343
 
274
- // Repeating steel luminaires, including their angled neck and illuminated undersides.
275
-
276
- const k = clamp(floor(p.z.negate().sub(10).div(38).add(0.5)), 0, 5).toVar();
277
- const z = float(-10).sub(k.mul(38)).toVar();
278
- const x = roadCenter(z).sub(6.35).toVar();
279
- const q = p.sub(vec3(x, 0, z)).toVar();
280
- const pole = capsule(q, vec3(0, 0, 0), vec3(0, 7.65, 0), 0.075).toVar();
281
- pole.assign(min(pole, capsule(q, vec3(0, 7.6, 0), vec3(1.6, 8.05, 0), 0.065)));
282
- pole.assign(min(pole, capsule(q, vec3(1.6, 8.05, 0), vec3(2.5, 8.05, 0), 0.055)));
283
- pole.assign(min(pole, sdBox(q.sub(vec3(2.43, 8, 0)), vec3(0.4, 0.1, 0.23))));
284
- res.assign(choose(res, vec2(pole, 4)));
285
- res.assign(choose(res, vec2(sdBox(q.sub(vec3(2.45, 7.885, 0)), vec3(0.32, 0.021, 0.175)), 6)));
286
-
287
- // Guardrail on the water side, stopping before the distant curve.
288
-
289
- If(p.z.lessThan(28).and(p.z.greaterThan(-176)), () => {
290
- const rx = roadCenter(p.z).add(6.3).toVar();
291
- const rail = sdBox(vec3(p.x.sub(rx), p.y.sub(0.84), 0), vec3(0.065, 0.13, 1000)).toVar();
292
- const postZ = floor(p.z.div(5).add(0.5)).mul(5).toVar();
293
- rail.assign(
294
- min(
295
- rail,
296
- sdBox(p.sub(vec3(roadCenter(postZ).add(6.3), 0.45, postZ)), vec3(0.055, 0.45, 0.055)),
297
- ),
298
- );
299
- res.assign(choose(res, vec2(rail, 4)));
344
+ return res;
345
+ });
346
+
347
+ export const heightTable = /*@__PURE__*/ Fn(([vUv]: [Node<"vec2">]) => {
348
+ return vec4(terrain(uHeightGrid.xy.add(vUv.mul(uHeightGrid.zw))), 0, 0, 1);
349
+ });
350
+
351
+ export const cellBase = /*@__PURE__*/ Fn(([cell]: [Node<"vec2">]) => {
352
+ const k = cell.sub(uBaseGrid.xy).toVar();
353
+ const th = float(1e4).toVar();
354
+
355
+ If(
356
+ k.x
357
+ .greaterThanEqual(0)
358
+ .and(k.y.greaterThanEqual(0))
359
+ .and(k.x.lessThan(uBaseGrid.z))
360
+ .and(k.y.lessThan(uBaseGrid.z)),
361
+ () => {
362
+ const bu = k.add(0.5).div(uBaseGrid.z).toVar();
363
+ const v = uBase.sample(vec2(bu.x, bu.y.oneMinus())).toVar();
364
+
365
+ If(v.b.greaterThan(0.5), () => {
366
+ th.assign(v.r.add(v.g));
367
+ });
368
+ },
369
+ ).Else(() => {
370
+ th.assign(treeBase(cell));
300
371
  });
301
372
 
302
- // Small roadside field station, with a lit window and antenna.
373
+ return th;
374
+ });
303
375
 
304
- const b = p.sub(vec3(-17, 1.85, -73)).toVar();
305
- const cabin = sdBox(b, vec3(3.3, 1.85, 2.65)).toVar();
306
- res.assign(choose(res, vec2(cabin, 9)));
307
- res.assign(choose(res, vec2(sdBox(p.sub(vec3(-17, 3.85, -73)), vec3(3.6, 0.14, 2.9)), 4)));
308
- res.assign(
309
- choose(res, vec2(sdBox(p.sub(vec3(-17.8, 2.1, -70.325)), vec3(0.84, 0.48, 0.028)), 6)),
310
- );
311
- res.assign(choose(res, vec2(capsule(p, vec3(-19, 3.9, -74), vec3(-19, 13, -74), 0.045), 4)));
376
+ export const sceneAt = /*@__PURE__*/ Fn(
377
+ ([p, th, bounded]: [Node<"vec3">, Node<"float">, Node<"float">]) => {
378
+ const res = vec2(p.y.sub(hillHeight(p.xz, p.y, bounded)).mul(0.58), 1).toVar();
379
+
380
+ If(th.lessThan(1e3), () => {
381
+ const cell = treeCell(p.xz).toVar();
382
+ const seed = hash12(cell.add(17)).toVar();
383
+ const tc = treeCentre(cell).toVar();
384
+ const q = p.sub(vec3(tc.x, th, tc.y)).toVar();
385
+ const ht = add(6, seed.mul(13)).toVar();
386
+ const cy = clamp(q.y.div(ht), 0, 1).toVar();
387
+ const angle = atan(q.z, q.x).toVar();
388
+ const tier = add(0.77, mul(0.23, sin(q.y.mul(3.5).add(seed.mul(13))))).toVar();
389
+ const r = sub(1, cy)
390
+ .mul(add(2, seed.mul(1.45)))
391
+ .mul(tier)
392
+ .toVar();
393
+ r.mulAssign(
394
+ add(0.88, mul(0.12, sin(angle.mul(9).add(q.y.mul(2.7))))).add(
395
+ mul(0.07, sin(angle.mul(19).sub(q.y.mul(6)))),
396
+ ),
397
+ );
398
+ const needle = noise2(q.xz.mul(6).add(q.y.mul(2)))
399
+ .sub(0.5)
400
+ .mul(0.18)
401
+ .mul(sub(1, cy))
402
+ .toVar();
403
+ const d = max(length(q.xz).sub(r).add(needle), max(sub(0.8, q.y), q.y.sub(ht)))
404
+ .mul(0.67)
405
+ .toVar();
406
+ res.assign(choose(res, vec2(d, 2)));
407
+ res.assign(
408
+ choose(
409
+ res,
410
+ vec2(
411
+ max(length(q.xz).sub(mul(0.13, sub(1, cy.mul(0.65)))), max(q.y.negate(), q.y.sub(ht))),
412
+ 3,
413
+ ),
414
+ ),
415
+ );
416
+ });
312
417
 
313
- return res;
418
+ // Repeating steel luminaires, including their angled neck and illuminated undersides.
419
+
420
+ const k = clamp(floor(p.z.negate().sub(10).div(38).add(0.5)), 0, 5).toVar();
421
+ const z = float(-10).sub(k.mul(38)).toVar();
422
+ const x = roadCenter(z).sub(6.35).toVar();
423
+ const q = p.sub(vec3(x, 0, z)).toVar();
424
+ const pole = capsule(q, vec3(0, 0, 0), vec3(0, 7.65, 0), 0.075).toVar();
425
+ pole.assign(min(pole, capsule(q, vec3(0, 7.6, 0), vec3(1.6, 8.05, 0), 0.065)));
426
+ pole.assign(min(pole, capsule(q, vec3(1.6, 8.05, 0), vec3(2.5, 8.05, 0), 0.055)));
427
+ pole.assign(min(pole, sdBox(q.sub(vec3(2.43, 8, 0)), vec3(0.4, 0.1, 0.23))));
428
+ res.assign(choose(res, vec2(pole, 4)));
429
+ res.assign(choose(res, vec2(sdBox(q.sub(vec3(2.45, 7.885, 0)), vec3(0.32, 0.021, 0.175)), 6)));
430
+
431
+ // Guardrail on the water side, stopping before the distant curve.
432
+
433
+ If(p.z.lessThan(28).and(p.z.greaterThan(-176)), () => {
434
+ const rx = roadCenter(p.z).add(6.3).toVar();
435
+ const rail = sdBox(vec3(p.x.sub(rx), p.y.sub(0.84), 0), vec3(0.065, 0.13, 1000)).toVar();
436
+ const postZ = floor(p.z.div(5).add(0.5)).mul(5).toVar();
437
+ rail.assign(
438
+ min(
439
+ rail,
440
+ sdBox(p.sub(vec3(roadCenter(postZ).add(6.3), 0.45, postZ)), vec3(0.055, 0.45, 0.055)),
441
+ ),
442
+ );
443
+ res.assign(choose(res, vec2(rail, 4)));
444
+ });
445
+
446
+ // Small roadside field station, with a lit window and antenna.
447
+
448
+ const b = p.sub(vec3(-17, 1.85, -73)).toVar();
449
+ const cabin = sdBox(b, vec3(3.3, 1.85, 2.65)).toVar();
450
+ res.assign(choose(res, vec2(cabin, 9)));
451
+ res.assign(choose(res, vec2(sdBox(p.sub(vec3(-17, 3.85, -73)), vec3(3.6, 0.14, 2.9)), 4)));
452
+ res.assign(
453
+ choose(res, vec2(sdBox(p.sub(vec3(-17.8, 2.1, -70.325)), vec3(0.84, 0.48, 0.028)), 6)),
454
+ );
455
+ res.assign(choose(res, vec2(capsule(p, vec3(-19, 3.9, -74), vec3(-19, 13, -74), 0.045), 4)));
456
+
457
+ return res;
458
+ },
459
+ );
460
+
461
+ export const sceneMap = /*@__PURE__*/ Fn(([p]: [Node<"vec3">]) => {
462
+ return sceneAt(p, cellBase(treeCell(p.xz)), 0);
314
463
  });
315
464
 
316
465
  export const trace = /*@__PURE__*/ Fn(
317
466
  ([ro, rd, limit]: [Node<"vec3">, Node<"vec3">, Node<"float">]) => {
318
467
  const t = float(0.25).toVar();
319
468
  const mat = float(-1).toVar();
469
+ const lastCell = vec2(1e9).toVar();
470
+ const th = float(1e4).toVar();
320
471
 
321
- Loop({ start: int(0), end: 148 }, ({ i }) => {
472
+ Loop({ start: int(0), end: 148 }, () => {
322
473
  If(t.greaterThan(limit).or(t.greaterThan(1850)), () => {
323
474
  Break();
324
475
  });
325
476
 
326
477
  const p = ro.add(rd.mul(t)).toVar();
327
- const d = sceneMap(p).toVar();
478
+ const cell = treeCell(p.xz).toVar();
479
+
480
+ If(cell.x.notEqual(lastCell.x).or(cell.y.notEqual(lastCell.y)), () => {
481
+ th.assign(cellBase(cell));
482
+ lastCell.assign(cell);
483
+ });
484
+
485
+ const d = sceneAt(p, th, 1).toVar();
328
486
  const eps = max(0.007, t.mul(0.00048)).toVar();
329
487
 
330
488
  If(d.x.lessThan(eps), () => {
@@ -345,16 +503,33 @@ export const trace = /*@__PURE__*/ Fn(
345
503
  },
346
504
  );
347
505
 
506
+ // The scene at a normal tap: its cell's tree base is the hit's own unless the tap crossed a cell edge.
507
+
508
+ export const tapScene = /*@__PURE__*/ Fn(
509
+ ([q, hitCell, hitBase]: [Node<"vec3">, Node<"vec2">, Node<"float">]) => {
510
+ const c = treeCell(q.xz).toVar();
511
+ const th = hitBase.toVar();
512
+
513
+ If(c.x.notEqual(hitCell.x).or(c.y.notEqual(hitCell.y)), () => {
514
+ th.assign(cellBase(c));
515
+ });
516
+
517
+ return sceneAt(q, th, 0).x;
518
+ },
519
+ );
520
+
348
521
  export const getNormal = /*@__PURE__*/ Fn(([p, t]: [Node<"vec3">, Node<"float">]) => {
349
522
  const e = max(0.008, t.mul(0.00032)).toVar();
350
523
  const k = vec2(1, -1).mul(0.5773).toVar();
524
+ const hc = treeCell(p.xz).toVar();
525
+ const hb = cellBase(hc).toVar();
351
526
 
352
527
  return normalize(
353
528
  k.xyy
354
- .mul(sceneMap(p.add(k.xyy.mul(e))).x)
355
- .add(k.yyx.mul(sceneMap(p.add(k.yyx.mul(e))).x))
356
- .add(k.yxy.mul(sceneMap(p.add(k.yxy.mul(e))).x))
357
- .add(k.xxx.mul(sceneMap(p.add(k.xxx.mul(e))).x)),
529
+ .mul(tapScene(p.add(k.xyy.mul(e)), hc, hb))
530
+ .add(k.yyx.mul(tapScene(p.add(k.yyx.mul(e)), hc, hb)))
531
+ .add(k.yxy.mul(tapScene(p.add(k.yxy.mul(e)), hc, hb)))
532
+ .add(k.xxx.mul(tapScene(p.add(k.xxx.mul(e)), hc, hb))),
358
533
  );
359
534
  });
360
535
 
@@ -431,7 +606,7 @@ export const surfaceLight = /*@__PURE__*/ Fn(
431
606
  const dist2 = dot(l, l).toVar();
432
607
  l.assign(normalize(l));
433
608
  const ndl = max(dot(n, l), 0).toVar();
434
- const cone = smoothstep(0.1, 0.62, l.y.negate())
609
+ const _cone = smoothstep(0.1, 0.62, l.y.negate())
435
610
  .mul(smoothstep(-0.1, 0.1, l.y))
436
611
  .toVar();
437
612
  const atten = div(48, add(1, dist2)).toVar();
@@ -501,14 +676,23 @@ export const reflected = /*@__PURE__*/ Fn(
501
676
 
502
677
  If(uReflect.notEqual(0), () => {
503
678
  const t = float(0.5).toVar();
679
+ const lastCell = vec2(1e9).toVar();
680
+ const th = float(1e4).toVar();
504
681
 
505
- Loop({ start: int(0), end: 36 }, ({ i }) => {
682
+ Loop({ start: int(0), end: 36 }, () => {
506
683
  If(t.greaterThan(280), () => {
507
684
  Break();
508
685
  });
509
686
 
510
687
  const q = p.add(rd.mul(t)).toVar();
511
- const d = sceneMap(q).toVar();
688
+ const cell = treeCell(q.xz).toVar();
689
+
690
+ If(cell.x.notEqual(lastCell.x).or(cell.y.notEqual(lastCell.y)), () => {
691
+ th.assign(cellBase(cell));
692
+ lastCell.assign(cell);
693
+ });
694
+
695
+ const d = sceneAt(q, th, 0).toVar();
512
696
 
513
697
  If(d.x.lessThan(max(0.03, t.mul(0.0016))), () => {
514
698
  If(d.y.greaterThan(5.5).and(d.y.lessThan(6.5)), () => {
@@ -9,15 +9,18 @@
9
9
  //
10
10
  // Conventions: one world unit is one metre, +x is out to sea, -z runs down the coast.
11
11
  import {
12
+ type Camera,
12
13
  DoubleSide,
13
14
  Mesh,
15
+ OrthographicCamera,
14
16
  type PerspectiveCamera,
15
17
  PlaneGeometry,
16
- type Scene,
18
+ Scene,
17
19
  Vector3,
18
20
  } from "three";
19
21
  import { cameraFar, cameraNear, clamp, float, positionGeometry, uv, vec4 } from "three/tsl";
20
- import { MeshBasicNodeMaterial } from "three/webgpu";
22
+ import type { Node } from "three/webgpu";
23
+ import { MeshBasicNodeMaterial, PassNode } from "three/webgpu";
21
24
  import type { QualityName, Weather } from "../state.js";
22
25
  import { type ICloudPass, createCloudPass } from "./clouds.js";
23
26
  import { setupLighting } from "./lighting.js";
@@ -25,12 +28,19 @@ import { setupMaterials } from "./materials.js";
25
28
  import { studyTier } from "./quality.js";
26
29
  import { setupSky } from "./sky.js";
27
30
  import {
31
+ baseTable,
32
+ heightTable,
33
+ setBase,
34
+ setHeight,
28
35
  tempestWorld,
29
36
  uAspect,
37
+ uBaseGrid,
30
38
  uCam,
31
39
  uFlash,
32
40
  uFog,
33
41
  uForward,
42
+ uHeightGrid,
43
+ uHeightMargin,
34
44
  uRain,
35
45
  uReflect,
36
46
  uRight,
@@ -41,6 +51,54 @@ import {
41
51
  uWet,
42
52
  } from "./world-shader.js";
43
53
 
54
+ // terrain() is the march's costliest call and it never changes, so it is cached every frame in two
55
+ // small passes the coast samples instead (see `hillHeight` and `cellBase` in tempest-world.frag).
56
+ // The grids follow the camera and reach as far as the march does (1850 m).
57
+ /** Texels per side of the cached heightmap, and the metres it spans: 3.6 m between samples. */
58
+ const HEIGHT_TEXELS = 1024;
59
+ const HEIGHT_SPAN = 3700;
60
+ /**
61
+ * Metres added to a cached height so it bounds terrain() from above. Between its texels the cache
62
+ * reads at most 2.61 m below the true height (18,000,000 random points at 3.6 m, half-float storage,
63
+ * the road cut and the coast step included), so 4 m keeps every hit on the exact surface.
64
+ */
65
+ const HEIGHT_MARGIN = 4;
66
+ /** Tree cells per side of the base table: 360 cells of 10.5 m, 1890 m each way. */
67
+ const BASE_CELLS = 360;
68
+ /** The tree grid of `treeCell` in tempest-world.frag: 10.5 m cells offset by (2, 1) m. */
69
+ const CELL_SIZE = 10.5;
70
+
71
+ /** A pass whose target keeps one size, whatever the drawing buffer is: a table, not a picture. */
72
+ class TablePass extends PassNode {
73
+ side = 1;
74
+ override setSize(): void {
75
+ super.setSize(this.side ?? 1, this.side ?? 1);
76
+ }
77
+ }
78
+
79
+ function tablePass(fragment: Node, side: number): { pass: TablePass; dispose(): void } {
80
+ const scene = new Scene();
81
+ const camera: Camera = new OrthographicCamera(-1, 1, 1, -1, 0, 1);
82
+ const geometry = new PlaneGeometry(2, 2);
83
+ const material = new MeshBasicNodeMaterial();
84
+ material.side = DoubleSide;
85
+ material.vertexNode = vec4(positionGeometry.xy, 0, 1);
86
+ material.fragmentNode = fragment;
87
+ const quad = new Mesh(geometry, material);
88
+ quad.frustumCulled = false;
89
+ scene.add(quad);
90
+ const pass = new TablePass(PassNode.COLOR, scene, camera, { depthBuffer: false, samples: 0 });
91
+ pass.side = side;
92
+ return {
93
+ pass,
94
+ dispose(): void {
95
+ pass.dispose();
96
+ geometry.dispose();
97
+ material.dispose();
98
+ },
99
+ };
100
+ }
101
+
44
102
  export interface IWeatherWorldOptions {
45
103
  /** Absolute seconds, so the weather phase does not depend on how the frame was scheduled. */
46
104
  readonly elapsed: number;
@@ -75,6 +133,13 @@ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWe
75
133
  setupLighting();
76
134
  setupMaterials();
77
135
 
136
+ // Bound before the coast's graph is built, the same order as the cloud pass and for the same reason.
137
+ const heights = tablePass(heightTable(uv()), HEIGHT_TEXELS);
138
+ setHeight(heights.pass.getTextureNode());
139
+ const bases = tablePass(baseTable(uv()), BASE_CELLS);
140
+ setBase(bases.pass.getTextureNode());
141
+ uHeightMargin.value = HEIGHT_MARGIN;
142
+
78
143
  const world = tempestWorld(uv());
79
144
  // The shader's own depth is a curve fitted to the source's camera; the closed form is reversible,
80
145
  // so the engine's near/far decide the real clip depth and anything drawn after this quad — rain,
@@ -116,6 +181,8 @@ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWe
116
181
  geometry.dispose();
117
182
  material.dispose();
118
183
  clouds.dispose();
184
+ heights.dispose();
185
+ bases.dispose();
119
186
  },
120
187
  update({ elapsed, flash, quality, strike, weather }): void {
121
188
  // The camera basis the shader raymarches from: the same three axes the renderer draws with,
@@ -130,6 +197,19 @@ export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWe
130
197
  uAspect.value = camera.aspect;
131
198
  uTan.value = Math.tan((camera.fov * Math.PI) / 360);
132
199
  uTime.value = elapsed;
200
+ // Both caches centre on the camera, snapped to their own grid so a cached value stays put.
201
+ const step = HEIGHT_SPAN / HEIGHT_TEXELS;
202
+ uHeightGrid.value.set(
203
+ Math.floor(camera.position.x / step) * step - HEIGHT_SPAN / 2,
204
+ Math.floor(camera.position.z / step) * step - HEIGHT_SPAN / 2,
205
+ HEIGHT_SPAN,
206
+ HEIGHT_SPAN,
207
+ );
208
+ uBaseGrid.value.set(
209
+ Math.floor((camera.position.x + 2) / CELL_SIZE) - BASE_CELLS / 2,
210
+ Math.floor((camera.position.z + 1) / CELL_SIZE) - BASE_CELLS / 2,
211
+ BASE_CELLS,
212
+ );
133
213
 
134
214
  uRain.value = weather.rain;
135
215
  uFog.value = weather.fog;
@@ -213,7 +213,7 @@ select:focus-visible {
213
213
  transform: translateX(-50%);
214
214
  width: 206px;
215
215
  text-align: center;
216
- color: #c9d6d460;
216
+ color: #c9d6d480;
217
217
  }
218
218
 
219
219
  .compass .letters {
@@ -1,4 +1,4 @@
1
- import { UiLayer, useUiIntent, useUiState } from "@threenative/ui";
1
+ import { UiLayer, useUiIntent, useUiStateDuringStartup } from "@threenative/ui";
2
2
  import { useCallback, useEffect, useRef, useState } from "react";
3
3
  import { type GameState, VISIBILITY_INTENT } from "../state.js";
4
4
  import { Hud, captureScene, toggleFullscreen } from "./Hud.js";
@@ -27,7 +27,11 @@ export function GameUi() {
27
27
  * defaults that have to be applied against a real snapshot rather than guessed at mount.
28
28
  */
29
29
  function RainInterface() {
30
- const state = useUiState<GameState>();
30
+ // The staged TEMPEST curtain below is this page's own loading screen, so it reads state while the
31
+ // engine's cover is up.
32
+ const state = useUiStateDuringStartup<GameState>({
33
+ reason: "draws its own staged loading overlay",
34
+ });
31
35
  const send = useUiIntent();
32
36
  const [toast, setToast] = useState("");
33
37
  const [toastVisible, setToastVisible] = useState(false);
@@ -196,7 +196,7 @@ export function Hud({ send, say, panelOpen, setPanelOpen, state, toast, toastVis
196
196
  aria-label="Save scene image"
197
197
  className="icon-btn desktop"
198
198
  data-tn-interactive
199
- onClick={() => captureScene(say)}
199
+ onClick={() => void captureScene(say)}
200
200
  title="Save scene image [P]"
201
201
  type="button"
202
202
  >
@@ -117,8 +117,8 @@ const SHADERS = [
117
117
  // because a flip on one and not the other would put the reflections somewhere the sky they
118
118
  // mirror is not.
119
119
  what: "the pass-texture sample coordinate",
120
- find: /uSky\.sample\(\s*(\w+)\s*\)/g,
121
- replace: "uSky.sample(vec2($1.x,$1.y.oneMinus()))",
120
+ find: /(uSky|uHeight|uBase)\.sample\(\s*(\w+)\s*\)/g,
121
+ replace: "$1.sample(vec2($2.x,$2.y.oneMinus()))",
122
122
  imports: ["oneMinus"],
123
123
  },
124
124
  ],