create-threenative 0.2.10 → 0.2.13

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 +227 -34
  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 +15 -10
  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 +14 -9
  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 +15 -10
  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 +15 -10
  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 +15 -10
  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 +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  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 +14 -9
  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 +14 -9
  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 +15 -10
  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 +15 -10
  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 +15 -10
  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 +15 -10
  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 +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -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 +27 -14
  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 +15 -10
  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
@@ -1,3 +1,8 @@
1
+ import {
2
+ type IWorldEnvironmentOptions,
3
+ qualityPreset as coreQualityPreset,
4
+ qualityTiers,
5
+ } from "@threenative/core";
1
6
  // Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
2
7
  // it freely — the tiers below are a starting point, not a framework look.
3
8
  //
@@ -5,9 +10,9 @@
5
10
  //
6
11
  // - `low` / `medium` / `high` are the engine render chain's tiers, which `postprocessing.ts` reads
7
12
  // through `qualityPreset(resolveQualityTier(...))`. This study turns **every built-in stage off at
8
- // every tier**: its bloom, ACES grade, vignette, lens beads and dither are the source study's own
9
- // single post pass, installed as one authored stage, so a built-in bloom or tone map would do the
10
- // same job a second time. What differs is the rung the chain reports and runs at
13
+ // every tier**: its bloom, grade, vignette, lens beads and dither are the source study's own
14
+ // single post pass, installed as one authored stage, so a built-in bloom would do the
15
+ // same job a second time; the tone map and the exposure are the core's. What differs is the rung the chain reports and runs at
11
16
  // (`renderChainTier`), so a stage you add later with a `minimumTier` drops out on the cheap tiers.
12
17
  // - `STUDY_TIERS` is the player's "Render quality" select — the reference study's own four tiers,
13
18
  // `performance` / `balanced` / `high` / `ultra`, number for number: the cloud pass's resolution
@@ -15,110 +20,51 @@
15
20
  // march. The drawing buffer itself is the engine's adaptive resolution (`resolutionScale: "auto"`
16
21
  // in `threenative.config.ts`), which measures the frame instead of trusting a fixed table.
17
22
  import type { QualityName } from "../state.js";
18
- import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
+ import { exposureSettings } from "./exposure.js";
24
+ export type { QualityTier } from "@threenative/core";
19
25
 
20
26
  /**
21
27
  * The engine chain's three tier names. `low` is what a phone gets and `high` what a desktop gets;
22
28
  * for this study all three are the same empty chain — see the note at the top of this file.
23
29
  */
24
- export type QualityTier = "low" | "medium" | "high";
25
-
26
- const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
27
-
28
- /**
29
- * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
30
- * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
31
- */
32
- function isQualityTier(value: string): value is QualityTier {
33
- return (QUALITY_TIERS as readonly string[]).includes(value);
34
- }
35
-
36
- /**
37
- * Where each GPU family starts, from `ctx.renderer.gpuClass`.
38
- *
39
- * A start, not a ceiling: the measured frame-budget windows move the look from here, and an
40
- * explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
41
- * family rule matched — falls back to the `mobile` flag, exactly as before families existed.
42
- * Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
43
- */
44
- const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
45
- software: "low",
46
- "mobile-low": "low",
47
- "mobile-mid": "low",
48
- "mobile-high": "medium",
49
- integrated: "medium",
50
- discrete: "high",
51
- };
52
-
53
- /**
54
- * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
55
- *
56
- * Fails closed. An unrecognised tier name throws with the value it was handed rather than
57
- * quietly rendering the default, because a silent fallback here looks exactly like a tier that
58
- * turned out to have no effect.
59
- */
60
- export function resolveQualityTier(
61
- request: {
62
- readonly gpuClass?: string;
63
- readonly mobile?: boolean;
64
- readonly software?: boolean;
65
- readonly tier?: string;
66
- } = {},
67
- ): QualityTier {
68
- const requested = request.tier;
69
- if (requested !== undefined) {
70
- if (!isQualityTier(requested)) {
71
- throw new Error(
72
- `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
73
- );
74
- }
75
- return requested;
76
- }
77
- // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
78
- // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
79
- // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
80
- // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
81
- // `tier` above still wins over it.
82
- if (request.software === true) return "low";
83
- const family =
84
- request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
85
- if (family !== undefined) return family;
86
- return request.mobile === true ? "low" : "high";
87
- }
30
+ export const resolveQualityTier = qualityTiers.resolve;
88
31
 
89
32
  /**
90
- * What a desktop gets from the engine chain: no built-in stage, so there is no cost to record beside
91
- * one; the storm's own post pass is costed in `STUDY_TIERS` below.
33
+ * The stages and strengths a tier turns on: the core preset, this game's exposure policy and one
34
+ * named override, reported on the `TN_RENDER_CHAIN_COST_OVERRIDE` console line. Every built-in
35
+ * stage is off: the storm's own post pass draws the bloom, the grade, the vignette, the lens beads
36
+ * and the dither, so a built-in stage would do the same job twice. What the core keeps is the Unreal
37
+ * filmic curve and the metered exposure, which the post pass no longer implements itself.
92
38
  */
93
- const high: IWorldEnvironmentOptions = {
94
- bloomEnabled: false,
95
- denoiseEnabled: false,
96
- // The post pass applies the weather's exposure itself, after its own bloom add.
97
- autoExposureEnabled: false,
98
- exposure: 1,
99
- renderChainTier: "high",
100
- ssgiEnabled: false,
101
- ssrEnabled: false,
102
- tonemapMode: "aces",
103
- };
104
-
105
- /** The rung in between: the same empty chain, run and reported at `medium`. */
106
- const medium: IWorldEnvironmentOptions = { ...high, renderChainTier: "medium" };
107
-
108
- /** What a phone gets: the same empty chain at `low`; the `performance` study tier is the cheap look. */
109
- const low: IWorldEnvironmentOptions = { ...high, renderChainTier: "low" };
110
-
111
- const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
112
-
113
- /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
114
39
  export function qualityPreset(tier: string): IWorldEnvironmentOptions {
115
- const preset = QUALITY_PRESETS[tier as QualityTier];
116
- if (preset === undefined) {
117
- throw new Error(
118
- `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
119
- );
120
- }
121
- return preset;
40
+ const stagesOff = {
41
+ bloomEnabled: false,
42
+ denoiseEnabled: false,
43
+ finalGatherMethod: "none",
44
+ gtaoEnabled: false,
45
+ localExposureEnabled: false,
46
+ motionBlurEnabled: false,
47
+ sharpenEnabled: false,
48
+ ssgiEnabled: false,
49
+ ssrEnabled: false,
50
+ // This study keeps 4x multisampling: a temporal pass would add a second chain around its post pass.
51
+ temporalAA: false,
52
+ unrealBloomEnabled: false,
53
+ vignetteAmount: 0,
54
+ } as const satisfies IWorldEnvironmentOptions;
55
+ console.info(
56
+ `TN_RENDER_CHAIN_COST_OVERRIDE ${JSON.stringify({
57
+ reason:
58
+ "Rain: the storm's own post pass draws bloom, grade, vignette, lens beads and dither; a built-in stage would do the same job twice",
59
+ ...stagesOff,
60
+ })}`,
61
+ );
62
+ return {
63
+ ...coreQualityPreset(tier),
64
+ ...stagesOff,
65
+ exposurePolicy: exposureSettings,
66
+ samples: 4,
67
+ };
122
68
  }
123
69
 
124
70
  /** One rung of the player's quality select. Every number is the reference study's own. */
@@ -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)), () => {