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,408 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The mill keep on the headland, and the wooden arrow sign at the path's fork, from primitives: the
4
+ // sandstone walls and the wooden shingle roofs take the photo textures in `assets/` (`tex-*.webp`)
5
+ // (surface.ts); a green sprout in relief over the door, a windmill on the corner tower whose sails
6
+ // turn on the GPU, and the teal flag with the hero's leaf painted in code; the arched doorway glows
7
+ // warm. Every part of one material is merged into one geometry, so the whole keep costs eight draws.
8
+ import {
9
+ BoxGeometry,
10
+ BufferAttribute,
11
+ BufferGeometry,
12
+ CircleGeometry,
13
+ ConeGeometry,
14
+ CylinderGeometry,
15
+ DoubleSide,
16
+ ExtrudeGeometry,
17
+ Group,
18
+ Mesh,
19
+ MeshBasicMaterial,
20
+ MeshStandardMaterial,
21
+ PlaneGeometry,
22
+ Shape,
23
+ TorusGeometry,
24
+ } from "three";
25
+ import { cos, positionLocal, sin, time, vec3 } from "three/tsl";
26
+ import { MeshStandardNodeMaterial } from "three/webgpu";
27
+ import { paintedTexture } from "./materials.js";
28
+ import { C } from "./palette.js";
29
+ import { type ISurfaces, masonryMaterial, texturedMaterial } from "./surface.js";
30
+
31
+ const hex = (color: number): [number, number, number] => [
32
+ ((color >> 16) & 255) / 255,
33
+ ((color >> 8) & 255) / 255,
34
+ (color & 255) / 255,
35
+ ];
36
+
37
+ /** The flag: a teal field and a cream leaf, the hero's own badge. */
38
+ function flagMap(): ReturnType<typeof paintedTexture> {
39
+ const teal = hex(C.cap);
40
+ const cream = hex(C.button);
41
+ return paintedTexture(
42
+ 64,
43
+ 40,
44
+ (x, y) => {
45
+ const u = (x - 30) / 16;
46
+ const v = (y - 20) / 16;
47
+ const lu = u * 0.8 + v * 0.6;
48
+ const lv = -u * 0.6 + v * 0.8;
49
+ return Math.abs(lu) < 1 && Math.abs(lv) < 0.42 * (1 - lu * lu) ? cream : teal;
50
+ },
51
+ true,
52
+ );
53
+ }
54
+
55
+ /** UVs from world-aligned planes, `tile` metres per repeat, chosen by each vertex's normal. */
56
+ export function planarUv(geometry: BufferGeometry, tile: number): BufferGeometry {
57
+ const g = geometry.index === null ? geometry : geometry.toNonIndexed();
58
+ const position = g.attributes.position;
59
+ const normal = g.attributes.normal;
60
+ const count = position?.count ?? 0;
61
+ const uv = new Float32Array(count * 2);
62
+ for (let i = 0; i < count; i += 1) {
63
+ const x = position?.getX(i) ?? 0;
64
+ const y = position?.getY(i) ?? 0;
65
+ const z = position?.getZ(i) ?? 0;
66
+ const nx = Math.abs(normal?.getX(i) ?? 0);
67
+ const ny = Math.abs(normal?.getY(i) ?? 0);
68
+ const nz = Math.abs(normal?.getZ(i) ?? 0);
69
+ const [u, v] = ny > nx && ny > nz ? [x, z] : nx > nz ? [z, y] : [x, y];
70
+ uv.set([u / tile, v / tile], i * 2);
71
+ }
72
+ g.setAttribute("uv", new BufferAttribute(uv, 2));
73
+ return g;
74
+ }
75
+
76
+ /** UVs wrapped round a cylinder or cone about its own axis, `tile` metres per repeat. */
77
+ export function wrapUv(geometry: BufferGeometry, radius: number, tile: number): BufferGeometry {
78
+ const uv = geometry.attributes.uv;
79
+ const position = geometry.attributes.position;
80
+ for (let i = 0; i < (uv?.count ?? 0); i += 1) {
81
+ uv?.setXY(
82
+ i,
83
+ ((uv.getX(i) ?? 0) * Math.PI * 2 * radius) / tile,
84
+ (position?.getY(i) ?? 0) / tile,
85
+ );
86
+ }
87
+ return geometry.index === null ? geometry : geometry.toNonIndexed();
88
+ }
89
+
90
+ /** One geometry from many non-indexed parts that share position, normal and uv (and color, if all have it). */
91
+ function merge(parts: readonly BufferGeometry[]): BufferGeometry {
92
+ const merged = new BufferGeometry();
93
+ for (const name of ["position", "normal", "uv", "color"]) {
94
+ if (!parts.every((part) => part.attributes[name] !== undefined)) continue;
95
+ const size = parts[0]?.attributes[name]?.itemSize ?? 3;
96
+ const total = parts.reduce((sum, part) => sum + (part.attributes[name]?.count ?? 0), 0);
97
+ const data = new Float32Array(total * size);
98
+ let offset = 0;
99
+ for (const part of parts) {
100
+ const attribute = part.attributes[name];
101
+ if (attribute === undefined) continue;
102
+ for (let i = 0; i < attribute.count; i += 1) {
103
+ for (let c = 0; c < size; c += 1)
104
+ data[(offset + i) * size + c] = attribute.getComponent(i, c);
105
+ }
106
+ offset += attribute.count;
107
+ }
108
+ merged.setAttribute(name, new BufferAttribute(data, size));
109
+ }
110
+ return merged;
111
+ }
112
+
113
+ /** The windmill tower: x, z, radius, wall top, cap height, sail length from the hub. */
114
+ const MILL = { x: -12.5, z: -2.5, radius: 3.2, top: 13, cap: 3.5, sail: 7 } as const;
115
+
116
+ const box = (x0: number, y0: number, z0: number, x1: number, y1: number, z1: number) =>
117
+ new BoxGeometry(x1 - x0, y1 - y0, z1 - z0).translate((x0 + x1) / 2, (y0 + y1) / 2, (z0 + z1) / 2);
118
+
119
+ /**
120
+ * A gable roof as one prism: ridge along X (or along Z with `alongZ`), eaves at `y0`, ridge at `y1`,
121
+ * over the footprint [x0, x1] x [z0, z1]. Returns the two sloped planes and the two gable ends.
122
+ */
123
+ function gable(
124
+ x0: number,
125
+ x1: number,
126
+ z0: number,
127
+ z1: number,
128
+ y0: number,
129
+ y1: number,
130
+ alongZ = false,
131
+ ): { slopes: BufferGeometry; ends: BufferGeometry } {
132
+ const quad = (a: number[], b: number[], c: number[], d: number[]) => [
133
+ ...a,
134
+ ...b,
135
+ ...c,
136
+ ...a,
137
+ ...c,
138
+ ...d,
139
+ ];
140
+ const s = (p: number[]): number[] => (alongZ ? [p[2] ?? 0, p[1] ?? 0, p[0] ?? 0] : p);
141
+ // Built along X, then swizzled: [x, y, z] -> [z, y, x] when the ridge runs along Z.
142
+ const [a0, a1, b0, b1] = alongZ ? [z0, z1, x0, x1] : [x0, x1, z0, z1];
143
+ const mid = (b0 + b1) / 2;
144
+ const slopes = new BufferGeometry();
145
+ slopes.setAttribute(
146
+ "position",
147
+ new BufferAttribute(
148
+ new Float32Array([
149
+ ...quad(s([a0, y0, b1]), s([a1, y0, b1]), s([a1, y1, mid]), s([a0, y1, mid])),
150
+ ...quad(s([a1, y0, b0]), s([a0, y0, b0]), s([a0, y1, mid]), s([a1, y1, mid])),
151
+ ]),
152
+ 3,
153
+ ),
154
+ );
155
+ const ends = new BufferGeometry();
156
+ ends.setAttribute(
157
+ "position",
158
+ new BufferAttribute(
159
+ new Float32Array([
160
+ ...s([a0, y0, b0]),
161
+ ...s([a0, y0, b1]),
162
+ ...s([a0, y1, mid]),
163
+ ...s([a1, y0, b1]),
164
+ ...s([a1, y0, b0]),
165
+ ...s([a1, y1, mid]),
166
+ ]),
167
+ 3,
168
+ ),
169
+ );
170
+ for (const g of [slopes, ends]) g.computeVertexNormals();
171
+ // Mirrored swizzle flips the winding; flip it back so the faces point out.
172
+ if (alongZ) {
173
+ for (const g of [slopes, ends]) {
174
+ const p = g.attributes.position;
175
+ for (let i = 0; i < (p?.count ?? 0); i += 3) {
176
+ if (p === undefined) continue;
177
+ const [x, y, z] = [p.getX(i + 1), p.getY(i + 1), p.getZ(i + 1)];
178
+ p.setXYZ(i + 1, p.getX(i + 2), p.getY(i + 2), p.getZ(i + 2));
179
+ p.setXYZ(i + 2, x, y, z);
180
+ }
181
+ g.computeVertexNormals();
182
+ }
183
+ }
184
+ return { ends, slopes };
185
+ }
186
+
187
+ /** An arch panel (a rectangle under a half disc), facing +Z, its base centre at the origin. */
188
+ function archPanel(width: number, height: number): BufferGeometry {
189
+ const radius = width / 2;
190
+ // Subdivided: `glow` paints per vertex, and a one-quad panel has vertices only at the jambs.
191
+ const rect = new PlaneGeometry(width, height - radius, 8, 6).translate(
192
+ 0,
193
+ (height - radius) / 2,
194
+ 0,
195
+ );
196
+ const top = new CircleGeometry(radius, 16, 0, Math.PI).translate(0, height - radius, 0);
197
+ return merge([rect.toNonIndexed(), top.toNonIndexed()]);
198
+ }
199
+
200
+ /**
201
+ * Warm light inside a doorway or window: unlit vertex colours, bright at the floor's centre and
202
+ * dark at the jambs, a deep amber just above 1 so the lit room reads warm behind the arch in full
203
+ * sun (a brighter glow tone-maps to a flat cream).
204
+ */
205
+ function glow(geometry: BufferGeometry, width: number): BufferGeometry {
206
+ const position = geometry.attributes.position;
207
+ const colors = new Float32Array((position?.count ?? 0) * 3);
208
+ for (let i = 0; i < (position?.count ?? 0); i += 1) {
209
+ const x = (position?.getX(i) ?? 0) / (width / 2);
210
+ const y = position?.getY(i) ?? 0;
211
+ const k = Math.max(
212
+ 0.12,
213
+ (1 - 0.8 * Math.min(1, Math.abs(x))) * (1 - 0.8 * Math.min(1, y / (width * 1.6))),
214
+ );
215
+ colors.set([1.5 * k, 0.68 * k, 0.22 * k], i * 3);
216
+ }
217
+ geometry.setAttribute("color", new BufferAttribute(colors, 3));
218
+ return geometry;
219
+ }
220
+
221
+ /** A pointed leaf in the XY plane, its stalk at the origin, `length` along +Y, `depth` deep along +Z. */
222
+ function leaf(length: number, depth: number): BufferGeometry {
223
+ const w = length * 0.36;
224
+ const outline = new Shape()
225
+ .moveTo(0, 0)
226
+ .quadraticCurveTo(w, length * 0.45, 0, length)
227
+ .quadraticCurveTo(-w, length * 0.45, 0, 0);
228
+ return new ExtrudeGeometry(outline, { bevelEnabled: false, curveSegments: 8, depth });
229
+ }
230
+
231
+ /**
232
+ * The keep, its origin at the foot of its front door, facing +Z: a hall with a gable roof, a gabled
233
+ * gatehouse with a sprout in relief over the door, a windmill on the corner tower with the flag on
234
+ * its cap, and a small back turret. `stone` is solid; the roofs, sails, relief and flag are not.
235
+ */
236
+ export function buildCastle(s: ISurfaces, footY: number): { group: Group; stone: Mesh } {
237
+ const group = new Group();
238
+ group.name = "castle";
239
+ const stoneParts: BufferGeometry[] = [];
240
+ const roofParts: BufferGeometry[] = [];
241
+ const glowParts: BufferGeometry[] = [];
242
+ const addStone = (g: BufferGeometry) => stoneParts.push(planarUv(g, 4));
243
+
244
+ // Hall, gatehouse and the gatehouse's gable wall, sunk a metre so no seam shows on a slope.
245
+ addStone(box(-11, -1, -12, 11, 9, -2));
246
+ addStone(box(-4.5, -1, -3, 4.5, 13, 0));
247
+ const hallRoof = gable(-11, 11, -12.6, -1.4, 9, 14);
248
+ roofParts.push(planarUv(hallRoof.slopes, 2.5));
249
+ addStone(hallRoof.ends);
250
+ const gateRoof = gable(-5.1, 5.1, -3.2, 0, 13, 17, true);
251
+ roofParts.push(planarUv(gateRoof.slopes, 2.5));
252
+ addStone(gateRoof.ends);
253
+ // A plinth course and a string course: two stone bands that read as weight and as storeys.
254
+ addStone(box(-11.3, -1, -12.3, 11.3, 0.6, -1.7));
255
+ addStone(box(-4.8, 8.6, -3.3, 4.8, 9.1, 0.3));
256
+ // Towers: x, z, radius, wall top, roof height. The first is the windmill: a low cap, sails in front.
257
+ for (const [x, z, radius, top, roof] of [
258
+ [MILL.x, MILL.z, MILL.radius, MILL.top, MILL.cap],
259
+ [11.5, -11.5, 2.4, 13, 6],
260
+ ] as const) {
261
+ stoneParts.push(
262
+ wrapUv(
263
+ new CylinderGeometry(radius, radius * 1.08, top + 1, 20, 1, true).translate(
264
+ 0,
265
+ (top - 1) / 2,
266
+ 0,
267
+ ),
268
+ radius,
269
+ 4,
270
+ ).translate(x, 0, z),
271
+ );
272
+ stoneParts.push(
273
+ wrapUv(
274
+ new CylinderGeometry(radius + 0.35, radius + 0.35, 0.6, 20).translate(0, top - 0.3, 0),
275
+ radius,
276
+ 4,
277
+ ).translate(x, 0, z),
278
+ );
279
+ roofParts.push(
280
+ wrapUv(
281
+ new ConeGeometry(radius + 0.6, roof, 20, 1, true).translate(0, top + roof / 2, 0),
282
+ radius,
283
+ 2.5,
284
+ ).translate(x, 0, z),
285
+ );
286
+ glowParts.push(glow(archPanel(0.9, 1.8), 0.9).translate(x, top - 5, z + radius + 0.06));
287
+ }
288
+ // The arched door with its stone voussoirs, and the windows of the hall.
289
+ glowParts.push(glow(archPanel(3.6, 4.6), 3.6).translate(0, 0, 0.03));
290
+ stoneParts.push(
291
+ planarUv(new TorusGeometry(1.95, 0.32, 6, 16, Math.PI).translate(0, 2.8, 0.05), 4),
292
+ );
293
+ for (const x of [-8.5, -6, 6, 8.5]) {
294
+ glowParts.push(glow(archPanel(1.2, 2.4), 1.2).translate(x, 3, -1.97));
295
+ stoneParts.push(planarUv(box(x - 0.8, 2.75, -1.95, x + 0.8, 3, -1.6), 4));
296
+ }
297
+
298
+ const stone = new Mesh(merge(stoneParts), masonryMaterial(s, footY));
299
+ stone.name = "castle-stone";
300
+ const wood = texturedMaterial(s, "planks", { doubleSided: true });
301
+ const roofs = new Mesh(merge(roofParts), wood);
302
+ const light = new Mesh(merge(glowParts), new MeshBasicMaterial({ vertexColors: true }));
303
+ // The sprout over the door: a stem and two leaves standing proud of the gable wall.
304
+ const sproutParts = [
305
+ new BoxGeometry(0.3, 2.4, 0.22).translate(0, 10.4, 0.11).toNonIndexed(),
306
+ leaf(2.6, 0.24).rotateZ(0.75).translate(0, 11, 0),
307
+ leaf(2.3, 0.24).rotateZ(-0.7).translate(0, 10.6, 0),
308
+ ];
309
+ const sprout = new Mesh(
310
+ merge(sproutParts),
311
+ new MeshStandardMaterial({ color: C.leaf, roughness: 0.6 }),
312
+ );
313
+ // The sails: four lattice arms on a hub before the tower, turned about the hub's axis on the GPU.
314
+ const spin = time.mul(0.45);
315
+ const turned = vec3(
316
+ positionLocal.x.mul(cos(spin)).sub(positionLocal.y.mul(sin(spin))),
317
+ positionLocal.x.mul(sin(spin)).add(positionLocal.y.mul(cos(spin))),
318
+ positionLocal.z,
319
+ );
320
+ const spars: BufferGeometry[] = [
321
+ planarUv(new CylinderGeometry(0.55, 0.55, 1.2, 10).rotateX(Math.PI / 2), 2),
322
+ ];
323
+ const cloth: BufferGeometry[] = [];
324
+ for (let arm = 0; arm < 4; arm += 1) {
325
+ const a = (arm * Math.PI) / 2;
326
+ spars.push(planarUv(box(-0.14, 0.4, 0.4, 0.14, MILL.sail, 0.62), 2).rotateZ(a));
327
+ cloth.push(planarUv(box(0.14, 1.5, 0.5, 1.6, MILL.sail - 0.3, 0.56), 2).rotateZ(a));
328
+ }
329
+ const sparMaterial = new MeshStandardNodeMaterial({ map: wood.map, roughness: 0.85 });
330
+ sparMaterial.colorNode = wood.colorNode;
331
+ sparMaterial.positionNode = turned;
332
+ const clothMaterial = new MeshStandardNodeMaterial({
333
+ color: C.button,
334
+ roughness: 0.9,
335
+ side: DoubleSide,
336
+ });
337
+ clothMaterial.positionNode = turned;
338
+ const hub = [MILL.x, MILL.top + 0.4, MILL.z + MILL.radius + 0.7] as const;
339
+ const sails = new Group();
340
+ sails.name = "mill-sails";
341
+ sails.position.set(...hub);
342
+ sails.add(new Mesh(merge(spars), sparMaterial), new Mesh(merge(cloth), clothMaterial));
343
+ for (const mesh of [stone, roofs, sprout, ...(sails.children as Mesh[])]) {
344
+ mesh.castShadow = true;
345
+ mesh.receiveShadow = true;
346
+ }
347
+ group.add(stone, roofs, light, sprout, sails);
348
+
349
+ // The flag on the windmill's cap, waving from the pole.
350
+ const capTop = MILL.top + MILL.cap;
351
+ const pole = new Mesh(
352
+ new CylinderGeometry(0.07, 0.09, 4, 6).translate(MILL.x, capTop + 1.5, MILL.z),
353
+ wood,
354
+ );
355
+ pole.castShadow = true;
356
+ const flagMaterial = new MeshStandardNodeMaterial({
357
+ map: flagMap(),
358
+ roughness: 0.8,
359
+ side: DoubleSide,
360
+ });
361
+ const along = positionLocal.x.add(1.25).max(0);
362
+ flagMaterial.positionNode = positionLocal.add(
363
+ vec3(
364
+ 0,
365
+ sin(time.mul(3.1).add(along.mul(2.2)))
366
+ .mul(along)
367
+ .mul(0.06),
368
+ sin(time.mul(4).add(along.mul(2.6)))
369
+ .mul(along)
370
+ .mul(0.22),
371
+ ),
372
+ );
373
+ const flag = new Mesh(new PlaneGeometry(2.5, 1.55, 10, 4), flagMaterial);
374
+ flag.position.set(MILL.x + 1.3, capTop + 2.6, MILL.z);
375
+ flag.castShadow = true;
376
+ group.add(pole, flag);
377
+ return { group, stone };
378
+ }
379
+
380
+ /** A wooden arrow sign on a post, its origin at the post's foot, pointing along +X. */
381
+ export function buildSignpost(s: ISurfaces): Group {
382
+ const sign = new Group();
383
+ sign.name = "signpost";
384
+ const wood = texturedMaterial(s, "planks");
385
+ // Planar UVs at 2 m a tile: the board shows a plank and a half with its grain along the arrow.
386
+ const post = new Mesh(planarUv(new BoxGeometry(0.16, 1.5, 0.16).translate(0, 0.75, 0), 2), wood);
387
+ const board = new Mesh(
388
+ planarUv(new BoxGeometry(1.1, 0.34, 0.07).translate(0.45, 1.25, 0.1), 2),
389
+ wood,
390
+ );
391
+ // The arrow's head: a wedge as wide as the board is tall plus a lip, so it reads at 10 m.
392
+ const tip = new Mesh(
393
+ planarUv(
394
+ new CylinderGeometry(0.3, 0.3, 0.07, 3)
395
+ .rotateX(Math.PI / 2)
396
+ .rotateZ(-Math.PI / 2)
397
+ .translate(1.12, 1.25, 0.1),
398
+ 2,
399
+ ),
400
+ wood,
401
+ );
402
+ for (const mesh of [post, board, tip]) {
403
+ mesh.castShadow = true;
404
+ mesh.receiveShadow = true;
405
+ sign.add(mesh);
406
+ }
407
+ return sign;
408
+ }
@@ -0,0 +1,284 @@
1
+ // Generated for you. This is ordinary Three.js TSL — edit or delete it freely.
2
+ //
3
+ // The moveset's feedback: dust under the feet, rings on landings, sparkles on pickups, flashes on
4
+ // impacts, pollen on the breeze. Four pooled emitters cover every effect. `GPUParticles3D` (built in `scenes/Play.ts`) owns the slots, the
5
+ // dispatch, the birth stamps and the culling. Every look choice is this file's: life, drag,
6
+ // gravity, size, colour, blend and sprite mask. A burst passes its shape as the request's
7
+ // `direction`: x is the outward speed, y the upward speed, and z the radius it starts in.
8
+ import {
9
+ Fn,
10
+ If,
11
+ abs,
12
+ cos,
13
+ exp,
14
+ float,
15
+ hash,
16
+ instanceIndex,
17
+ mix,
18
+ sin,
19
+ smoothstep,
20
+ step,
21
+ time,
22
+ uint,
23
+ uv,
24
+ varying,
25
+ vec3,
26
+ vec4,
27
+ } from "three/tsl";
28
+ import {
29
+ AdditiveBlending,
30
+ type ComputeNode,
31
+ type Node,
32
+ NormalBlending,
33
+ SpriteNodeMaterial,
34
+ type StorageBufferNode,
35
+ type UniformNode,
36
+ type Vector3,
37
+ } from "three/webgpu";
38
+
39
+ export interface IEffectBuffers {
40
+ readonly positions: StorageBufferNode<"vec3">;
41
+ readonly velocities: StorageBufferNode<"vec3">;
42
+ readonly births: StorageBufferNode<"float">;
43
+ }
44
+
45
+ export interface IEffectRequest {
46
+ readonly first: UniformNode<"uint", number>;
47
+ readonly count: UniformNode<"uint", number>;
48
+ readonly origin: UniformNode<"vec3", Vector3>;
49
+ readonly direction: UniformNode<"vec3", Vector3>;
50
+ readonly seed: UniformNode<"float", number>;
51
+ }
52
+
53
+ export interface IEffectOptions {
54
+ readonly amount: number;
55
+ readonly lifetime: number;
56
+ readonly material: SpriteNodeMaterial;
57
+ readonly spawn: (buffers: IEffectBuffers, request: IEffectRequest) => ComputeNode;
58
+ readonly process: (
59
+ buffers: IEffectBuffers,
60
+ runtime: { readonly time: Node<"float">; readonly delta: Node<"float"> },
61
+ ) => ComputeNode;
62
+ }
63
+
64
+ interface IRecipe {
65
+ readonly amount: number;
66
+ /** Seconds a particle lives. */
67
+ readonly life: number;
68
+ /** Fraction of speed lost per second, as an exponential rate. */
69
+ readonly drag: number;
70
+ /** Metres per second squared on y: negative falls, positive rises like warm dust. */
71
+ readonly gravity: number;
72
+ /** Sprite size in metres at birth and at death. */
73
+ readonly size: readonly [number, number];
74
+ /** Linear colour at birth and at death. */
75
+ readonly colour: readonly [readonly [number, number, number], readonly [number, number, number]];
76
+ readonly opacity: number;
77
+ readonly additive: boolean;
78
+ readonly mask: "puff" | "star";
79
+ }
80
+
81
+ const TAU = Math.PI * 2;
82
+
83
+ /** A soft round puff, or a four-point star with a soft core: no texture, no download. */
84
+ function sprite(mask: IRecipe["mask"]) {
85
+ const point = uv().sub(0.5);
86
+ const round = float(1).sub(smoothstep(0.05, 0.5, point.length()));
87
+ if (mask === "puff") return round.mul(round);
88
+ const ray = float(1)
89
+ .sub(smoothstep(0.02, 0.07, abs(point.x)))
90
+ .max(float(1).sub(smoothstep(0.02, 0.07, abs(point.y))))
91
+ .mul(float(1).sub(smoothstep(0.1, 0.5, point.length())));
92
+ return round.mul(round).max(ray);
93
+ }
94
+
95
+ function emitter(recipe: IRecipe): IEffectOptions {
96
+ const material = new SpriteNodeMaterial({
97
+ blending: recipe.additive ? AdditiveBlending : NormalBlending,
98
+ depthWrite: false,
99
+ transparent: true,
100
+ });
101
+ // The quad's empty corners write nothing to the depth and normal buffers, so AO skips them.
102
+ material.alphaTest = 0.02;
103
+ const [birth, death] = recipe.colour;
104
+ // The material reads the birth stamp the engine writes, so it binds once the buffer exists.
105
+ const bind = (born: Node<"float">): void => {
106
+ const age = time.sub(born);
107
+ const alive = varying(step(0, age).mul(step(age, recipe.life)));
108
+ const phase = varying(age.div(recipe.life).clamp(0, 1));
109
+ const jitter = hash(instanceIndex.add(7)).mul(0.6).add(0.7);
110
+ material.scaleNode = mix(float(recipe.size[0]), float(recipe.size[1]), phase)
111
+ .mul(jitter)
112
+ .mul(alive);
113
+ material.colorNode = vec4(
114
+ mix(vec3(...birth), vec3(...death), phase),
115
+ sprite(recipe.mask)
116
+ .mul(float(1).sub(smoothstep(0.55, 1, phase)))
117
+ .mul(recipe.opacity)
118
+ .mul(alive),
119
+ );
120
+ };
121
+ const spawn = (
122
+ { positions, velocities, births }: IEffectBuffers,
123
+ request: IEffectRequest,
124
+ ): ComputeNode => {
125
+ bind(births.toAttribute());
126
+ return Fn(() => {
127
+ If(instanceIndex.lessThan(request.count), () => {
128
+ const slot = request.first.add(instanceIndex).mod(uint(recipe.amount));
129
+ const key = instanceIndex.add(request.seed.mul(977).toUint());
130
+ const r = (salt: number) => hash(key.add(salt));
131
+ const angle = r(1).mul(TAU);
132
+ const radius = r(2).sqrt().mul(request.direction.z);
133
+ const out = request.direction.x.mul(r(3).mul(0.6).add(0.5));
134
+ positions
135
+ .element(slot)
136
+ .assign(
137
+ request.origin.add(
138
+ vec3(cos(angle).mul(radius), r(4).mul(0.12), sin(angle).mul(radius)),
139
+ ),
140
+ );
141
+ velocities
142
+ .element(slot)
143
+ .assign(
144
+ vec3(
145
+ cos(angle).mul(out),
146
+ request.direction.y.mul(r(5).mul(0.8).add(0.6)),
147
+ sin(angle).mul(out),
148
+ ),
149
+ );
150
+ });
151
+ })().compute(recipe.amount);
152
+ };
153
+ const process = (
154
+ { positions, velocities, births }: IEffectBuffers,
155
+ runtime: { readonly time: Node<"float">; readonly delta: Node<"float"> },
156
+ ): ComputeNode =>
157
+ Fn(() => {
158
+ const age = runtime.time.sub(births.element(instanceIndex));
159
+ If(age.greaterThanEqual(0).and(age.lessThan(recipe.life)), () => {
160
+ const velocity = velocities
161
+ .element(instanceIndex)
162
+ .mul(exp(float(-recipe.drag).mul(runtime.delta)))
163
+ .add(vec3(0, recipe.gravity, 0).mul(runtime.delta));
164
+ velocities.element(instanceIndex).assign(velocity);
165
+ positions.element(instanceIndex).addAssign(velocity.mul(runtime.delta));
166
+ });
167
+ })().compute(recipe.amount);
168
+ return { amount: recipe.amount, lifetime: recipe.life, material, process, spawn };
169
+ }
170
+
171
+ /** Warm cream dust that billows, slows and drifts up: run puffs, landings, skids, poofs. */
172
+ export function dustEffect(): IEffectOptions {
173
+ return emitter({
174
+ additive: false,
175
+ amount: 768,
176
+ colour: [
177
+ [0.72, 0.64, 0.5],
178
+ [0.92, 0.9, 0.85],
179
+ ],
180
+ drag: 4,
181
+ gravity: 0.8,
182
+ life: 0.9,
183
+ mask: "puff",
184
+ // Light enough that the shoes read through a run's trail of puffs.
185
+ opacity: 0.55,
186
+ size: [0.41, 1.12],
187
+ });
188
+ }
189
+
190
+ /** Hot white-to-amber flashes that burst wide and die fast: wall-kick sparks, the ground-pound ring. */
191
+ export function flashEffect(): IEffectOptions {
192
+ return emitter({
193
+ additive: true,
194
+ amount: 256,
195
+ // Warm, not white: overlapping additive stars brighter than this read as one glowing slab.
196
+ colour: [
197
+ [1.2, 0.9, 0.45],
198
+ [0.8, 0.28, 0.04],
199
+ ],
200
+ drag: 3.5,
201
+ gravity: -2,
202
+ // 0.9 s, as long as a dust puff, so a kick's sparks still trail the hero off the wall.
203
+ life: 0.9,
204
+ mask: "star",
205
+ opacity: 1,
206
+ // Small and fast: the motion blur draws each one out into a streak.
207
+ size: [0.35, 0.1],
208
+ });
209
+ }
210
+
211
+ /** Gold-white stars that pop out and fall: pickups, wall-kick sparks, jump trails, gem glints. */
212
+ export function sparkleEffect(): IEffectOptions {
213
+ return emitter({
214
+ additive: true,
215
+ amount: 512,
216
+ colour: [
217
+ [1.6, 1.45, 1.0],
218
+ [1.2, 0.55, 0.08],
219
+ ],
220
+ drag: 2.2,
221
+ gravity: -5,
222
+ life: 0.9,
223
+ mask: "star",
224
+ opacity: 0.9,
225
+ size: [0.32, 0.08],
226
+ });
227
+ }
228
+
229
+ /** Petals and pollen that drift round the hero on the breeze, pale pink to cream. */
230
+ export function pollenEffect(): IEffectOptions {
231
+ return emitter({
232
+ additive: false,
233
+ amount: 256,
234
+ colour: [
235
+ [1, 0.72, 0.82],
236
+ [1, 0.95, 0.75],
237
+ ],
238
+ drag: 0.4,
239
+ gravity: -0.06,
240
+ life: 5,
241
+ mask: "puff",
242
+ opacity: 0.85,
243
+ size: [0.11, 0.08],
244
+ });
245
+ }
246
+
247
+ /** The four emitters `scenes/Play.ts` builds, by the name a burst picks one with. */
248
+ export const EFFECTS = {
249
+ dust: dustEffect,
250
+ flash: flashEffect,
251
+ pollen: pollenEffect,
252
+ sparkle: sparkleEffect,
253
+ } as const;
254
+
255
+ /**
256
+ * Every burst the game fires, by name: its emitter, how many particles and the request's
257
+ * `direction` (outward speed, upward speed, start radius). Tune the feel here, not in `scenes/Play.ts`.
258
+ */
259
+ export const BURSTS = {
260
+ run: { emitter: "dust", count: 4, shape: [0.9, 1.1, 0.3] },
261
+ skid: { emitter: "dust", count: 16, shape: [2.6, 1, 0.35] },
262
+ takeoff: { emitter: "dust", count: 12, shape: [2, 0.8, 0.3] },
263
+ landing: { emitter: "dust", count: 24, shape: [3.6, 0.4, 0.4] },
264
+ pound: { emitter: "dust", count: 39, shape: [8, 0.6, 0.5] },
265
+ // A thin ring of sparks that skims out along the ground: almost no upward speed.
266
+ poundRing: { emitter: "flash", count: 48, shape: [9, 0.15, 0.6] },
267
+ debris: { emitter: "dust", count: 14, shape: [2.5, 6, 0.6] },
268
+ ledge: { emitter: "dust", count: 6, shape: [0.8, 0.4, 0.3] },
269
+ poof: { emitter: "dust", count: 24, shape: [2.6, 1.6, 0.4] },
270
+ // A kick: 18 amber streaks off the wall plus 8 gold-white stars, slower than a pound's ring so
271
+ // they stay round the hero; 10 streaks at 7 m/s were gone before the eye found them.
272
+ wallKick: { emitter: "flash", count: 18, shape: [5, 2.5, 0.12] },
273
+ kickStars: { emitter: "sparkle", count: 8, shape: [3, 2, 0.1] },
274
+ trail: { emitter: "sparkle", count: 2, shape: [0.4, 0.3, 0.25] },
275
+ streak: { emitter: "sparkle", count: 3, shape: [0.2, 0.1, 0.15] },
276
+ coin: { emitter: "sparkle", count: 14, shape: [2.4, 3.5, 0.2] },
277
+ gem: { emitter: "sparkle", count: 22, shape: [3, 4, 0.3] },
278
+ seed: { emitter: "sparkle", count: 60, shape: [4.5, 6, 0.4] },
279
+ glint: { emitter: "sparkle", count: 1, shape: [0.3, 0.8, 0.35] },
280
+ pollen: { emitter: "pollen", count: 3, shape: [0.5, 0.35, 14] },
281
+ } as const satisfies Record<
282
+ string,
283
+ { emitter: keyof typeof EFFECTS; count: number; shape: readonly [number, number, number] }
284
+ >;