create-threenative 0.2.9 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +229 -36
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +17 -11
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +16 -10
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +17 -11
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +17 -11
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +17 -11
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +16 -10
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +16 -10
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +17 -11
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +17 -11
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +17 -11
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +17 -11
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +53 -34
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +17 -11
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,579 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // Clover Loop's look, all procedural: rolling terrain that climbs into hills at the edge, the
5
+ // asphalt ribbon with its edge lines and red-and-white kerbs, the grass shoulder, toy-block walls,
6
+ // the bridge on its pillars, a creek under the jump, trees, the start gantry and the boost pads.
7
+ // Every shape follows `track/Course.ts`, so a change to the layout there moves all of it. About
8
+ // ten draw calls: the ribbons are one merged mesh, the walls and the trees are instanced.
9
+ import {
10
+ BoxGeometry,
11
+ BufferAttribute,
12
+ BufferGeometry,
13
+ Color,
14
+ CylinderGeometry,
15
+ Group,
16
+ IcosahedronGeometry,
17
+ InstancedMesh,
18
+ Matrix4,
19
+ Mesh,
20
+ MeshStandardMaterial,
21
+ Object3D,
22
+ PlaneGeometry,
23
+ } from "three";
24
+ import { type ICourse, PROFILE } from "../track/Course.js";
25
+ import { at, lit, merge, paint } from "./materials.js";
26
+ import { C } from "./palette.js";
27
+
28
+ /** A seeded generator, so the trees and the grass colour fall the same way every run. */
29
+ export function makeRng(seed: number): () => number {
30
+ let s = seed >>> 0;
31
+ return () => {
32
+ s = (s + 0x6d2b79f5) >>> 0;
33
+ let t = s;
34
+ t = Math.imul(t ^ (t >>> 15), t | 1);
35
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
36
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
37
+ };
38
+ }
39
+
40
+ /** The shoulder ribbon ends this far out, behind the wall; the terrain starts under it. */
41
+ const SHOULDER = PROFILE.wall + 2.5;
42
+ /** Terrain cell size and how far it reaches past the course. */
43
+ const CELL = 6;
44
+ const MARGIN = 190;
45
+
46
+ export interface ICourseView {
47
+ readonly group: Group;
48
+ /** Ground height at any x/z: the terrain, or the road where the road is. */
49
+ ground(x: number, z: number): number;
50
+ /** The three countdown lamps on the start gantry, left to right; `Race.ts` lights them. */
51
+ readonly lamps: readonly MeshStandardMaterial[];
52
+ readonly audit: {
53
+ readonly triangles: number;
54
+ readonly trees: number;
55
+ readonly pillars: number;
56
+ /** Highest road point less the lowest, metres. */
57
+ readonly reliefMetres: number;
58
+ };
59
+ }
60
+
61
+ const scratch = new Color();
62
+ const mixColour = (a: number, b: number, t: number): Color =>
63
+ scratch.set(a).lerp(new Color(b), Math.min(1, Math.max(0, t)));
64
+
65
+ /** A ribbon along the whole line: one quad per metre per column, each quad one colour. */
66
+ function ribbon(
67
+ course: ICourse,
68
+ laterals: readonly number[],
69
+ colour: (i: number, column: number) => Color | number | undefined,
70
+ lift: (i: number, lateral: number) => number = () => 0,
71
+ ): BufferGeometry {
72
+ const positions: number[] = [];
73
+ const colours: number[] = [];
74
+ const p = { x: 0, y: 0, z: 0 };
75
+ const corner = (i: number, lateral: number): readonly [number, number, number] => {
76
+ course.pointAt(i, lateral, p);
77
+ return [p.x, p.y + lift(course.wrap(i), lateral), p.z];
78
+ };
79
+ for (let i = 0; i < course.count; i += 1) {
80
+ for (let c = 0; c < laterals.length - 1; c += 1) {
81
+ const paintWith = colour(i, c);
82
+ if (paintWith === undefined) continue;
83
+ const tint = typeof paintWith === "number" ? new Color(paintWith) : paintWith;
84
+ const a = corner(i, laterals[c] ?? 0);
85
+ const b = corner(i, laterals[c + 1] ?? 0);
86
+ const d = corner(i + 1, laterals[c] ?? 0);
87
+ const e = corner(i + 1, laterals[c + 1] ?? 0);
88
+ // Counter-clockwise seen from above: forward × right points down, so a → b → d faces up.
89
+ for (const v of [a, b, d, b, e, d]) {
90
+ positions.push(...v);
91
+ colours.push(tint.r, tint.g, tint.b);
92
+ }
93
+ }
94
+ }
95
+ const geometry = new BufferGeometry();
96
+ geometry.setAttribute("position", new BufferAttribute(new Float32Array(positions), 3));
97
+ geometry.setAttribute("color", new BufferAttribute(new Float32Array(colours), 3));
98
+ geometry.setAttribute("uv", new BufferAttribute(new Float32Array((positions.length / 3) * 2), 2));
99
+ geometry.computeVertexNormals();
100
+ return geometry;
101
+ }
102
+
103
+ export function buildCourseView(course: ICourse, seed = 734): ICourseView {
104
+ const rng = makeRng(seed);
105
+ const group = new Group();
106
+ group.name = "course";
107
+ const n = course.count;
108
+ const { x: cx, y: cy, z: cz, tx, tz, deck } = course;
109
+
110
+ // ---- Height field ------------------------------------------------------------------------
111
+ let minX = Number.POSITIVE_INFINITY;
112
+ let maxX = Number.NEGATIVE_INFINITY;
113
+ let minZ = Number.POSITIVE_INFINITY;
114
+ let maxZ = Number.NEGATIVE_INFINITY;
115
+ for (let i = 0; i < n; i += 1) {
116
+ minX = Math.min(minX, cx[i] ?? 0);
117
+ maxX = Math.max(maxX, cx[i] ?? 0);
118
+ minZ = Math.min(minZ, cz[i] ?? 0);
119
+ maxZ = Math.max(maxZ, cz[i] ?? 0);
120
+ }
121
+ const midX = (minX + maxX) / 2;
122
+ const midZ = (minZ + maxZ) / 2;
123
+ const halfX = (maxX - minX) / 2 + 20;
124
+ const halfZ = (maxZ - minZ) / 2 + 20;
125
+ // The creek runs across the line at the jump's dip, square to it.
126
+ const creekAt = Math.round((course.creek[0] + course.creek[1]) / 2);
127
+ const creekY = cy[creekAt] ?? 0;
128
+ const creekReach = channelReach(course, creekAt);
129
+ /** Rolling ground away from the road, climbing to a ring of hills past the course. */
130
+ const far = (x: number, z: number): number => {
131
+ const e = Math.hypot((x - midX) / halfX, (z - midZ) / halfZ);
132
+ const roll =
133
+ 1.4 * Math.sin(x * 0.029 + 1.3) * Math.cos(z * 0.034 - 0.4) +
134
+ 0.8 * Math.sin(x * 0.071 - z * 0.053 + 2.2);
135
+ const hills =
136
+ smooth(1, 1.9, e) * (26 + 16 * Math.sin(Math.atan2(z - midZ, x - midX) * 5 + 0.8));
137
+ return roll + hills;
138
+ };
139
+ const ground = (x: number, z: number): number => {
140
+ let nearest = Number.POSITIVE_INFINITY;
141
+ let low = Number.POSITIVE_INFINITY;
142
+ for (let i = 0; i < n; i += 1) {
143
+ if (deck[i] === 1) continue;
144
+ const d = (x - (cx[i] ?? 0)) ** 2 + (z - (cz[i] ?? 0)) ** 2;
145
+ if (d < nearest) nearest = d;
146
+ if (d < (SHOULDER + 3) ** 2 && (cy[i] ?? 0) < low) low = cy[i] ?? 0;
147
+ }
148
+ const d = Math.sqrt(nearest);
149
+ const base = Number.isFinite(low) ? low - 0.35 : far(x, z);
150
+ let h = base + (far(x, z) - base) * smooth(SHOULDER, SHOULDER + 24, d);
151
+ // The creek's channel: a trough square to the line at the dip, its banks easing up.
152
+ const along =
153
+ (x - (cx[creekAt] ?? 0)) * (tx[creekAt] ?? 0) + (z - (cz[creekAt] ?? 0)) * (tz[creekAt] ?? 0);
154
+ const across =
155
+ (x - (cx[creekAt] ?? 0)) * -(tz[creekAt] ?? 0) +
156
+ (z - (cz[creekAt] ?? 0)) * (tx[creekAt] ?? 0);
157
+ if (across > creekReach[0] - 10 && across < creekReach[1] + 10) {
158
+ const end =
159
+ smooth(creekReach[1], creekReach[1] + 10, across) +
160
+ smooth(-creekReach[0], -creekReach[0] + 10, -across);
161
+ const trough = creekY - 0.7 + smooth(4, 12, Math.abs(along)) * 30 + end * 30;
162
+ h = Math.min(h, trough);
163
+ }
164
+ return h;
165
+ };
166
+
167
+ // ---- Terrain ------------------------------------------------------------------------------
168
+ const width = 2 * (halfX + MARGIN);
169
+ const depth = 2 * (halfZ + MARGIN);
170
+ const terrainGeometry = new PlaneGeometry(
171
+ width,
172
+ depth,
173
+ Math.ceil(width / CELL),
174
+ Math.ceil(depth / CELL),
175
+ );
176
+ terrainGeometry.rotateX(-Math.PI / 2);
177
+ terrainGeometry.translate(midX, 0, midZ);
178
+ const tp = terrainGeometry.getAttribute("position");
179
+ for (let i = 0; i < tp.count; i += 1) tp.setY(i, ground(tp.getX(i), tp.getZ(i)));
180
+ terrainGeometry.computeVertexNormals();
181
+ const tn = terrainGeometry.getAttribute("normal");
182
+ const terrainColours = new Float32Array(tp.count * 3);
183
+ for (let i = 0; i < tp.count; i += 1) {
184
+ const x = tp.getX(i);
185
+ const z = tp.getZ(i);
186
+ const y = tp.getY(i);
187
+ const steep = 1 - tn.getY(i);
188
+ const patch =
189
+ 0.5 + 0.5 * Math.sin(x * 0.11 + Math.sin(z * 0.07) * 2) * Math.cos(z * 0.09 - x * 0.03);
190
+ const colour = mixColour(C.grassDark, C.grassLight, patch);
191
+ if (y < creekY + 0.4) colour.lerp(new Color(C.sand), smooth(creekY + 0.4, creekY - 0.3, y));
192
+ if (steep > 0.16) colour.lerp(new Color(C.rock), smooth(0.16, 0.35, steep));
193
+ terrainColours.set([colour.r, colour.g, colour.b], i * 3);
194
+ }
195
+ terrainGeometry.setAttribute("color", new BufferAttribute(terrainColours, 3));
196
+ const terrain = new Mesh(terrainGeometry, lit({ roughness: 0.95 }));
197
+ terrain.name = "terrain";
198
+ terrain.receiveShadow = true;
199
+ group.add(terrain);
200
+
201
+ // ---- Road, kerbs, shoulders -----------------------------------------------------------------
202
+ const r = PROFILE.road;
203
+ const k = r + PROFILE.kerb;
204
+ const road = ribbon(course, [-r, -r + 0.35, -r + 0.6, -3, 0, 3, r - 0.6, r - 0.35, r], (i, c) => {
205
+ if (c === 1 || c === 6) return C.line;
206
+ // Patches of older asphalt every few metres keep the ribbon from reading as one flat sheet.
207
+ const wear = 0.5 + 0.5 * Math.sin(i * 0.37 + c * 1.9) * Math.sin(i * 0.11 - c);
208
+ return mixColour(C.asphalt, C.asphaltDark, wear * (c === 0 || c === 7 ? 1 : 0.6));
209
+ });
210
+ // Kerbs in 2 m blocks, level with the road: both ribbons take their edge corners from the same
211
+ // course.pointAt, so the seam is watertight and nothing overlaps to flicker. A lifted kerb opens a
212
+ // slot under its edge that shows the grass below as a sub-pixel green line.
213
+ const kerbs = ribbon(course, [-k, -r, r, k], (i, c) =>
214
+ c === 1 ? undefined : Math.floor(i / 2) % 2 === 0 ? C.kerbRed : C.kerbWhite,
215
+ );
216
+ // The grass shoulder out past the wall, then a skirt down to the terrain, so a dip in the road
217
+ // (the creek, the cut under the bridge) never leaves the ribbon's edge hanging in the air.
218
+ const skirt = SHOULDER + 2;
219
+ const q = { x: 0, y: 0, z: 0 };
220
+ const shoulders = ribbon(
221
+ course,
222
+ [-skirt, -SHOULDER, -k, k, SHOULDER, skirt],
223
+ (i, c) => {
224
+ if (c === 2 || deck[i] === 1 || deck[(i + 1) % n] === 1) return undefined;
225
+ const patch = 0.5 + 0.5 * Math.sin(i * 0.21 + c * 2.3);
226
+ return mixColour(C.grassDark, C.grass, patch);
227
+ },
228
+ (i, lateral) => {
229
+ if (Math.abs(lateral) <= SHOULDER) return 0;
230
+ course.pointAt(i, lateral, q);
231
+ return Math.min(0, ground(q.x, q.z) - q.y - 0.05);
232
+ },
233
+ );
234
+ // The bridge's deck edge, kerb to rail.
235
+ const deckEdge = ribbon(course, [-PROFILE.rail - 0.3, -k, k, PROFILE.rail + 0.3], (i, c) =>
236
+ c === 1 || deck[i] !== 1 ? undefined : C.bridge,
237
+ );
238
+ // The checkered start line, 2 m deep across the road.
239
+ const checks: BufferGeometry[] = [];
240
+ const squares = 13;
241
+ for (let row = 0; row < 2; row += 1) {
242
+ for (let col = 0; col < squares; col += 1) {
243
+ const lateral = -r + ((col + 0.5) * (2 * r)) / squares;
244
+ const p = { x: 0, y: 0, z: 0 };
245
+ course.pointAt(row, lateral, p);
246
+ const yaw = Math.atan2(-(tx[0] ?? 0), -(tz[0] ?? 0));
247
+ checks.push(
248
+ paint(
249
+ new PlaneGeometry((2 * r) / squares, 1).rotateX(-Math.PI / 2),
250
+ (row + col) % 2 === 0 ? C.check : C.white,
251
+ at(p.x, p.y + 0.02, p.z, 0, yaw),
252
+ ),
253
+ );
254
+ }
255
+ }
256
+ const surfaces = new Mesh(
257
+ merge([road, kerbs, shoulders, deckEdge, ...checks]),
258
+ lit({ roughness: 0.86 }),
259
+ );
260
+ surfaces.name = "road";
261
+ surfaces.receiveShadow = true;
262
+ group.add(surfaces);
263
+
264
+ // ---- Water in the creek -----------------------------------------------------------------
265
+ const waterLength = creekReach[1] - creekReach[0] + 16;
266
+ const water = new Mesh(
267
+ new PlaneGeometry(14, waterLength).rotateX(-Math.PI / 2),
268
+ lit({ color: C.water, roughness: 0.08, vertexColors: false, transparent: true, opacity: 0.82 }),
269
+ );
270
+ const mid = (creekReach[0] + creekReach[1]) / 2;
271
+ water.position.set(
272
+ (cx[creekAt] ?? 0) - (tz[creekAt] ?? 0) * mid,
273
+ creekY + 0.14,
274
+ (cz[creekAt] ?? 0) + (tx[creekAt] ?? 0) * mid,
275
+ );
276
+ water.rotation.y = Math.atan2(-(tx[creekAt] ?? 0), -(tz[creekAt] ?? 0));
277
+ water.name = "creek";
278
+ water.receiveShadow = true;
279
+ group.add(water);
280
+
281
+ // ---- Walls and bridge rails: toy blocks, 2 m each ----------------------------------------------
282
+ const blockColours = [C.blockA, C.blockD, C.blockB, C.blockD, C.blockC, C.blockD];
283
+ const block = new BoxGeometry(1, 1, 1);
284
+ const wallCount = Math.ceil(n / 2) * 2;
285
+ const walls = new InstancedMesh(block, lit({ roughness: 0.55, vertexColors: false }), wallCount);
286
+ const dummy = new Object3D();
287
+ const p = { x: 0, y: 0, z: 0 };
288
+ let w = 0;
289
+ for (let i = 0; i < n; i += 2) {
290
+ for (const side of [-1, 1]) {
291
+ const onDeck = deck[i] === 1;
292
+ const thick = onDeck ? 0.3 : 0.6;
293
+ const tall = onDeck ? 0.75 : 0.95;
294
+ course.pointAt(i + 1, side * ((course.wall[i] ?? 0) + thick / 2), p);
295
+ dummy.position.set(p.x, p.y + tall / 2 - 0.05, p.z);
296
+ dummy.rotation.set(
297
+ Math.atan(course.slope[i] ?? 0),
298
+ Math.atan2(-(tx[i] ?? 0), -(tz[i] ?? 0)),
299
+ 0,
300
+ "YXZ",
301
+ );
302
+ dummy.scale.set(thick, tall, 2.02);
303
+ dummy.updateMatrix();
304
+ walls.setMatrixAt(w, dummy.matrix);
305
+ walls.setColorAt(
306
+ w,
307
+ new Color(
308
+ onDeck ? C.bridgeDark : (blockColours[(i / 2) % blockColours.length] ?? C.blockD),
309
+ ),
310
+ );
311
+ w += 1;
312
+ }
313
+ }
314
+ walls.count = w;
315
+ walls.name = "walls";
316
+ walls.castShadow = true;
317
+ walls.receiveShadow = true;
318
+ group.add(walls);
319
+
320
+ // ---- The bridge: a slab under the deck, pillars to the ground ------------------------------------
321
+ const solids: BufferGeometry[] = [];
322
+ let pillars = 0;
323
+ for (let i = 0; i < n; i += 1) {
324
+ if (deck[i] !== 1) continue;
325
+ const yaw = Math.atan2(-(tx[i] ?? 0), -(tz[i] ?? 0));
326
+ course.pointAt(i, 0, p);
327
+ // Each 1 m slab pitches with the road, as the walls do: a level slab pokes its ends up through
328
+ // a sloped deck and stripes the ramp.
329
+ dummy.position.set(p.x, p.y - 0.51, p.z);
330
+ dummy.rotation.set(Math.atan(course.slope[i] ?? 0), yaw, 0, "YXZ");
331
+ dummy.scale.set(1, 1, 1);
332
+ dummy.updateMatrix();
333
+ solids.push(
334
+ paint(
335
+ new BoxGeometry(2 * PROFILE.rail + 0.6, 0.9, 1.02),
336
+ C.bridge,
337
+ dummy.matrix.clone(),
338
+ 0.3,
339
+ ),
340
+ );
341
+ if (i % 9 !== 0) continue;
342
+ for (const side of [-1, 1]) {
343
+ course.pointAt(i, side * 5.2, p);
344
+ // Keep the pillars off the road that runs underneath (any sample far along the lap).
345
+ if (!clearOfBranch(course, i, p.x, p.z, PROFILE.wall + 2.5)) continue;
346
+ const base = ground(p.x, p.z) - 0.5;
347
+ const height = p.y - 0.9 - base;
348
+ if (height < 0.5) continue;
349
+ solids.push(
350
+ paint(
351
+ new BoxGeometry(1.3, height, 1.3),
352
+ C.pillar,
353
+ at(p.x, base + height / 2, p.z, 0, yaw),
354
+ 0.35,
355
+ ),
356
+ );
357
+ pillars += 1;
358
+ }
359
+ }
360
+
361
+ // ---- The start gantry: two posts, a banner and three lamps ---------------------------------------
362
+ const yaw0 = Math.atan2(-(tx[0] ?? 0), -(tz[0] ?? 0));
363
+ const span = PROFILE.wall + 0.6;
364
+ for (const side of [-1, 1]) {
365
+ course.pointAt(0, side * span, p);
366
+ solids.push(
367
+ paint(new BoxGeometry(0.7, 7.4, 0.7), C.metal, at(p.x, p.y + 3.7, p.z, 0, yaw0), 0.25),
368
+ );
369
+ }
370
+ course.pointAt(0, 0, p);
371
+ solids.push(
372
+ paint(
373
+ new BoxGeometry(2 * span + 0.7, 1.6, 0.5),
374
+ C.banner,
375
+ at(p.x, p.y + 6.6, p.z, 0, yaw0),
376
+ 0.2,
377
+ ),
378
+ );
379
+ for (let c = 0; c < 14; c += 1) {
380
+ const lateral = -span + ((c + 0.5) * 2 * span) / 14;
381
+ course.pointAt(0, lateral, p);
382
+ solids.push(
383
+ paint(
384
+ new BoxGeometry((2 * span) / 14, 0.4, 0.52),
385
+ c % 2 === 0 ? C.check : C.white,
386
+ at(p.x, p.y + 7.6, p.z, 0, yaw0),
387
+ ),
388
+ );
389
+ }
390
+ const bridgeMesh = new Mesh(merge(solids), lit({ roughness: 0.7 }));
391
+ bridgeMesh.name = "structures";
392
+ bridgeMesh.castShadow = true;
393
+ bridgeMesh.receiveShadow = true;
394
+ group.add(bridgeMesh);
395
+ const lamps: MeshStandardMaterial[] = [];
396
+ for (let l = 0; l < 3; l += 1) {
397
+ const material = new MeshStandardMaterial({
398
+ color: 0x331010,
399
+ emissive: 0xff2a1a,
400
+ emissiveIntensity: 0,
401
+ roughness: 0.3,
402
+ });
403
+ const lamp = new Mesh(new IcosahedronGeometry(0.42, 2), material);
404
+ course.pointAt(0, (l - 1) * 1.3, p);
405
+ // On the banner's back face, toward the grid behind the line.
406
+ lamp.position.set(p.x + (tx[0] ?? 0) * -0.4, p.y + 6.6, p.z + (tz[0] ?? 0) * -0.4);
407
+ lamp.name = `lamp.${l}`;
408
+ group.add(lamp);
409
+ lamps.push(material);
410
+ }
411
+
412
+ // ---- Boost pads: three chevrons each, glowing ---------------------------------------------
413
+ // Each flat piece is pitched to the road's slope, or on a hill one end sinks and the other floats.
414
+ const pitch = (i: number): number => Math.atan(course.slope[i] ?? 0);
415
+ const chevrons: BufferGeometry[] = [];
416
+ for (const pad of course.pads) {
417
+ const yaw = Math.atan2(-(tx[pad.index] ?? 0), -(tz[pad.index] ?? 0));
418
+ for (let c = 0; c < 3; c += 1) {
419
+ const i = Math.round(pad.index - 1 + c * 1.2);
420
+ for (const side of [-1, 1]) {
421
+ course.pointAt(i, pad.lateral + side * 0.75, p);
422
+ chevrons.push(
423
+ paint(
424
+ new PlaneGeometry(1.7, 0.55)
425
+ .rotateX(-Math.PI / 2)
426
+ .rotateY(side * 0.6)
427
+ .rotateX(pitch(i)),
428
+ c === 1 ? C.padGlow : C.pad,
429
+ at(p.x, p.y + 0.06, p.z, 0, yaw),
430
+ ),
431
+ );
432
+ }
433
+ }
434
+ course.pointAt(pad.index, pad.lateral, p);
435
+ chevrons.push(
436
+ paint(
437
+ new PlaneGeometry(3, 4.2).rotateX(-Math.PI / 2).rotateX(pitch(pad.index)),
438
+ C.asphaltDark,
439
+ at(p.x, p.y + 0.04, p.z, 0, yaw),
440
+ ),
441
+ );
442
+ }
443
+ const pads = new Mesh(
444
+ merge(chevrons),
445
+ lit({ emissive: C.pad, emissiveIntensity: 0.35, roughness: 0.4 }),
446
+ );
447
+ pads.name = "boost-pads";
448
+ group.add(pads);
449
+
450
+ // ---- Trees and bushes: two instanced meshes ----------------------------------------------
451
+ const trunkGeometry = paint(new CylinderGeometry(0.22, 0.32, 1, 6), C.bark, at(0, 0.5, 0), 0.4);
452
+ const canopyGeometry = paint(new IcosahedronGeometry(1, 1), C.white, undefined, 0.45);
453
+ const crowns: { x: number; y: number; z: number; size: number; trunk: number }[] = [];
454
+ for (let tries = 0; tries < 2600 && crowns.length < 260; tries += 1) {
455
+ const x = midX + (rng() * 2 - 1) * (halfX + 70);
456
+ const z = midZ + (rng() * 2 - 1) * (halfZ + 70);
457
+ if (!clearOfRoad(course, x, z, SHOULDER + 3)) continue;
458
+ const trunk = rng() < 0.25 ? 0 : 1.8 + rng() * 2.2;
459
+ crowns.push({
460
+ size: trunk === 0 ? 0.9 + rng() * 0.8 : 1.8 + rng() * 1.6,
461
+ trunk,
462
+ x,
463
+ y: ground(x, z),
464
+ z,
465
+ });
466
+ }
467
+ const trunks = new InstancedMesh(trunkGeometry, lit({ roughness: 0.9 }), crowns.length);
468
+ const canopies = new InstancedMesh(
469
+ canopyGeometry,
470
+ lit({ roughness: 0.85, flatShading: true }),
471
+ crowns.length,
472
+ );
473
+ const m = new Matrix4();
474
+ const canopyTints = [C.canopy, C.canopyLight, C.grassDark, C.bloomPink, C.bloomYellow];
475
+ crowns.forEach((tree, i) => {
476
+ trunks.setMatrixAt(
477
+ i,
478
+ m.compose(
479
+ dummy.position.set(tree.x, tree.y - 0.2, tree.z),
480
+ dummy.quaternion.identity(),
481
+ dummy.scale.set(1, tree.trunk + 0.2, 1),
482
+ ),
483
+ );
484
+ const lift = tree.trunk === 0 ? tree.size * 0.45 : tree.trunk + tree.size * 0.7;
485
+ dummy.rotation.set(0, rng() * Math.PI, 0);
486
+ canopies.setMatrixAt(
487
+ i,
488
+ m.compose(
489
+ dummy.position.set(tree.x, tree.y + lift, tree.z),
490
+ dummy.quaternion.setFromEuler(dummy.rotation),
491
+ dummy.scale.set(tree.size, tree.size * 0.85, tree.size),
492
+ ),
493
+ );
494
+ // Bushes flower now and then; tree crowns stay green.
495
+ const tint = tree.trunk === 0 && rng() < 0.4 ? canopyTints[3 + (i % 2)] : canopyTints[i % 3];
496
+ canopies.setColorAt(i, new Color(tint));
497
+ });
498
+ for (const mesh of [trunks, canopies]) {
499
+ mesh.castShadow = true;
500
+ mesh.receiveShadow = true;
501
+ group.add(mesh);
502
+ }
503
+ trunks.name = "trunks";
504
+ canopies.name = "canopies";
505
+
506
+ let triangles = 0;
507
+ group.traverse((object) => {
508
+ if (!(object instanceof Mesh)) return;
509
+ const geometry = object.geometry as BufferGeometry;
510
+ const count = geometry.index?.count ?? geometry.getAttribute("position").count;
511
+ triangles += (count / 3) * (object instanceof InstancedMesh ? object.count : 1);
512
+ });
513
+ const reliefMetres = Math.max(...cy) - Math.min(...cy);
514
+ return {
515
+ audit: { pillars, reliefMetres, trees: crowns.length, triangles: Math.round(triangles) },
516
+ ground,
517
+ group,
518
+ lamps,
519
+ };
520
+ }
521
+
522
+ function smooth(edge0: number, edge1: number, x: number): number {
523
+ const t = Math.min(1, Math.max(0, (x - edge0) / (edge1 - edge0)));
524
+ return t * t * (3 - 2 * t);
525
+ }
526
+
527
+ /** True when x/z is at least `clearance` metres from every sample of the line. */
528
+ function clearOfRoad(course: ICourse, x: number, z: number, clearance: number): boolean {
529
+ const reach = clearance * clearance;
530
+ for (let i = 0; i < course.count; i += 1) {
531
+ if ((x - (course.x[i] ?? 0)) ** 2 + (z - (course.z[i] ?? 0)) ** 2 < reach) return false;
532
+ }
533
+ return true;
534
+ }
535
+
536
+ /** True when x/z is at least `clearance` metres from every sample more than 60 m along the lap from `from`. */
537
+ function clearOfBranch(
538
+ course: ICourse,
539
+ from: number,
540
+ x: number,
541
+ z: number,
542
+ clearance: number,
543
+ ): boolean {
544
+ for (let i = 0; i < course.count; i += 1) {
545
+ let apart = Math.abs(i - from);
546
+ apart = Math.min(apart, course.count - apart);
547
+ if (
548
+ apart > 60 &&
549
+ (x - (course.x[i] ?? 0)) ** 2 + (z - (course.z[i] ?? 0)) ** 2 < clearance * clearance
550
+ )
551
+ return false;
552
+ }
553
+ return true;
554
+ }
555
+
556
+ /**
557
+ * How far the creek may run each way from the line, square to it, before it would reach another
558
+ * part of the course: [left, right] in metres of lateral offset, at most 90 each way.
559
+ */
560
+ function channelReach(course: ICourse, at: number): readonly [number, number] {
561
+ const reach = (side: number): number => {
562
+ for (let d = PROFILE.wall + 4; d <= 90; d += 2) {
563
+ const x = (course.x[at] ?? 0) - (course.tz[at] ?? 0) * side * d;
564
+ const z = (course.z[at] ?? 0) + (course.tx[at] ?? 0) * side * d;
565
+ for (let i = 0; i < course.count; i += 1) {
566
+ let apart = Math.abs(i - at);
567
+ apart = Math.min(apart, course.count - apart);
568
+ if (apart < 40) continue;
569
+ if (
570
+ (x - (course.x[i] ?? 0)) ** 2 + (z - (course.z[i] ?? 0)) ** 2 <
571
+ (PROFILE.wall + 14) ** 2
572
+ )
573
+ return d - 14;
574
+ }
575
+ }
576
+ return 90;
577
+ };
578
+ return [-reach(-1), reach(1)];
579
+ }