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
@@ -0,0 +1,744 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The island's planting: a meadow of tall grass combed by travelling gusts, broadleaf trees and
4
+ // white birches whose crowns are hundreds of leaf cards, leafy bushes along two hedge arcs, clumps
5
+ // of red, orange, white and yellow flowers, butterflies, pebbles on the path and stones in the
6
+ // grass, and the islet's beach. The leaves are cut out of one leaf-cluster texture painted in code
7
+ // and use Unreal's Two Sided Foliage shading (`twoSidedFoliage`), so the low sun shines through a
8
+ // crown seen against it. The bark is the photo textures in `assets/` (`tex-*.webp`). Every kind is one
9
+ // `InstancedMesh` (the grass one per 12 m cell, so the camera culls what it does not see), and
10
+ // every plant stands on the terrain's own height or on a drum's lawn. Nothing here is solid: the
11
+ // hero walks through a bush as it walks through a tree trunk, and the course's metres stay the
12
+ // course's. Placement is seeded and asks the course where planting may go (`clear`).
13
+ import {
14
+ BufferAttribute,
15
+ BufferGeometry,
16
+ Color,
17
+ CylinderGeometry,
18
+ DataTexture,
19
+ DoubleSide,
20
+ Group,
21
+ InstancedMesh,
22
+ LatheGeometry,
23
+ LinearMipmapLinearFilter,
24
+ type Material,
25
+ Matrix4,
26
+ Mesh,
27
+ Object3D,
28
+ OctahedronGeometry,
29
+ PlaneGeometry,
30
+ Quaternion,
31
+ RGBAFormat,
32
+ RingGeometry,
33
+ SRGBColorSpace,
34
+ UnsignedByteType,
35
+ Vector2,
36
+ Vector3,
37
+ } from "three";
38
+ import {
39
+ abs,
40
+ dot,
41
+ hash,
42
+ instanceIndex,
43
+ materialColor,
44
+ positionGeometry,
45
+ positionLocal,
46
+ positionWorld,
47
+ sin,
48
+ time,
49
+ vec2,
50
+ vec3,
51
+ } from "three/tsl";
52
+ import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
53
+ import { lit, seeded } from "./materials.js";
54
+ import { C } from "./palette.js";
55
+ import { type ISurfaces, texturedMaterial } from "./surface.js";
56
+
57
+ /** x, y, z, scale x, y, z, rotation x, y, z. */
58
+ type Placement = readonly [number, number, number, number, number, number, number, number, number];
59
+
60
+ export interface IPlantingSite {
61
+ readonly rng: () => number;
62
+ /** The terrain's extent; planting stays on land inside it. */
63
+ readonly bounds: {
64
+ readonly minX: number;
65
+ readonly maxX: number;
66
+ readonly minZ: number;
67
+ readonly maxZ: number;
68
+ };
69
+ /** Whether a plant this wide may stand at (x, z): off the landmarks and the routes. */
70
+ clear(x: number, z: number, width: number): boolean;
71
+ ground(x: number, z: number): number;
72
+ /** The ground normal's up component: under 0.8 is a rock face, where nothing grows. */
73
+ flatness(x: number, z: number): number;
74
+ /** Metres from the nearest dirt path's centre line (the path is about 1.2 m each side). */
75
+ pathDistance(x: number, z: number): number;
76
+ /** Islands that get a sand-and-foam beach ring: x, z, cliff radius at the waterline. */
77
+ readonly shores: readonly (readonly [number, number, number])[];
78
+ /** Drum tops that get the meadow too: x, z, radius, lawn height. */
79
+ readonly lawns: readonly (readonly [number, number, number, number])[];
80
+ readonly seaLevel: number;
81
+ /** Share of the grass tufts drawn past the near ring, 0..1: the tier's (`GRASS_SHARE`). */
82
+ readonly grassShare: number;
83
+ readonly surfaces: ISurfaces;
84
+ }
85
+
86
+ const dummy = new Object3D();
87
+ // Yaw last: a placement leans or droops about X, then turns to face its way round Y.
88
+ dummy.rotation.order = "YXZ";
89
+
90
+ function instanced(
91
+ geometry: BufferGeometry,
92
+ material: Material,
93
+ placements: readonly Placement[],
94
+ castShadow: boolean,
95
+ tints?: readonly Color[],
96
+ ): InstancedMesh {
97
+ const mesh = new InstancedMesh(geometry, material, Math.max(1, placements.length));
98
+ mesh.count = placements.length;
99
+ placements.forEach(([x, y, z, sx, sy, sz, rx, ry, rz], i) => {
100
+ dummy.position.set(x, y, z);
101
+ dummy.scale.set(sx, sy, sz);
102
+ dummy.rotation.set(rx, ry, rz);
103
+ dummy.updateMatrix();
104
+ mesh.setMatrixAt(i, dummy.matrix);
105
+ const tint = tints?.[i];
106
+ if (tint !== undefined) mesh.setColorAt(i, tint);
107
+ });
108
+ mesh.computeBoundingSphere();
109
+ mesh.castShadow = castShadow;
110
+ mesh.receiveShadow = true;
111
+ return mesh;
112
+ }
113
+
114
+ /** The wind: one gust front travelling across the island, 0 in the lull to 1 in the gust. */
115
+ function gustAt(xz: Node<"vec2">) {
116
+ const along = dot(xz, vec2(0.21, 0.09));
117
+ return sin(along.sub(time.mul(1.4)))
118
+ .mul(sin(along.mul(0.37).sub(time.mul(0.45)).add(1.3)))
119
+ .mul(0.5)
120
+ .add(0.5);
121
+ }
122
+
123
+ /** Grass: vertices above y = 0 bend with the gust that passes over them, each tuft on its phase. */
124
+ function grassMaterial(): MeshStandardNodeMaterial {
125
+ const material = new MeshStandardNodeMaterial({
126
+ color: C.blade,
127
+ roughness: 0.75,
128
+ side: DoubleSide,
129
+ vertexColors: true,
130
+ });
131
+ const phase = hash(instanceIndex).mul(6.28);
132
+ // `positionGeometry`, not `positionLocal`: an instanced mesh's `positionLocal` already carries the
133
+ // instance matrix, so its y is the blade's height above the sea, not above its root.
134
+ const height = positionGeometry.y.max(0);
135
+ const bend = height.mul(height);
136
+ const gust = gustAt(positionLocal.xz);
137
+ const push = gust.mul(gust).mul(0.42).add(0.06);
138
+ material.positionNode = positionLocal.add(
139
+ vec3(
140
+ sin(time.mul(2.3).add(phase)).mul(0.05).add(push).mul(bend),
141
+ push.mul(bend).mul(-0.35),
142
+ sin(time.mul(1.7).add(phase.mul(1.7)))
143
+ .mul(bend)
144
+ .mul(0.06),
145
+ ),
146
+ );
147
+ // A gust lays the blades over and shows their paler, sunlit sides: the wave you see cross a field.
148
+ material.colorNode = materialColor.mul(gustAt(positionWorld.xz).mul(0.24).add(0.9));
149
+ material.twoSidedFoliage = true;
150
+ material.subsurfaceColor = new Color(0.42, 0.55, 0.12);
151
+ return material;
152
+ }
153
+
154
+ /** Blades in one grass tuft: every tuft is this many triangles. */
155
+ export const TUFT_BLADES = 14;
156
+
157
+ /**
158
+ * A clump of single-triangle blades, 1 m tall before scaling, leaning out from its centre and all
159
+ * bending one way, as wind-combed meadow grass does. Every normal points up, so a blade lights like
160
+ * the lawn it grows from, not like a dark sliver edge-on to the sun, and the vertex colour runs
161
+ * from a shaded root to a sunlit yellow-green tip.
162
+ */
163
+ function tuftGeometry(rng: () => number, blades = TUFT_BLADES): BufferGeometry {
164
+ const positions: number[] = [];
165
+ const colors: number[] = [];
166
+ for (let b = 0; b < blades; b += 1) {
167
+ const a = rng() * Math.PI * 2;
168
+ const r = Math.sqrt(rng()) * 0.3;
169
+ const x = Math.cos(a) * r;
170
+ const z = Math.sin(a) * r;
171
+ const h = 0.55 + rng() * 0.45;
172
+ // Lean out from the centre, plus a shared comb toward +X.
173
+ const lean = 0.1 + rng() * 0.25;
174
+ const across = a + Math.PI / 2;
175
+ const w = 0.024 + rng() * 0.016;
176
+ const tip = 0.95 + rng() * 0.3;
177
+ positions.push(
178
+ x - Math.cos(across) * w,
179
+ 0,
180
+ z - Math.sin(across) * w,
181
+ x + Math.cos(across) * w,
182
+ 0,
183
+ z + Math.sin(across) * w,
184
+ x + (Math.cos(a) * lean + 0.18) * h,
185
+ h,
186
+ z + Math.sin(a) * lean * h,
187
+ );
188
+ colors.push(0.5, 0.56, 0.5, 0.5, 0.56, 0.5, 1.25 * tip, 1.18 * tip, 0.62 * tip);
189
+ }
190
+ const geometry = new BufferGeometry();
191
+ geometry.setAttribute("position", new BufferAttribute(new Float32Array(positions), 3));
192
+ geometry.setAttribute(
193
+ "normal",
194
+ new BufferAttribute(
195
+ new Float32Array(positions.length).map((_, i) => (i % 3 === 1 ? 1 : 0)),
196
+ 3,
197
+ ),
198
+ );
199
+ geometry.setAttribute("color", new BufferAttribute(new Float32Array(colors), 3));
200
+ return geometry;
201
+ }
202
+
203
+ /**
204
+ * A 256 x 256 cluster of about ninety leaves round a twig, each its own green with a midrib and a
205
+ * darker half where it folds, the rest transparent: the card every crown and bush is built from.
206
+ * Transparent texels keep the leaves' mean colour, so the mip chain does not darken their edges.
207
+ */
208
+ function leafTexture(): DataTexture {
209
+ const size = 256;
210
+ const rng = seeded(71);
211
+ const data = new Uint8Array(size * size * 4);
212
+ for (let i = 0; i < size * size; i += 1) data.set([88, 128, 52, 0], i * 4);
213
+ for (let leaf = 0; leaf < 95; leaf += 1) {
214
+ // Leaves fan out from the card's middle: the stem end toward the centre.
215
+ const reach = Math.sqrt(rng()) * 92;
216
+ const around = rng() * Math.PI * 2;
217
+ const cx = 128 + Math.cos(around) * reach;
218
+ const cy = 128 + Math.sin(around) * reach;
219
+ const angle = around + (rng() - 0.5) * 1.4;
220
+ const length = 26 + rng() * 18;
221
+ const width = length * (0.38 + rng() * 0.1);
222
+ const value = 0.72 + rng() * 0.4;
223
+ const warm = rng() * 0.12;
224
+ const [dx, dy] = [Math.cos(angle), Math.sin(angle)];
225
+ for (let y = Math.floor(cy - length); y <= cy + length; y += 1) {
226
+ for (let x = Math.floor(cx - length); x <= cx + length; x += 1) {
227
+ if (x < 0 || y < 0 || x >= size || y >= size) continue;
228
+ const u = (x - cx) * dx + (y - cy) * dy + length / 2;
229
+ const v = -(x - cx) * dy + (y - cy) * dx;
230
+ if (u < 0 || u > length) continue;
231
+ const half = (width / 2) * Math.sin((Math.PI * u) / length) ** 0.75;
232
+ if (Math.abs(v) > half) continue;
233
+ const rib = Math.abs(v) < 0.9 ? 0.78 : 1;
234
+ const fold = v > 0 ? 0.86 : 1;
235
+ const edge = 0.9 + 0.1 * (1 - Math.abs(v) / half);
236
+ const k = value * rib * fold * edge;
237
+ data.set(
238
+ [
239
+ Math.min(255, (0.36 + warm) * k * 255),
240
+ Math.min(255, 0.62 * k * 255),
241
+ Math.min(255, 0.2 * k * 255),
242
+ 255,
243
+ ],
244
+ (y * size + x) * 4,
245
+ );
246
+ }
247
+ }
248
+ }
249
+ const texture = new DataTexture(data, size, size, RGBAFormat, UnsignedByteType);
250
+ texture.colorSpace = SRGBColorSpace;
251
+ texture.generateMipmaps = true;
252
+ texture.minFilter = LinearMipmapLinearFilter;
253
+ texture.anisotropy = 4;
254
+ texture.needsUpdate = true;
255
+ return texture;
256
+ }
257
+
258
+ /** One leaf card, 1 m square, its normals bent out from its centre so a crown shades round. */
259
+ function cardGeometry(): BufferGeometry {
260
+ const geometry = new PlaneGeometry(1, 1);
261
+ const position = geometry.attributes.position;
262
+ const normal = geometry.attributes.normal;
263
+ const bent = new Vector3();
264
+ for (let i = 0; i < (position?.count ?? 0); i += 1) {
265
+ bent.set(position?.getX(i) ?? 0, position?.getY(i) ?? 0, 0.8).normalize();
266
+ normal?.setXYZ(i, bent.x, bent.y, bent.z);
267
+ }
268
+ return geometry;
269
+ }
270
+
271
+ /** A tapering trunk with a flared foot, base at the origin, 1 m tall; UVs wrap the bark `repeats` times up it. */
272
+ function trunkGeometry(repeats: number, flare: number): BufferGeometry {
273
+ const profile = Array.from({ length: 8 }, (_, i) => {
274
+ const y = i / 7;
275
+ return new Vector2(0.12 + 0.05 * (1 - y) + flare * Math.exp(-y * 9), y);
276
+ });
277
+ const geometry = new LatheGeometry(profile, 10);
278
+ const uv = geometry.attributes.uv;
279
+ for (let i = 0; i < (uv?.count ?? 0); i += 1) uv?.setY(i, (uv.getY(i) ?? 0) * repeats);
280
+ return geometry;
281
+ }
282
+
283
+ /** A leaf-card crown: cards scattered through a few clumps, facing out, darker inside and below. */
284
+ interface ICrown {
285
+ readonly cards: Matrix4[];
286
+ readonly tints: Color[];
287
+ /** Clump centres, where the branches reach. */
288
+ readonly clumps: Vector3[];
289
+ }
290
+
291
+ function addCrown(
292
+ out: ICrown,
293
+ rng: () => number,
294
+ centre: Vector3,
295
+ radius: Vector3,
296
+ options: { clumps: number; cards: number; card: number; tint: Color },
297
+ ): Vector3[] {
298
+ const clumps = Array.from({ length: options.clumps }, (_, i) => {
299
+ const a = (i / options.clumps) * Math.PI * 2 + rng();
300
+ const up = i === 0 ? 0.5 : (rng() - 0.35) * 0.9;
301
+ return new Vector3(
302
+ centre.x + Math.cos(a) * radius.x * (i === 0 ? 0 : 0.5),
303
+ centre.y + up * radius.y * 0.6,
304
+ centre.z + Math.sin(a) * radius.z * (i === 0 ? 0 : 0.5),
305
+ );
306
+ });
307
+ const position = new Vector3();
308
+ const facing = new Vector3();
309
+ const turn = new Quaternion();
310
+ const roll = new Quaternion();
311
+ const scale = new Vector3();
312
+ const forward = new Vector3(0, 0, 1);
313
+ for (let c = 0; c < options.cards; c += 1) {
314
+ const clump = clumps[c % clumps.length] as Vector3;
315
+ // A point in the clump, nearer its skin than its middle.
316
+ facing.set(rng() * 2 - 1, rng() * 2 - 1, rng() * 2 - 1).normalize();
317
+ const depth = 0.45 + 0.55 * Math.sqrt(rng());
318
+ position.set(
319
+ clump.x + facing.x * radius.x * 0.62 * depth,
320
+ clump.y + facing.y * radius.y * 0.62 * depth,
321
+ clump.z + facing.z * radius.z * 0.62 * depth,
322
+ );
323
+ // Face away from the crown's centre, loosely: a card seen edge-on is only a line.
324
+ facing
325
+ .subVectors(position, centre)
326
+ .normalize()
327
+ .add(new Vector3(rng() - 0.5, rng() - 0.5, rng() - 0.5).multiplyScalar(0.9))
328
+ .normalize();
329
+ turn.setFromUnitVectors(forward, facing);
330
+ roll.setFromAxisAngle(facing, rng() * Math.PI * 2);
331
+ const size = options.card * (0.75 + rng() * 0.5);
332
+ scale.set(size, size, size);
333
+ out.cards.push(new Matrix4().compose(position, roll.multiply(turn), scale));
334
+ // Light where the sky reaches: the outside and the top; the inside and the underside in shade.
335
+ const out01 = Math.min(1, position.distanceTo(centre) / Math.max(radius.x, radius.y));
336
+ const top = Math.min(1, Math.max(0, (position.y - centre.y) / radius.y + 0.6));
337
+ const shade = (0.45 + 0.55 * out01) * (0.7 + 0.3 * top);
338
+ out.tints.push(options.tint.clone().multiplyScalar(shade * (0.9 + rng() * 0.2)));
339
+ }
340
+ return clumps;
341
+ }
342
+
343
+ /** A branch from `from` to `to`, as the matrix of a unit cylinder standing on its base. */
344
+ function branchMatrix(from: Vector3, to: Vector3, radius: number): Matrix4 {
345
+ const along = new Vector3().subVectors(to, from);
346
+ const length = along.length();
347
+ const turn = new Quaternion().setFromUnitVectors(new Vector3(0, 1, 0), along.normalize());
348
+ return new Matrix4().compose(from, turn, new Vector3(radius, length, radius));
349
+ }
350
+
351
+ /** Two wings hinged on the body's line, flapping on their own phase while the insect wanders. */
352
+ function butterflies(placements: readonly Placement[], tints: readonly Color[]): InstancedMesh {
353
+ const geometry = new BufferGeometry();
354
+ geometry.setAttribute(
355
+ "position",
356
+ new BufferAttribute(
357
+ new Float32Array([
358
+ 0, 0, -0.05, -0.11, 0, -0.07, -0.08, 0, 0.06, 0, 0, -0.05, 0.08, 0, 0.06, 0.11, 0, -0.07,
359
+ ]),
360
+ 3,
361
+ ),
362
+ );
363
+ geometry.computeVertexNormals();
364
+ const material = new MeshStandardNodeMaterial({
365
+ color: 0xffffff,
366
+ roughness: 0.6,
367
+ side: DoubleSide,
368
+ });
369
+ const phase = hash(instanceIndex).mul(6.28);
370
+ const flap = sin(time.mul(17).add(phase)).mul(abs(positionGeometry.x)).mul(1.4);
371
+ material.positionNode = positionLocal.add(
372
+ vec3(
373
+ sin(time.mul(0.45).add(phase)).mul(1.8),
374
+ flap.add(sin(time.mul(1.3).add(phase.mul(2))).mul(0.35)),
375
+ sin(time.mul(0.33).add(phase.mul(3))).mul(1.8),
376
+ ),
377
+ );
378
+ const mesh = instanced(geometry, material, placements, false, tints);
379
+ // The wander leaves the instance bounds; a few metres of slack keep it from being culled early.
380
+ mesh.frustumCulled = false;
381
+ return mesh;
382
+ }
383
+
384
+ /**
385
+ * A five-petal flower head, 12 cm across, facing up: rounded petals round a golden eye (vertex
386
+ * colours: white petals take the instance's colour, the eye stays gold).
387
+ */
388
+ function flowerGeometry(): BufferGeometry {
389
+ const positions: number[] = [];
390
+ const colors: number[] = [];
391
+ // Ten rim points: alternately a petal tip and the notch between two petals.
392
+ const steps = 10;
393
+ for (let i = 0; i < steps; i += 1) {
394
+ const at = (k: number) => {
395
+ const a = (k / steps) * Math.PI * 2;
396
+ const r = 0.06 * (0.55 + 0.45 * Math.abs(Math.cos((a * 5) / 2)));
397
+ return [Math.cos(a) * r, 0, Math.sin(a) * r];
398
+ };
399
+ positions.push(0, 0.006, 0, ...at(i + 1), ...at(i));
400
+ colors.push(1, 0.72, 0.1, 1, 1, 1, 1, 1, 1);
401
+ }
402
+ const geometry = new BufferGeometry();
403
+ geometry.setAttribute("position", new BufferAttribute(new Float32Array(positions), 3));
404
+ geometry.setAttribute("color", new BufferAttribute(new Float32Array(colors), 3));
405
+ geometry.computeVertexNormals();
406
+ return geometry;
407
+ }
408
+
409
+ /** The meadow's distance thinning: call `update` with the camera's position once a frame. */
410
+ export interface IMeadow {
411
+ update(eye: { readonly x: number; readonly z: number }): void;
412
+ /** Tufts drawn after the last `update`, and the tier's whole meadow. */
413
+ readonly drawn: number;
414
+ readonly total: number;
415
+ }
416
+
417
+ export function plantIsland(site: IPlantingSite): { group: Group; meadow: IMeadow } {
418
+ const { rng, bounds, clear, ground, surfaces } = site;
419
+ const group = new Group();
420
+ group.name = "planting";
421
+ const spin = () => rng() * Math.PI * 2;
422
+ const onLawn = (x: number, z: number) =>
423
+ site.lawns.some(([lx, lz, r]) => Math.hypot(x - lx, z - lz) < r + 0.4);
424
+ const land = (x: number, z: number): boolean =>
425
+ ground(x, z) > site.seaLevel + 1 && site.flatness(x, z) > 0.8 && !onLawn(x, z);
426
+ /** A random clear spot on grass, off the path, at least `width` from every route, or undefined. */
427
+ const spot = (width: number, pathGap = width + 1.4): [number, number] | undefined => {
428
+ for (let tries = 0; tries < 16; tries += 1) {
429
+ const x = bounds.minX + rng() * (bounds.maxX - bounds.minX);
430
+ const z = bounds.minZ + rng() * (bounds.maxZ - bounds.minZ);
431
+ if (land(x, z) && site.pathDistance(x, z) > pathGap && clear(x, z, width)) return [x, z];
432
+ }
433
+ return undefined;
434
+ };
435
+
436
+ const leaves: ICrown = { cards: [], clumps: [], tints: [] };
437
+ const branches: Matrix4[] = [];
438
+
439
+ // Broadleaf trees: a flared trunk, four or five boughs, and a round crown of about 130 cards.
440
+ const trunks: Placement[] = [];
441
+ for (let i = 0; i < 22; i += 1) {
442
+ const at = spot(3.5);
443
+ if (at === undefined) continue;
444
+ const [x, z] = at;
445
+ const size = 0.9 + rng() * 0.6;
446
+ const height = 3.4 * size;
447
+ const y = ground(x, z) - 0.2;
448
+ trunks.push([x, y, z, 1.5 * size, height + 1, 1.5 * size, (rng() - 0.5) * 0.08, spin(), 0]);
449
+ const tint = new Color(i % 3 === 0 ? 0xc8e0b0 : 0xffffff);
450
+ const centre = new Vector3(x, y + height + 1.5 * size, z);
451
+ const clumps = addCrown(leaves, rng, centre, new Vector3(2.6, 2.1, 2.6).multiplyScalar(size), {
452
+ card: 1.5 * size,
453
+ cards: 130,
454
+ clumps: 6,
455
+ tint,
456
+ });
457
+ const fork = new Vector3(x, y + height * 0.75, z);
458
+ for (const clump of clumps.slice(1))
459
+ branches.push(branchMatrix(fork, fork.clone().lerp(clump, 0.85), 0.09 * size));
460
+ }
461
+ const bark = texturedMaterial(surfaces, "bark", { normalScale: 1.6, roughness: 0.92 });
462
+ group.add(instanced(trunkGeometry(2, 0.12), bark, trunks, true));
463
+
464
+ // Birches: tall white trunks with a light, narrow crown of smaller cards up their top half.
465
+ const birches: Placement[] = [];
466
+ for (let i = 0; i < 14; i += 1) {
467
+ const at = spot(2);
468
+ if (at === undefined) continue;
469
+ const [x, z] = at;
470
+ const height = 8 + rng() * 3.5;
471
+ const y = ground(x, z) - 0.2;
472
+ birches.push([x, y, z, 0.8, height, 0.8, (rng() - 0.5) * 0.06, spin(), 0]);
473
+ const centre = new Vector3(x, y + height * 0.72, z);
474
+ const clumps = addCrown(leaves, rng, centre, new Vector3(1.7, height * 0.3, 1.7), {
475
+ card: 1.1,
476
+ cards: 80,
477
+ clumps: 5,
478
+ tint: new Color(1.15, 1.2, 0.85),
479
+ });
480
+ const fork = new Vector3(x, y + height * 0.5, z);
481
+ for (const clump of clumps.slice(1))
482
+ branches.push(branchMatrix(fork, fork.clone().lerp(clump, 0.8), 0.045));
483
+ }
484
+ group.add(
485
+ instanced(
486
+ trunkGeometry(14, 0.05),
487
+ texturedMaterial(surfaces, "birch-bark", { roughness: 0.7 }),
488
+ birches,
489
+ true,
490
+ ),
491
+ );
492
+
493
+ // Bushes: low clumps of the same leaves, and two hedge arcs of them near the rim.
494
+ const bush = (x: number, z: number, size: number): void => {
495
+ addCrown(
496
+ leaves,
497
+ rng,
498
+ new Vector3(x, ground(x, z) + 0.45 * size, z),
499
+ new Vector3(0.95, 0.7, 0.95).multiplyScalar(size),
500
+ { card: 0.9 * size, cards: 26, clumps: 2, tint: new Color(0.8, 0.9, 0.78) },
501
+ );
502
+ };
503
+ for (let i = 0; i < 40; i += 1) {
504
+ const at = spot(1.6);
505
+ if (at !== undefined) bush(at[0], at[1], 0.8 + rng() * 0.6);
506
+ }
507
+ for (const [from, to] of [
508
+ [0.75, 1.35],
509
+ [3.55, 4.25],
510
+ ] as const) {
511
+ for (let a = from; a < to; a += 1.8 / 29) {
512
+ const x = Math.cos(a) * 29;
513
+ const z = Math.sin(a) * 29;
514
+ if (clear(x, z, 1.2) && land(x, z) && site.pathDistance(x, z) > 2) bush(x, z, 1.25);
515
+ }
516
+ }
517
+
518
+ // Every leaf card on the island is one draw: cut out of the cluster texture, both faces lit, the
519
+ // sun shining through the ones seen against it, and a slow flutter on each card's own phase.
520
+ const leafMaterial = new MeshStandardNodeMaterial({
521
+ alphaTest: 0.4,
522
+ map: leafTexture(),
523
+ roughness: 0.7,
524
+ side: DoubleSide,
525
+ });
526
+ const flutter = hash(instanceIndex).mul(6.28);
527
+ leafMaterial.positionNode = positionLocal.add(
528
+ vec3(
529
+ sin(time.mul(1.9).add(flutter)).mul(0.03),
530
+ sin(time.mul(2.6).add(flutter.mul(1.3))).mul(0.02),
531
+ 0,
532
+ ),
533
+ );
534
+ leafMaterial.twoSidedFoliage = true;
535
+ leafMaterial.subsurfaceColor = new Color(0.3, 0.46, 0.1);
536
+ const cards = new InstancedMesh(cardGeometry(), leafMaterial, leaves.cards.length);
537
+ leaves.cards.forEach((matrix, i) => {
538
+ cards.setMatrixAt(i, matrix);
539
+ cards.setColorAt(i, leaves.tints[i] as Color);
540
+ });
541
+ cards.computeBoundingSphere();
542
+ cards.castShadow = true;
543
+ cards.receiveShadow = true;
544
+ cards.name = "leaves";
545
+ group.add(cards);
546
+ const boughs = new InstancedMesh(
547
+ new CylinderGeometry(0.55, 1, 1, 6, 1, true).translate(0, 0.5, 0),
548
+ bark,
549
+ branches.length,
550
+ );
551
+ branches.forEach((matrix, i) => boughs.setMatrixAt(i, matrix));
552
+ boughs.computeBoundingSphere();
553
+ boughs.castShadow = true;
554
+ group.add(boughs);
555
+
556
+ // Flowers: clumps in the grass, thickest along the path's edges, one draw per colour, on stems
557
+ // that sway with it.
558
+ const petals = [C.petalRed, C.petalOrange, C.petalWhite, C.petalYellow, C.wingBlue];
559
+ const heads: Placement[][] = petals.map(() => []);
560
+ const stems: Placement[] = [];
561
+ for (let i = 0; i < 260; i += 1) {
562
+ const at = i % 3 === 0 ? spot(0.6, 1.6) : spot(0.6, 1.4);
563
+ if (at === undefined) continue;
564
+ const hue = heads[i % petals.length] ?? [];
565
+ const count = 6 + Math.floor(rng() * 9);
566
+ for (let f = 0; f < count; f += 1) {
567
+ const a = spin();
568
+ const r = rng() ** 0.7 * 0.9;
569
+ const x = at[0] + Math.cos(a) * r;
570
+ const z = at[1] + Math.sin(a) * r;
571
+ const h = 0.3 + rng() * 0.3;
572
+ const y = ground(x, z);
573
+ stems.push([x, y, z, 1, h, 1, 0, 0, 0]);
574
+ const s = 0.8 + rng() * 0.5;
575
+ hue.push([x, y + h, z, s, s, s, (rng() - 0.5) * 0.6, spin(), (rng() - 0.5) * 0.6]);
576
+ }
577
+ }
578
+ const stem = new CylinderGeometry(0.01, 0.012, 1, 3, 1, true).translate(0, 0.5, 0);
579
+ group.add(instanced(stem, lit(C.blade), stems, false));
580
+ const head = flowerGeometry();
581
+ petals.forEach((colour, i) => {
582
+ group.add(
583
+ instanced(head, lit(colour, { roughness: 0.6, vertexColors: true }), heads[i] ?? [], false),
584
+ );
585
+ });
586
+
587
+ // Butterflies over the flowers: orange, white and blue.
588
+ const flyers: Placement[] = [];
589
+ const wingTints: Color[] = [];
590
+ const wings = [C.petalOrange, C.petalWhite, C.wingBlue];
591
+ for (let i = 0; i < 20; i += 1) {
592
+ const at = spot(0.5, 1);
593
+ if (at === undefined) continue;
594
+ flyers.push([at[0], ground(at[0], at[1]) + 0.7 + rng() * 0.6, at[1], 1, 1, 1, 0, spin(), 0]);
595
+ wingTints.push(new Color(wings[i % wings.length]));
596
+ }
597
+ group.add(butterflies(flyers, wingTints));
598
+
599
+ // Pebbles thick along the path, and a few stones in the grass, half sunk into the ground.
600
+ const pebbles: Placement[] = [];
601
+ const pebbleTints: Color[] = [];
602
+ const stones: Placement[] = [];
603
+ const stoneTints: Color[] = [];
604
+ const pebbleBase = new Color(C.pebble);
605
+ for (let i = 0; i < 30000; i += 1) {
606
+ const x = bounds.minX + rng() * (bounds.maxX - bounds.minX);
607
+ const z = bounds.minZ + rng() * (bounds.maxZ - bounds.minZ);
608
+ const onPath = site.pathDistance(x, z) < 1.4;
609
+ // A grass stone casts a shadow and counts as a prop: it keeps the planting's clearances.
610
+ if ((!onPath && (rng() > 0.006 || !clear(x, z, 0.4))) || ground(x, z) < site.seaLevel + 0.4)
611
+ continue;
612
+ const s = onPath ? 0.025 + rng() ** 3 * 0.11 : 0.1 + rng() ** 2 * 0.3;
613
+ const at: Placement = [
614
+ x,
615
+ ground(x, z) + s * 0.12,
616
+ z,
617
+ s,
618
+ s * 0.55,
619
+ s * (0.8 + rng() * 0.4),
620
+ rng(),
621
+ spin(),
622
+ rng(),
623
+ ];
624
+ (onPath ? pebbles : stones).push(at);
625
+ (onPath ? pebbleTints : stoneTints).push(pebbleBase.clone().multiplyScalar(0.45 + rng() * 0.7));
626
+ }
627
+ const pebble = new OctahedronGeometry(1, 0);
628
+ const pebbleMaterial = lit(0xffffff, { flat: true });
629
+ // Too small to throw a shadow worth its draw.
630
+ const pathPebbles = instanced(pebble, pebbleMaterial, pebbles, false, pebbleTints);
631
+ pathPebbles.name = "path-pebbles";
632
+ const grassStones = instanced(pebble, pebbleMaterial, stones, true, stoneTints);
633
+ grassStones.name = "stones";
634
+ group.add(pathPebbles, grassStones);
635
+
636
+ // The meadow: grass tufts on a jittered 0.5 m grid over all the land and every drum's lawn, shorter
637
+ // on the mown routes and beside the path, one `InstancedMesh` per 12 m cell. Each cell is
638
+ // shuffled, so drawing a prefix of it thins it evenly: `update` draws every tuft within 10 m of
639
+ // the eye at every tier (the foreground is what hides the ground), then the tier's share, thinning
640
+ // to an eighth of it by 46 m, where the ground's own grass texture carries the field.
641
+ const tuft = tuftGeometry(rng);
642
+ const grass = grassMaterial();
643
+ const cells = new Map<
644
+ string,
645
+ { placements: Placement[]; tints: Color[]; x: number; z: number }
646
+ >();
647
+ const meadow = new Color(C.blade);
648
+ const step = 0.5;
649
+ const plant = (tx: number, tz: number, y: number, h: number): void => {
650
+ const ix = Math.floor(tx / 12);
651
+ const iz = Math.floor(tz / 12);
652
+ const key = `${ix},${iz}`;
653
+ const cell = cells.get(key) ?? {
654
+ placements: [],
655
+ tints: [],
656
+ x: (ix + 0.5) * 12,
657
+ z: (iz + 0.5) * 12,
658
+ };
659
+ cells.set(key, cell);
660
+ cell.placements.push([tx, y - 0.03, tz, 1, h, 1, 0, (rng() - 0.5) * 0.8, 0]);
661
+ // Hue drifts between a yellow-green and a blue-green in 20 m patches, value in 6 m ones.
662
+ const drift = 0.5 + 0.5 * Math.sin(tx * 0.11 + tz * 0.07) * Math.cos(tz * 0.13 - tx * 0.05);
663
+ const patch = Math.sin(tx * 0.9 + Math.sin(tz * 0.7)) * Math.cos(tz * 0.8 - tx * 0.3);
664
+ cell.tints.push(
665
+ new Color(meadow).offsetHSL(0.05 * drift - 0.025, 0, 0.05 * patch + 0.04 * (rng() - 0.5)),
666
+ );
667
+ };
668
+ for (let z = bounds.minZ; z < bounds.maxZ; z += step) {
669
+ for (let x = bounds.minX; x < bounds.maxX; x += step) {
670
+ const tx = x + (rng() - 0.5) * step;
671
+ const tz = z + (rng() - 0.5) * step;
672
+ const scale = rng();
673
+ const path = site.pathDistance(tx, tz);
674
+ if (path < 0.95 || !land(tx, tz)) continue;
675
+ const mown = clear(tx, tz, 0) ? 1 : 0.6;
676
+ const edge = Math.min(1, (path - 0.95) / 1.6);
677
+ plant(tx, tz, ground(tx, tz), (0.5 + scale * 0.45) * mown * (0.45 + 0.55 * edge));
678
+ }
679
+ }
680
+ for (const [lx, lz, radius, top] of site.lawns) {
681
+ for (let z = lz - radius; z < lz + radius; z += step) {
682
+ for (let x = lx - radius; x < lx + radius; x += step) {
683
+ const tx = x + (rng() - 0.5) * step;
684
+ const tz = z + (rng() - 0.5) * step;
685
+ const scale = rng();
686
+ if (Math.hypot(tx - lx, tz - lz) > radius - 0.2) continue;
687
+ plant(tx, tz, top, (0.5 + scale * 0.4) * (clear(tx, tz, 0) ? 1 : 0.6));
688
+ }
689
+ }
690
+ }
691
+ const meadowCells: { mesh: InstancedMesh; all: number; share: number; x: number; z: number }[] =
692
+ [];
693
+ for (const { placements, tints, x, z } of cells.values()) {
694
+ for (let i = placements.length - 1; i > 0; i -= 1) {
695
+ const j = Math.floor(rng() * (i + 1));
696
+ [placements[i], placements[j]] = [placements[j] as Placement, placements[i] as Placement];
697
+ [tints[i], tints[j]] = [tints[j] as Color, tints[i] as Color];
698
+ }
699
+ const mesh = instanced(tuft, grass, placements, false, tints);
700
+ mesh.name = "grass";
701
+ group.add(mesh);
702
+ meadowCells.push({
703
+ all: placements.length,
704
+ mesh,
705
+ share: Math.round(placements.length * site.grassShare),
706
+ x,
707
+ z,
708
+ });
709
+ }
710
+ let drawn = 0;
711
+ const meadowLod: IMeadow = {
712
+ get drawn() {
713
+ return drawn;
714
+ },
715
+ total: meadowCells.reduce((sum, cell) => sum + cell.share, 0),
716
+ update(eye) {
717
+ drawn = 0;
718
+ for (const cell of meadowCells) {
719
+ // The cell's nearest point to the eye, so a cell the camera stands in is near however big.
720
+ const d = Math.max(0, Math.hypot(cell.x - eye.x, cell.z - eye.z) - 6);
721
+ const keep = d < 10 ? 1 : Math.max(1 / 8, 1 - (d - 10) / 34) * site.grassShare;
722
+ cell.mesh.count = Math.min(cell.all, Math.round(cell.all * keep));
723
+ drawn += cell.mesh.count;
724
+ }
725
+ },
726
+ };
727
+
728
+ // Beaches: a sand shelf at the cliff's foot and a darker wet band at the water; the sea's own
729
+ // shader breaks the foam along it (`water.ts`).
730
+ for (const [x, z, r] of site.shores) {
731
+ const band = (inner: number, outer: number, y: number, material: Material): void => {
732
+ const ring = new RingGeometry(inner, outer, Math.max(24, Math.round(r * 3)), 1).rotateX(
733
+ -Math.PI / 2,
734
+ );
735
+ const mesh = new Mesh(ring, material);
736
+ mesh.position.set(x, site.seaLevel + y, z);
737
+ mesh.receiveShadow = true;
738
+ group.add(mesh);
739
+ };
740
+ band(r - 1, r + 1.1, 0.16, lit(C.sand));
741
+ band(r + 1.1, r + 1.8, 0.1, lit(C.wetSand, { roughness: 0.35 }));
742
+ }
743
+ return { group, meadow: meadowLod };
744
+ }